Homebrew- oder npm-Downloads scheitern auf dem Mac

Symptome

• brew install bricht mit „curl: (28) … timed out“ oder „Failed to download resource“ ab.
• npm install bricht mit ETIMEDOUT, ECONNRESET oder einem Zertifikatsfehler ab.
• Downloads scheitern nur in einem Firmennetzwerk oder über VPN.
• Downloads starten und brechen dann bei einer langsamen Verbindung ab.

Mögliche Ursachen

• Ein Proxy, den das Tool nicht kennt. Homebrew verwendet http_proxy, https_proxy und all_proxy. npm verwendet seine Einstellungen proxy und https-proxy oder dieselben Variablen.
• TLS-Inspektion. Ein Firmen-Proxy signiert den Datenverkehr mit einem eigenen Zertifikat. Siehe Zertifikate eines Firmen-Proxys stören Terminal-Tools auf dem Mac.
• Eine falsche npm-Registry. Eine alte Einstellung registry kann auf einen Server zeigen, den du nicht erreichst.
• Eine langsame oder begrenzte Verbindung. Große Downloads können bei schwachem WLAN oder über einen Hotspot ins Timeout laufen.

So prüfst du es

1. Lass Homebrew dein System prüfen.

   brew doctor

2. Zeige die Homebrew- und Systemkonfiguration an.

   brew config

3. Zeige die Registry- und Proxy-Einstellungen von npm an.

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

4. Sende eine Anfrage an die npm-Registry.

   npm ping

5. Teste den Download-Host direkt mit curl.

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

So behebst du es

1. Für Homebrew hinter einem Proxy: Setze die Proxy-Variable in derselben Shell.

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

2. Für npm hinter einem Proxy: Setze den npm-Proxy.

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

3. Entferne eine alte Registry-Einstellung, damit npm seinen Standard nutzt.

   npm config delete registry

4. Lass Homebrew einen fehlgeschlagenen Download öfter versuchen.

   export HOMEBREW_CURL_RETRIES=5

5. Wenn deine Firma einen Mirror nutzt, richte ihn ein. Homebrew verwendet für Mirrors HOMEBREW_BOTTLE_DOMAIN und HOMEBREW_API_DOMAIN.

6. Bei Zertifikatsfehlern füge das Root-Zertifikat der Firma hinzu. Siehe Zertifikate eines Firmen-Proxys stören Terminal-Tools auf dem Mac.

Mit Kilobat

Fragen

Quellen

• Homebrew Docs: Manpage, Umgebungsvariablen
• npm Docs: config
• curl(1), Manpage aus macOS 27.2

Quellen geprüft am 29. Oktober 2026. Die Manpages sind die mit macOS installierten; öffne eine mit man <name> im Terminal.

Verwandte Anleitungen