“npm error code ECONNREFUSED” auf dem Mac
ECONNREFUSED meldet eine abgelehnte Verbindung. Die Node.js-Dokumentation sagt: “No connection could be made because the target machine actively refused it.”
Mein Mac hat dieses Problem: „npm error code ECONNREFUSED“ auf dem Mac. Lies https://kilobat.app/de/guides/npm-econnrefused.md und geh es mit mir durch. Installiere die Kilobat-CLI, falls sie fehlt: brew install seifip/kilobat/kilobat. Führe die Terminal- und kilobat-Checks aus der Anleitung selbst aus und sag mir, was du findest. Liste die Schritte auf, die nur ich erledigen kann. Frag nach, bevor du eine Einstellung änderst.
Symptome
npm installoder ein Skript bricht mitnpm error code ECONNREFUSEDab.- Die nächste Zeile nennt eine Adresse und einen Port, etwa
127.0.0.1:8080. - Es folgt oft auf eine Proxy- oder Registry-Einstellung.
Mögliche Ursachen
- Eine Proxy-Einstellung, die ins Leere zeigt. Ein Proxy auf
127.0.0.1oder einem anderen Host ist gesetzt, aber dort läuft kein Proxy. - Eine lokale Registry, die aus ist. Ein lokaler Mirror oder Cache ist ausgefallen.
- Ein inaktiver Dienst. Die Node.js-Dokumentation sagt, dass das meist von einem Dienst kommt, der auf dem entfernten Host inaktiv ist.
- Ein Skript, das einen lokalen Server aufruft. Ein Test- oder Build-Schritt kann einen Server aufrufen, der nicht gestartet ist.
So prüfst du es
Lies Adresse und Port im Fehler.
Zeige Proxy und Registry von npm an.
npm config get proxy npm config get https-proxy npm config get registryTeste diesen Port.
nc -vz 127.0.0.1 8080Zeige die Proxy-Variablen an.
env | grep -i proxy
So behebst du es
Lösche eine Proxy-Einstellung, die du nicht brauchst.
npm config delete proxy npm config delete https-proxyStarte die lokale Registry oder den Server, den die Adresse nennt.
Entferne falsche Proxy-Variablen.
unset https_proxy http_proxyWiederhole die Installation.
Fragen
Ist ECONNREFUSED dasselbe wie ECONNRESET?
Nein. ECONNREFUSED ist eine Ablehnung gleich am Anfang. ECONNRESET schließt eine offene Verbindung. Siehe “npm error code ECONNRESET” auf dem Mac.
Warum nennt es 127.0.0.1?
npm hat eine lokale Adresse versucht, meist wegen einer Proxy- oder Registry-Einstellung.
Quellen
Geprüft am 29. Oktober 2026.