Les téléchargements Homebrew ou npm échouent sur un Mac

Symptômes

• brew install s’arrête avec « curl: (28) … timed out » ou « Failed to download resource ».
• npm install s’arrête avec ETIMEDOUT, ECONNRESET ou une erreur de certificat.
• Les téléchargements échouent seulement sur un réseau d’entreprise ou un VPN.
• Les téléchargements démarrent puis s’arrêtent sur une connexion lente.

Causes probables

• Un proxy que l’outil ne connaît pas. Homebrew utilise http_proxy, https_proxy et all_proxy. npm utilise ses réglages proxy et https-proxy, ou les mêmes variables.
• L’inspection TLS. Un proxy d’entreprise signe le trafic avec son propre certificat. Voir Les certificats d’un proxy d’entreprise cassent les outils de Terminal sur Mac.
• Un mauvais registre npm. Un ancien réglage registry peut pointer vers un serveur que vous ne pouvez pas joindre.
• Une connexion lente ou limitée. Les gros téléchargements peuvent expirer sur un Wi-Fi faible ou un partage de connexion.

Comment vérifier

1. Laissez Homebrew vérifier votre système.

   brew doctor

2. Affichez la configuration de Homebrew et du système.

   brew config

3. Affichez les réglages de registre et de proxy de npm.

   npm config get registry
   npm config get proxy
   npm config get https-proxy

4. Demandez une réponse au registre npm.

   npm ping

5. Testez directement l’hôte de téléchargement avec curl.

   curl -v -o /dev/null https://formulae.brew.sh/api/formula.json

Comment corriger

1. Pour Homebrew derrière un proxy, définissez la variable de proxy dans le même shell.

   export https_proxy=http://proxy.example.com:8080

2. Pour npm derrière un proxy, configurez le proxy de npm.

   npm config set https-proxy http://proxy.example.com:8080

3. Supprimez un ancien réglage de registre npm pour que npm utilise sa valeur par défaut.

   npm config delete registry

4. Laissez Homebrew réessayer davantage un téléchargement qui a échoué.

   export HOMEBREW_CURL_RETRIES=5

5. Si votre entreprise utilise un miroir, configurez-le. Homebrew utilise HOMEBREW_BOTTLE_DOMAIN et HOMEBREW_API_DOMAIN pour les miroirs.

6. Pour les erreurs de certificat, ajoutez le certificat racine de l’entreprise. Voir Les certificats d’un proxy d’entreprise cassent les outils de Terminal sur Mac.

Avec Kilobat

Questions

Sources

• Documentation Homebrew : page man, variables d’environnement
• Documentation npm : config
• curl(1), page man installée avec macOS 27.2

Sources vérifiées le 29 octobre 2026. Les pages man sont celles installées avec macOS ; ouvrez-en une avec man <name> dans Terminal.

Guides associés