“UNABLE_TO_GET_ISSUER_CERT_LOCALLY” auf dem Mac
UNABLE_TO_GET_ISSUER_CERT_LOCALLY bedeutet, dass Node.js die Stelle nicht findet, die ein Zertifikat signiert hat. Meist ist ein TLS-prüfender Proxy oder eine private Zertifizierungsstelle die Ursache.
Mein Mac hat dieses Problem: „UNABLE_TO_GET_ISSUER_CERT_LOCALLY“ auf dem Mac. Lies https://kilobat.app/de/guides/npm-unable-to-get-issuer-cert-locally.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
- Ein Node.js-Tool bricht mit
UNABLE_TO_GET_ISSUER_CERT_LOCALLYab. - Die Meldung kann
unable to get local issuer certificatelauten. - Browser öffnen dieselbe Website möglicherweise.
Mögliche Ursachen
- Ein TLS-prüfender Proxy. Ein Firmenproxy signiert den Datenverkehr mit einem eigenen Zertifikat. Siehe Zertifikate von Firmenproxys stören Terminal-Tools auf dem Mac.
- Eine private Zertifizierungsstelle. Eine Firmen-Registry oder ein Gateway nutzt ein Zertifikat einer Stelle, die Node.js nicht kennt.
- Eine Sicherheits-App, die HTTPS scannt. Sie fügt ihr eigenes Root-Zertifikat hinzu, das Node.js standardmäßig nicht verwendet.
- Ein fehlendes Zwischenzertifikat. Ein Server kann einen Teil seiner Zertifikatskette auslassen.
So prüfst du es
Lies den Aussteller aus.
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuerZeige die CA-Datei an, die npm verwendet.
npm config get cafileZeige die CA-Variable von Node.js an.
echo $NODE_EXTRA_CA_CERTSProbiere einen iPhone-Hotspot.
So behebst du es
Hole das CA-Zertifikat im PEM-Format vom Netzwerkadministrator.
Sage Node.js, dass es ihm in dieser Shell vertrauen soll.
export NODE_EXTRA_CA_CERTS=/path/to/ca.pemSetze für npm dieselbe Datei.
npm config set cafile /path/to/ca.pemSetze
NODE_TLS_REJECT_UNAUTHORIZED=0nicht. Es schaltet alle Prüfungen ab.
Mit Kilobat
Der Verbindungsdoktor von Kilobat testet den Host Schicht für Schicht. Die TLS-Schicht zeigt ein Zertifikat, dem dieser Mac nicht vertraut.
kilobat why https://registry.npmjs.org/Diese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit
diagnose_connectionunddiagnose_networkaus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.
Fragen
Warum funktioniert der Browser?
macOS vertraut Zertifikaten, die ein Administrator installiert. Node.js nutzt eine eigene Liste, solange du keine Datei hinzufügst.
Ist NODE_TLS_REJECT_UNAUTHORIZED=0 eine Lösung?
Nein. Es schaltet die Zertifikatsprüfung für jede Verbindung ab. Füge stattdessen die CA hinzu.
Quellen
Geprüft am 29. Oktober 2026.