Proxy für npm, yarn und pnpm einrichten

Proxys für npm, yarn und pnpm konfigurieren

Einführung

Node.js-Paketmanager (npm, yarn, pnpm) laden Pakete aus der npm-Registrierung herunter. In einem Unternehmensnetzwerk oder bei der Verwendung eines Proxys zur Anonymität ist es notwendig, einen Proxy für diese Paketmanager zu konfigurieren, damit sie korrekt funktionieren.

Grundlegende Konfiguration

npm

npm config set proxy http://proxy_ip:port
npm config set https-proxy http://proxy_ip:port

Mit Authentifizierung:

npm config set proxy http://user:pass@proxy_ip:port

Überprüfung:

npm config get proxy

Entfernung:

npm config delete proxy
npm config delete https-proxy

yarn

yarn config set proxy http://proxy_ip:port
yarn config set https-proxy http://proxy_ip:port

pnpm

pnpm config set proxy http://proxy_ip:port
pnpm config set https-proxy http://proxy_ip:port

Alternativ über Umgebungsvariablen: HTTP_PROXY, HTTPS_PROXY – dies funktioniert für alle drei Manager.

Erweiterte Konfiguration

Umgebungsvariablen

Die meisten Tools unterstützen Standard-Umgebungsvariablen für Proxys:
- HTTP_PROXY / http_proxy — Proxy für HTTP-Anfragen
- HTTPS_PROXY / https_proxy — Proxy für HTTPS-Anfragen
- NO_PROXY / no_proxy — Liste der Ausschlüsse (Adressen, die den Proxy umgehen)
- ALL_PROXY / all_proxy — Proxy für alle Protokolle

SSL und selbstsignierte Zertifikate

Unternehmensproxys verwenden oft eigene SSL-Zertifikate. Um über diese zu arbeiten, müssen Sie:
1. Das CA-Zertifikat des Proxys vom Administrator erhalten
2. Es zum Zertifikatsspeicher Ihres Systems hinzufügen
3. Oder die SSL-Verifizierung deaktivieren (nur zu Testzwecken)

Authentifizierung

Zwei Hauptauthentifizierungsmethoden werden unterstützt:

Benutzername und Passwort — Standard-HTTP-Basic-Authentifizierung. Anmeldeinformationen werden mit jeder Anfrage gesendet. URL-Format: http://user:pass@proxy_ip:port

Per IP-Adresse (Whitelist) — Ihre IP wird zu einer Whitelist hinzugefügt. Es müssen keine Anmeldeinformationen gesendet werden.

Überprüfung der Einrichtung

Nach der Konfiguration überprüfen Sie:
1. Eine Testanfrage über den Proxy durchführen
2. Sicherstellen, dass sich Ihre IP-Adresse geändert hat
3. Die Verbindungsgeschwindigkeit überprüfen
4. Bestätigen, dass keine DNS-Lecks vorhanden sind

Fehlerbehebung

Proxy kann keine Verbindung herstellen

• Adresse und Port auf Korrektheit prüfen
• Sicherstellen, dass Ihre Firewall die Verbindung nicht blockiert
• Die Erreichbarkeit des Proxys von Ihrem Netzwerk aus überprüfen

SSL-Fehler

• Für Unternehmensproxys das CA-Zertifikat hinzufügen
• Für Tests die SSL-Verifizierung temporär deaktivieren
• SSL-Bibliotheken auf die neueste Version aktualisieren

Authentifizierungsfehler

• Benutzername und Passwort überprüfen
• Sicherstellen, dass das Format der Anmeldeinformationen korrekt ist
• Versuchen Sie, Sonderzeichen im Passwort URL-zu-kodieren

Best Practices

1. Umgebungsvariablen verwenden — für Flexibilität und Sicherheit
2. Vermeiden Sie das Hardcoding von Anmeldeinformationen — verwenden Sie Umgebungsvariablen oder Konfigurationsdateien
3. Ausschlüsse konfigurieren — localhost und interne Adressen nicht über den Proxy leiten
4. Einstellungen dokumentieren — in der README Ihres Projekts oder im Team-Wiki
5. Nach Änderungen testen — jede Konfigurationsänderung erfordert eine Überprüfung

Fazit

Eine korrekte Proxy-Konfiguration gewährleistet einen stabilen Werkzeugbetrieb und sichere Verbindungen. Befolgen Sie die Empfehlungen in diesem Leitfaden und überprüfen Sie die Funktionalität immer nach der Einrichtung.