Proxy für npm, pip, apt, Docker und git einrichten: Schritt-für-Schritt-Anleitung für die Konfiguration jedes Tools
Inhalt des Artikels
- Einleitung: warum paketmanager eigene proxy-einstellungen brauchen
- Vorbereitung
- Grundbegriffe: warum umgebungsvariablen nicht ausreichen
- Schritt 1: proxy prüfen und referenzzeichenkette vorbereiten
- Schritt 2: npm über die datei .npmrc einrichten
- Schritt 3: pip über pip.conf einrichten
- Schritt 4: apt über das verzeichnis apt.conf.d einrichten
- Schritt 5: docker auf zwei ebenen einrichten
- Schritt 6: git über git config einrichten
- Ergebnis überprüfen: gesamt-checkliste
- Typische fehler und lösungen
- Zusätzliche möglichkeiten
- Faq: häufige fragen zur konfiguration
- Fazit
Einleitung: Warum Paketmanager eigene Proxy-Einstellungen brauchen
Sie kennen die Situation sicher: Im Terminal sind die Variablen http_proxy und https_proxy exportiert, curl lädt Seiten problemlos herunter, aber npm install hängt eine Minute und bricht mit ETIMEDOUT ab. Oder apt update versucht still und leise, das Mirror direkt zu erreichen, als gäbe es keinen Proxy. Oder Docker kann beim Erstellen eines Images die Basisschicht nicht ziehen, obwohl docker pull aus derselben Konsole funktioniert. Das ist kein Bug und keine Mystik. Jedes Tool liest Netzwerkeinstellungen auf seine eigene Weise, und Umgebungsvariablen decken das nur teilweise ab.
Dieser Leitfaden widmet sich genau den eigenen Konfigurationsdateien von fünf Tools, die kein Entwickler missen möchte: npm (Datei .npmrc), pip (pip.conf oder pip.ini), apt (Verzeichnis apt.conf.d), Docker (daemon.json und config.json) und git (git config). Wir wiederholen bewusst nicht das Thema Umgebungsvariablen im Terminal und in CI. Hier geht es um etwas anderes: zu zeigen, wie man den Proxy so einträgt, dass er immer angewendet wird – egal, wer den Befehl von wo aus startet.
Am Ende haben Sie fünf funktionierende Konfigurationen, die Sie auf jede Maschine kopieren können, ein Verständnis dafür, wo jedes Tool nach Einstellungen sucht, und eine Reihe von Befehlen zum Überprüfen. Außerdem wissen Sie, wie Sie alles schnell wieder rückgängig machen.
Für wen dieser Leitfaden ist
- Entwickler, deren Arbeitslaptop oder Server hinter einem Firmen- oder Heim-Proxy steht.
- Tester und Automatisierungsspezialisten, die möchten, dass Builds über eine dedizierte Proxy-Adresse laufen.
- Administratoren, die Standard-Images für Arbeitsstationen einrichten.
- Alle, die einen gemieteten Proxy (auch mobil) für die Entwicklung nutzen und möchten, dass nur ein bestimmtes Tool darüber läuft, nicht das ganze System.
Was Sie vorher wissen sollten
Grundlegende Terminal-Kenntnisse reichen aus: Konsole öffnen, in ein Verzeichnis wechseln, eine Textdatei bearbeiten. Wir verwenden nano unter Linux und Notepad unter Windows, aber jeder andere Editor ist ebenfalls geeignet. Ein Verständnis davon, was eine IP-Adresse und ein Port sind, ist ebenfalls hilfreich, auch wenn wir die Grundlagen im Abschnitt über Begriffe wiederholen.
Wie viel Zeit Sie benötigen
Wenn Sie alle fünf Tools nacheinander einrichten, planen Sie 60 bis 90 Minuten ein. Jedes einzelne Tool dauert 10–15 Minuten inklusive Überprüfung. Der längste Schritt ist Docker, weil dort zwei Ebenen von Einstellungen und ein Neustart des Dienstes erforderlich sind.
Vorbereitung
Bevor wir die Konfigurationen bearbeiten, sammeln wir alles Nötige. Diesen Schritt zu überspringen ist die Hauptursache dafür, dass man später stundenlang rätselt, wo der Fehler liegt.
Benötigte Proxy-Daten
Sie brauchen vier Parameter. Schreiben Sie sie in eine Textdatei, damit Sie nicht in Chats suchen müssen:
- Proxy-Typ: HTTP oder HTTPS (manchmal SOCKS5, aber die meisten Paketmanager erwarten einen HTTP-Proxy).
- Adresse: Domainname oder IP, z. B. proxy.corp.local oder 10.20.30.40.
- Port: meist 3128, 8080 oder 8888.
- Benutzername und Passwort, falls der Proxy Authentifizierung verlangt. Achten Sie auf Sonderzeichen im Passwort: Sie müssen kodiert werden, dazu später mehr.
Systemanforderungen und Versionen
Die Anleitung wurde mit aktuellen Versionen von 2026 getestet und eignet sich für:
- Ubuntu 22.04 und 24.04, Debian 12 und 13 (für apt).
- Node.js 20 und 22 mit npm 10 und 11.
- Python 3.10 und neuer mit pip 24 und neuer.
- Docker Engine 25 und neuer (der Schlüssel proxies in daemon.json erschien in Version 23; bei älteren Versionen verwenden Sie systemd drop-in, wir zeigen beide Varianten).
- Git 2.40 und neuer.
Wenn Sie Windows verwenden, funktionieren alle Befehle für npm, pip und git in PowerShell unverändert; nur die Dateipfade unterscheiden sich. Für Docker Desktop werden die Proxy-Einstellungen über die grafische Oberfläche vorgenommen, auch das schauen wir uns an.
Zugriffsrechte
Für npm, pip und git genügen die Rechte eines normalen Benutzers: Ihre Konfigurationen liegen im Home-Verzeichnis. Für apt und Docker benötigen Sie sudo, weil die Dateien in /etc liegen und das Verhalten von Systemdiensten ändern.
Backups
Kopieren Sie vor dem Start die vorhandenen Konfigurationen. Ein Befehl pro Datei, und Sie können jederzeit zum Ausgangszustand zurückkehren:
cp ~/.npmrc ~/.npmrc.bak 2>/dev/null; cp ~/.config/pip/pip.conf ~/pip.conf.bak 2>/dev/null; cp ~/.gitconfig ~/.gitconfig.bak 2>/dev/null; sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.bak 2>/dev/null; sudo cp -r /etc/apt/apt.conf.d /etc/apt/apt.conf.d.bak 2>/dev/nullDas 2>/dev/null am Ende sorgt dafür, dass der Befehl nicht meckert, wenn die Datei noch nicht existiert. Das ist normal: Bei vielen Benutzern fehlen .npmrc und pip.conf anfangs.
Tipp: Legen Sie im Home-Verzeichnis einen Ordner proxy-configs an und bewahren Sie dort Referenzversionen aller fünf Konfigurationen auf. Ein Umzug auf eine neue Maschine wird dann zum Kopieren von fünf Dateien.
Grundbegriffe: Warum Umgebungsvariablen nicht ausreichen
Schauen wir uns an, was unter der Haube passiert, sonst wirken die folgenden Schritte wie eine Sammlung magischer Zaubersprüche.
Was ein Proxy im Kontext eines Paketmanagers ist
Ein Proxy-Server ist ein Vermittler. Statt sich direkt mit registry.npmjs.org zu verbinden, verbindet sich Ihr npm mit dem Proxy und bittet ihn, zu registry.npmjs.org zu gehen. Für HTTPS-Ressourcen wird die CONNECT-Methode verwendet: Der Proxy baut einen Tunnel auf, und der verschlüsselte Verkehr läuft ohne Entschlüsselung hindurch. Für den Paketmanager ist es wichtig, die Proxy-Adresse, den Port und bei Bedarf die Zugangsdaten zu kennen.
Wie Tools vom Proxy erfahren
Es gibt drei Ebenen von Einstellungen, die sich zu einer Prioritätskette zusammenfügen:
- Kommandozeilen-Flags: zum Beispiel pip install --proxy. Gilt für einen Lauf.
- Eigene Konfiguration des Tools: .npmrc, pip.conf und andere. Gilt immer für dieses Tool.
- Umgebungsvariablen: http_proxy, https_proxy, no_proxy. Gilt für alle Programme in der aktuellen Sitzung, die sie lesen.
Das Schlüsselwort ist die sie lesen. Und hier beginnen die Probleme.
Vier Gründe, warum Umgebungsvariablen nicht ausreichen
Erster Grund: Benutzerwechsel. Wenn Sie sudo apt update eingeben, wird der Befehl als root ausgeführt, und sudo löscht standardmäßig die Umgebung (Option env_reset). Ihre http_proxy bleiben beim normalen Benutzer. Darüber hinaus lädt apt Dateien unter dem Dienstbenutzer _apt herunter, der Ihre Sitzung überhaupt nicht hat.
Zweiter Grund: Dienste und Daemons. Docker Engine ist ein Hintergrunddienst, der von systemd beim Systemstart gestartet wird. Er hat Ihr Terminal nie gesehen. Der Befehl docker pull sendet nur eine Anfrage an den Daemon, und der Daemon lädt das Image herunter. Deshalb haben Variablen in Ihrer Konsole keinerlei Einfluss auf docker pull.
Dritter Grund: unterschiedliche Interpretation. Manche Programme lesen nur das kleingeschriebene http_proxy, andere nur HTTP_PROXY, wieder andere beide Varianten. Ältere npm-Versionen ignorierten no_proxy. Manche Tools verstehen keine Zugangsdaten in der Variablen. Eine eigene Konfiguration erspart das Raten.
Vierter Grund: Granularität. Eine Umgebungsvariable ist entweder da oder nicht. Aber Sie möchten vielleicht nur github.com über den Proxy leiten, nicht aber das interne GitLab. Oder über den Proxy zum öffentlichen PyPI gehen und zum internen Index direkt. Solche Regeln beherrschen nur Konfigurationen: git unterstützt Proxy-Einstellungen für eine bestimmte URL, apt für einen bestimmten Host, Docker eine Ausschlussliste auf Daemon-Ebene.
Sonderzeichen im Passwort kodieren
Benutzername und Passwort werden in Konfigurationen innerhalb einer URL der Form http://user:password@host:port übertragen. Die Zeichen @, :, /, #, ?, % und Leerzeichen im Passwort brechen die Adressauflösung. Sie müssen durch Prozentcodes ersetzt werden: @ wird zu %40, : wird zu %3A, # wird zu %23, / wird zu %2F, % wird zu %25, Leerzeichen zu %20. Zum Beispiel wird das Passwort p@ss:1 in der Konfiguration als p%40ss%3A1 geschrieben. Merken Sie sich diese Regel, sie rettet Sie bei allen fünf Tools.
Schritt 1: Proxy prüfen und Referenzzeichenkette vorbereiten
Ziel dieses Schritts: Sicherstellen, dass der Proxy überhaupt funktioniert, und eine geprüfte Verbindungszeichenkette erhalten, die wir in alle Konfigurationen einfügen.
- Öffnen Sie ein Terminal. Unter Linux mit Ctrl+Alt+T, unter Windows PowerShell über das Startmenü.
- Bauen Sie die Verbindungszeichenkette nach dem Muster http://LOGIN:PASSWORT@ADRESSE:PORT. Ohne Authentifizierung – einfach http://ADRESSE:PORT. Beispiel: http://dev:s3cret@10.20.30.40:3128.
- Führen Sie eine Testanfrage mit curl aus und geben Sie den Proxy explizit mit dem Flag -x an, um nicht von Variablen abhängig zu sein:
curl -x http://dev:s3cret@10.20.30.40:3128 -I https://registry.npmjs.org/ - Warten Sie auf die Antwort. Sie sollte mit HTTP/2 200 oder HTTP/1.1 200 OK beginnen. Wenn Sie 407 Proxy Authentication Required sehen, ist der Benutzername oder das Passwort falsch. Bei Could not resolve proxy liegt ein Tippfehler in der Adresse vor. Bei connection refused ist der Port falsch oder der Proxy aus.
- Wiederholen Sie die Prüfung für die übrigen Ziele: https://pypi.org/simple/, https://deb.debian.org/, https://registry-1.docker.io/v2/, https://github.com/. Für Docker ist die Antwort 401 normal; das bedeutet, dass Sie die Registry erreicht haben und sie ein Token anfordert.
- Notieren Sie die endgültige Zeichenkette in Ihrer Textdatei. Das ist Ihre Referenz-Proxy-Zeichenkette.
Achtung: Wenn das Passwort Sonderzeichen enthält, kodieren Sie sie genau in diesem Schritt und prüfen Sie die kodierte Variante mit curl. Dann fügen Sie in allen folgenden Konfigurationen eine bereits funktionierende Zeichenkette ein.
Tipp: Wenn Ihr Anbieter Ihnen nicht einen einzelnen Proxy, sondern einen Pool von Adressen oder einen mobilen Proxy mit IP-Rotation bereitstellt, gibt es normalerweise einen einheitlichen Einstiegspunkt: einen Host und Port, hinter dem die IPs automatisch wechseln. Tragen Sie in die Konfigurationen genau diesen Einstiegspunkt ein und nicht konkrete IPs aus dem Pool, sonst veralten die Einstellungen bei der ersten Rotation.
Prüfung: curl mit dem Flag -x gibt an allen fünf Adressen den Code 200 zurück (oder 401 für Docker Hub). Wenn auch nur eine nicht antwortet, machen Sie nicht weiter: Konfigurationen reparieren keinen nicht funktionierenden Proxy.
Schritt 2: npm über die Datei .npmrc einrichten
Ziel dieses Schritts: npm install, npm view und npm publish funktionieren über den Proxy aus jedem Projekt und jeder Konsole, einschließlich Entwicklungsumgebungen, die npm selbst starten.
Wo die npm-Konfiguration liegt
npm liest Einstellungen aus mehreren Dateien mit steigender Priorität: eingebaute Werte, globale Datei im npm-Installationsverzeichnis, benutzerspezifische ~/.npmrc (unter Windows C:\Users\NAME\.npmrc) und projektbezogene .npmrc im Projektstamm neben package.json. Für den Proxy wird fast immer die benutzerspezifische Datei verwendet: Sie gilt für alle Projekte, landet aber nicht im Repository.
Schritt-für-Schritt-Einrichtung
- Legen Sie den Proxy für normalen HTTP-Verkehr fest:
npm config set proxy http://dev:s3cret@10.20.30.40:3128 - Legen Sie den Proxy für HTTPS-Verkehr fest (die npm-Registry läuft über HTTPS, deshalb ist diese Einstellung die wichtigste):
Beachten Sie: Der Wert beginnt mit http://, nicht mit https://. Das ist die Adresse des Proxys selbst, und er nimmt Verbindungen normalerweise über normales HTTP an, auch wenn er HTTPS tunnelt.npm config set https-proxy http://dev:s3cret@10.20.30.40:3128 - Wenn Sie eine interne Registry oder ein Mirror haben, das direkt erreichbar sein muss, fügen Sie Ausnahmen durch Kommas getrennt hinzu:
Ein Punkt vor der Domain bedeutet alle Subdomains.npm config set noproxy localhost,127.0.0.1,.corp.local - Öffnen Sie die Datei und stellen Sie sicher, dass die Zeilen geschrieben wurden:
Unter Windows: type $env:USERPROFILE\.npmrc. Sie sollten drei Zeilen im Format Schlüssel=Wert sehen.cat ~/.npmrc - Wenn der Unternehmensproxy Zertifikate ersetzt, fügen Sie das Root-Zertifikat des Unternehmens hinzu:
Deaktivieren Sie die Zertifikatsprüfung nicht über strict-ssl=false, außer im äußersten Notfall: Das öffnet den Weg zur Paketunterdrückung.npm config set cafile /etc/ssl/certs/corp-root.pem
Ein alternativer Weg ist, die Datei manuell zu erstellen. Der Inhalt von ~/.npmrc sieht so aus:
proxy=http://dev:s3cret@10.20.30.40:3128 https-proxy=http://dev:s3cret@10.20.30.40:3128 noproxy=localhost,127.0.0.1,.corp.localJedes Paar muss in einer eigenen Zeile stehen. Ohne Anführungszeichen und ohne Leerzeichen um das Gleichheitszeichen.
Was ist mit yarn und pnpm
Yarn Classic (1.x) liest dieselbe ~/.npmrc und zusätzlich seine eigene ~/.yarnrc mit den Schlüsseln proxy und https-proxy. Yarn Berry (2+) speichert Einstellungen in .yarnrc.yml: Schlüssel httpProxy und httpsProxy. pnpm ist vollständig mit .npmrc kompatibel, es ist nichts zusätzlich zu tun. Denken Sie auch daran, dass npm ci und Unternehmens-IDEs npm unter demselben Benutzer starten, sodass die benutzerspezifische .npmrc auch diese abdeckt.
Tipp: Der Befehl npm config list --json zeigt die endgültige Konfiguration unter Berücksichtigung aller Dateien. Wenn Sie proxy=null sehen, wurde die Datei nicht gelesen: Prüfen Sie, ob sie im Home-Verzeichnis genau des Benutzers liegt, unter dem Sie npm ausführen.
Prüfung: Führen Sie npm view lodash version aus. Nach 1–3 Sekunden sollte eine Zeile mit der Versionsnummer zurückkommen. Zur Veranschaulichung können Sie die Umgebungsvariablen vorübergehend entfernen (unset http_proxy https_proxy) und es wiederholen: npm sollte trotzdem funktionieren, weil es .npmrc liest.
Mögliche Probleme
- ETIMEDOUT oder ECONNRESET: falsche Proxy-Adresse oder falscher Port, oder der Proxy blockiert CONNECT auf Port 443. Prüfen Sie die Referenzzeichenkette mit curl.
- 407 Proxy Authentication Required: Fehler bei Benutzername oder Passwort, meist ein nicht kodiertes Sonderzeichen.
- UNABLE_TO_GET_ISSUER_CERT_LOCALLY: Der Proxy ersetzt das Zertifikat, cafile mit dem Unternehmens-Root-Zertifikat ist nötig.
Schritt 3: pip über pip.conf einrichten
Ziel dieses Schritts: pip install und pip download funktionieren über den Proxy, auch innerhalb virtueller Umgebungen und beim Start aus Python-Skripten.
Wo pip.conf zu finden ist
pip verwendet drei Dateiebenen: global (für das gesamte System), benutzerspezifisch und Ebene der virtuellen Umgebung. Die Pfade hängen vom System ab:
- Linux, benutzerspezifisch: ~/.config/pip/pip.conf (die veraltete Variante ~/.pip/pip.conf wird ebenfalls gelesen).
- Linux, global: /etc/pip.conf.
- macOS, benutzerspezifisch: ~/Library/Application Support/pip/pip.conf, und wenn dieser Ordner nicht existiert – ~/.config/pip/pip.conf.
- Windows, benutzerspezifisch: %APPDATA%\pip\pip.ini, also C:\Users\NAME\AppData\Roaming\pip\pip.ini.
- Innerhalb einer virtuellen Umgebung: Datei pip.conf (oder pip.ini) direkt im Stammverzeichnis des venv.
Um nicht raten zu müssen, fragen Sie pip selbst: Der Befehl pip config debug gibt alle Pfade aus, die es prüft, und markiert die vorhandenen Dateien.
Schritt-für-Schritt-Einrichtung
- Stellen Sie sicher, dass pip aktuell ist: pip --version. Es sollte Version 24 oder neuer sein.
- Legen Sie den Proxy mit einem Befehl fest, pip erstellt die Datei selbst am richtigen Ort:
Hier bedeutet global den Abschnitt [global] in der Datei, nicht die Systemebene. Die Datei wird benutzerspezifisch erstellt.pip config set global.proxy http://dev:s3cret@10.20.30.40:3128 - Wenn der Proxy Zertifikate ersetzt, geben Sie das Root-Zertifikat an:
pip config set global.cert /etc/ssl/certs/corp-root.pem - Schauen Sie, was dabei herausgekommen ist:
Erwartete Ausgabe: global.proxy='http://dev:s3cret@10.20.30.40:3128'.pip config list - Öffnen Sie die Datei und prüfen Sie das Format. Es sollte so aussehen:
Jede Zeile separat, der Abschnitt in eckigen Klammern oben.[global] proxy = http://dev:s3cret@10.20.30.40:3128 cert = /etc/ssl/certs/corp-root.pem
Ein wichtiger Unterschied von pip zu npm: pip hat keine separate Einstellung für HTTPS-Proxy. Ein Schlüssel proxy wird für alle Verbindungen verwendet. Und pip hat kein direktes Äquivalent zu noproxy in der Konfiguration: Ausnahmen nimmt es nur aus der Umgebungsvariable no_proxy. Wenn Sie einen internen Index direkt erreichen müssen, geben Sie für ihn am einfachsten eine separate index-url an und starten pip mit einem leeren --proxy-Wert für diesen Fall, oder verwenden Sie eine projektbezogene pip.conf innerhalb des venv ohne die Zeile proxy.
Tipp: Wenn Sie mehrere Projekte haben und in einem ein Proxy benötigt wird, im anderen nicht, legen Sie pip.conf in das Stammverzeichnis der entsprechenden virtuellen Umgebung. Die Einstellungen des venv haben Vorrang vor den benutzerspezifischen, und Sie erhalten unterschiedliches Verhalten, ohne globale Dateien umzuschalten.
Achtung: Fügen Sie nicht trusted-host = pypi.org hinzu, um Zertifikatsfehler zu unterdrücken. Das deaktiviert die Authentizitätsprüfung und erlaubt jedem Vermittler, Ihnen ein gefälschtes Paket unterzuschieben. Die richtige Lösung ist der Schlüssel cert mit dem Unternehmenszertifikat.
Prüfung: Führen Sie pip download requests --no-deps -d /tmp/piptest aus. Nach einigen Sekunden erscheint im Verzeichnis eine Datei requests-*.whl. Löschen Sie dann das Testverzeichnis. Wenn Sie sicherstellen möchten, dass genau die Konfiguration wirkt, entfernen Sie die Umgebungsvariablen und wiederholen Sie den Vorgang.
Mögliche Probleme
- ProxyError oder Cannot connect to proxy: Tippfehler in der Adresse oder falscher Port. Vergleichen Sie mit der Referenzzeichenkette.
- Tunnel connection failed: 407: Authentifizierungsfehler. Prüfen Sie die Kodierung des Passworts.
- SSLError CERTIFICATE_VERIFY_FAILED: Der Schlüssel cert mit dem Root-Zertifikat des Proxys ist nötig.
- Die Datei wurde geschrieben, aber pip sieht sie nicht: Sie führen pip eines anderen Interpreters aus (z. B. python3 -m pip von einem anderen Python). Führen Sie pip config debug genau mit dem Befehl aus, mit dem Sie Pakete installieren.
Schritt 4: apt über das Verzeichnis apt.conf.d einrichten
Ziel dieses Schritts: sudo apt update und sudo apt install laden Pakete über den Proxy herunter, während Anfragen an das interne Mirror direkt laufen.
Warum gerade apt.conf.d
apt liest Einstellungen aus /etc/apt/apt.conf und allen Dateien im Verzeichnis /etc/apt/apt.conf.d/ in alphabetischer Reihenfolge. Guter Stil ist, fremde Dateien nicht anzufassen, sondern eine eigene mit numerischem Präfix zu erstellen. Die Zahl bestimmt die Lesereihenfolge: Die Datei 80proxy wird nach 01autoremove und anderen Systemdateien angewendet. Genau hier überstehen die Einstellungen alle Aktualisierungen des apt-Pakets.
Schritt-für-Schritt-Einrichtung
- Erstellen Sie eine neue Einstellungsdatei:
Ein leerer Editor öffnet sich.sudo nano /etc/apt/apt.conf.d/80proxy - Schreiben Sie zwei Zeilen für HTTP- und HTTPS-Repositories. Achten Sie auf Anführungszeichen und Semikolons – in der apt-Syntax sind sie Pflicht:
Acquire::http::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::https::Proxy "http://dev:s3cret@10.20.30.40:3128"; - Wenn es ein internes Mirror gibt, für das kein Proxy nötig ist, fügen Sie eine Zeile mit einer Ausnahme hinzu. Das Wort DIRECT in Großbuchstaben bedeutet direkte Verbindung:
Acquire::http::Proxy::mirror.corp.local "DIRECT"; - Speichern Sie die Datei: In nano drücken Sie Ctrl+O, dann Enter, dann Ctrl+X zum Beenden.
- Beschränken Sie die Rechte der Datei, denn sie enthält ein Passwort:
Nur root kann den Inhalt lesen.sudo chmod 600 /etc/apt/apt.conf.d/80proxy - Prüfen Sie, dass apt die Datei ohne Syntaxfehler geparst hat:
Sie sollten die Zeilen Acquire::http::Proxy und Acquire::https::Proxy mit Ihren Werten sehen.apt-config dump | grep -i proxy
Hier ein vollständiges Beispiel der Datei zur Veranschaulichung:
Acquire::http::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::https::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::http::Proxy::mirror.corp.local "DIRECT"; Acquire::https::Proxy::mirror.corp.local "DIRECT";Eine Alternative für einen einzelnen Lauf ohne Datei: sudo apt -o Acquire::http::Proxy="http://10.20.30.40:3128" update. Das Flag -o ist praktisch, um einen Wert zu testen, bevor man ihn in die Konfiguration schreibt.
Tipp: Proxy-Server, die selbst deb-Pakete cachen, haben oft einen separaten Port für apt. Fragen Sie Ihren Administrator: Wenn es einen gibt, beschleunigt sich apt update um ein Vielfaches durch den lokalen Cache.
Prüfung: Führen Sie sudo apt update aus. In der Ausgabe erscheinen Zeilen mit Hit oder Get und Repository-Adressen, und es gibt keine Zeilen mit Err. Beachten Sie, dass wir keine Umgebungsvariablen gesetzt haben und sudo sie ohnehin zurückgesetzt hätte, und apt trotzdem ins Netz gegangen ist. Das ist der Effekt einer eigenen Konfiguration.
Mögliche Probleme
- Err: 407 Proxy Authentication Required: Authentifizierung fehlgeschlagen, prüfen Sie die Kodierung der Sonderzeichen.
- Could not connect oder Connection timed out: apt ist direkt gegangen. Wahrscheinlich ist ein Tippfehler in der Datei, den apt-config dump nicht anzeigt. Prüfen Sie die Groß-/Kleinschreibung in Acquire und die doppelten Doppelpunkte.
- E: Syntax error: Ein Semikolon oder Anführungszeichen am Zeilenende fehlt.
- Die Datei ist vorhanden, aber die Ausnahme DIRECT funktioniert nicht: Stellen Sie sicher, dass der Hostname in der Ausnahmezeile buchstabengenau mit dem in sources.list übereinstimmt, ohne http:// und ohne Port.
Schritt 5: Docker auf zwei Ebenen einrichten
Ziel dieses Schritts: docker pull, docker build und docker compose pull laden Images über den Proxy herunter, und Container erhalten bei Bedarf automatisch die Proxy-Einstellungen.
Zwei Ebenen, die oft verwechselt werden
Docker hat zwei unabhängige Stellen, an denen der Proxy unterschiedlich benötigt wird:
- Daemon-Ebene (Dienst dockerd). Genau er lädt Images aus der Registry. Wird in /etc/docker/daemon.json oder über systemd konfiguriert. Erfordert einen Neustart des Dienstes.
- Client-Ebene (Datei ~/.docker/config.json). Sie beeinflusst das Herunterladen von Images nicht. Dafür übergibt sie automatisch Proxy-Variablen in die gestarteten Container und in den Build-Prozess, damit apt oder pip im Container den Proxy ebenfalls sehen.
Wenn Sie nur den Client konfigurieren, funktioniert docker pull nicht. Wenn Sie nur den Daemon konfigurieren, werden Images geladen, aber RUN apt-get update im Dockerfile schlägt fehl. Beides ist nötig.
Teil A: Daemon über daemon.json
- Prüfen Sie die Version: docker version. Wenn die Serverversion 23.0 oder neuer ist, verwenden Sie daemon.json. Wenn sie älter ist, gehen Sie zu Teil B.
- Öffnen Sie die Daemon-Einstellungsdatei:
Wenn die Datei bereits existiert und andere Schlüssel enthält, fügen Sie den Block proxies innerhalb derselben geschweiften Klammern durch Komma getrennt hinzu. Wenn die Datei nicht existiert, erstellen Sie sie von Grund auf.sudo nano /etc/docker/daemon.json - Schreiben Sie den Einstellungsblock:
Beachten Sie: Die Schlüssel werden mit Bindestrich und in Kleinbuchstaben genau so geschrieben. Das ist das Format des Daemons, beim Client sind die Schlüssel anders.{ "proxies": { "http-proxy": "http://dev:s3cret@10.20.30.40:3128", "https-proxy": "http://dev:s3cret@10.20.30.40:3128", "no-proxy": "localhost,127.0.0.0/8,registry.corp.local" } } - Speichern Sie die Datei (Ctrl+O, Enter, Ctrl+X).
- Prüfen Sie, dass das JSON gültig ist, sonst startet der Daemon nicht:
Wenn der Befehl den Inhalt der Datei mit Einrückungen ausgibt, ist die Syntax korrekt. Wenn er sich über Expecting value oder Extra data beschwert, suchen Sie nach einem überflüssigen oder fehlenden Komma.python3 -m json.tool /etc/docker/daemon.json - Starten Sie den Dienst neu:
Der Neustart dauert 5–15 Sekunden. Alle laufenden Container werden dabei gestoppt, machen Sie das also in einem ruhigen Moment.sudo systemctl restart docker - Stellen Sie sicher, dass der Daemon hochgefahren ist: sudo systemctl status docker. Es sollte die Meldung active (running) in grüner Farbe erscheinen.
Achtung: Ein überflüssiges Komma in daemon.json – und Docker startet überhaupt nicht, und mit ihm fallen alle Container auf der Maschine aus. Prüfen Sie die Datei vor jedem Neustart mit json.tool und halten Sie eine Sicherungskopie bereit.
Teil B: Daemon über systemd (für ältere Versionen und als Alternative)
- Erstellen Sie ein Verzeichnis für zusätzliche Dienst-Einstellungen: sudo mkdir -p /etc/systemd/system/docker.service.d
- Erstellen Sie die Datei: sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf
- Schreiben Sie:
[Service] Environment="HTTP_PROXY=http://dev:s3cret@10.20.30.40:3128" Environment="HTTPS_PROXY=http://dev:s3cret@10.20.30.40:3128" Environment="NO_PROXY=localhost,127.0.0.0/8,registry.corp.local" - Speichern und anwenden: sudo systemctl daemon-reload, dann sudo systemctl restart docker.
Ja, hier werden Umgebungsvariablen verwendet, aber sie sind nicht in Ihrer Konsole gesetzt, sondern in der Dienstdefinition: Der Daemon erhält sie beim Start von systemd. Dies ist die einzige Möglichkeit für Docker älter als Version 23. Wenn sowohl daemon.json als auch die systemd-Datei gesetzt sind, hat daemon.json Vorrang.
Teil C: Client über ~/.docker/config.json
- Öffnen oder erstellen Sie die Datei nano ~/.docker/config.json. Wenn die Datei bereits einen Block auths mit Ihren Logins für Registries enthält, löschen Sie ihn nicht, sondern fügen Sie einen neuen Block daneben durch Komma getrennt hinzu.
- Schreiben Sie:
Hier sind die Schlüssel im camelCase-Stil: httpProxy, httpsProxy, noProxy. Das ist der Unterschied zu daemon.json, und Verwechslungen sind nicht erlaubt.{ "proxies": { "default": { "httpProxy": "http://dev:s3cret@10.20.30.40:3128", "httpsProxy": "http://dev:s3cret@10.20.30.40:3128", "noProxy": "localhost,127.0.0.0/8,.corp.local" } } } - Speichern Sie die Datei. Ein Neustart ist nicht erforderlich, der Client liest sie bei jedem Befehl.
Jetzt gelangen bei docker run und docker build die Variablen HTTP_PROXY, HTTPS_PROXY und NO_PROXY (in beiden Schreibweisen) automatisch in den Container. Das heißt, apt-get und pip im Dockerfile laufen ebenfalls über den Proxy, ohne manuelle ARG und ENV.
Docker Desktop unter Windows und macOS
Öffnen Sie die Einstellungen über das Symbol im Infobereich, den Abschnitt Resources, Unterabschnitt Proxies. Schalten Sie Manual proxy configuration ein, tragen Sie die Adresse in die Felder Web Server (HTTP) und Secure Web Server (HTTPS) ein, die Ausschlussliste in Bypass proxy settings for these hosts and domains. Klicken Sie auf Apply and restart. Die Client-config.json liegt unter Windows in C:\Users\NAME\.docker\config.json und wird genauso konfiguriert wie oben beschrieben.
Tipp: Der Befehl docker info gibt einen Abschnitt mit HTTP Proxy, HTTPS Proxy und No Proxy aus. Das ist der schnellste Weg herauszufinden, ob der Daemon Ihre Einstellungen gesehen hat, ohne einen Download zu starten.
Prüfung: Führen Sie docker pull hello-world aus. Das Image ist nur wenige Kilobyte groß und wird in ein paar Sekunden heruntergeladen, am Ende erscheint Status: Downloaded newer image. Prüfen Sie dann den Client-Teil: docker run --rm alpine env | grep -i proxy. In der Ausgabe sollten Zeilen mit HTTP_PROXY und HTTPS_PROXY und Ihrer Adresse stehen.
Mögliche Probleme
- Docker startet nach der Bearbeitung von daemon.json nicht: Syntaxfehler. Schauen Sie in sudo journalctl -u docker -n 30, dort wird die fehlerhafte Zeile angegeben. Stellen Sie aus der Sicherungskopie wieder her.
- docker pull hängt und läuft in einen Timeout, obwohl docker info den Proxy anzeigt: Der Daemon wurde nach der Bearbeitung nicht neu gestartet, oder der Proxy erlaubt kein CONNECT zu registry-1.docker.io. Prüfen Sie die Referenzzeichenkette mit curl.
- Im Build schlägt apt-get update fehl, aber docker pull funktioniert: Die Client-config.json ist nicht konfiguriert, oder der Build läuft über einen entfernten Builder, der eine andere Datei liest.
- Der Container hat den Proxy erhalten, kann aber einen benachbarten Container nicht erreichen: Fügen Sie die Namen der internen Dienste und das Docker-Subnetz in noProxy hinzu.
Schritt 6: git über git config einrichten
Ziel dieses Schritts: git clone, fetch, pull und push über HTTPS laufen über den Proxy, während für den internen Server eine direkte Verbindung bleiben kann und für einen bestimmten Hosting-Anbieter ein separater Proxy festgelegt werden kann.
Wo git Einstellungen speichert
Drei Ebenen: systemweit (/etc/gitconfig), global für den Benutzer (~/.gitconfig, unter Windows C:\Users\NAME\.gitconfig) und lokal im Repository (.git/config). Der Proxy wird normalerweise global gesetzt, punktuelle Ausnahmen ebenfalls global, aber mit URL-Bindung.
Schritt-für-Schritt-Einrichtung
- Legen Sie den Proxy für alle HTTPS- und HTTP-Verbindungen mit einem Befehl fest:
Im Gegensatz zu npm hat git kein separates https.proxy für das HTTPS-Protokoll: Der Schlüssel http.proxy gilt für beide. Die Einstellung https.proxy findet sich in alten Anleitungen, ist aber kein Standard-Git-Schlüssel und wird ignoriert.git config --global http.proxy http://dev:s3cret@10.20.30.40:3128 - Wenn für den internen Server kein Proxy nötig ist, setzen Sie einen leeren Wert genau für seine URL:
Eine leere Zeichenkette bedeutet direkte Verbindung. Der Teil zwischen http. und .proxy ist das URL-Präfix, für das die Regel gilt.git config --global http.https://git.corp.local.proxy "" - Wenn für einen einzelnen Hosting-Anbieter ein anderer Proxy nötig ist (z. B. ein dedizierter mobiler), geben Sie ihn genauso mit URL-Bindung an:
git config --global http.https://github.com.proxy http://dev:s3cret@10.20.30.41:3128 - Wenn der Proxy Zertifikate ersetzt, fügen Sie das Root-Zertifikat hinzu:
git config --global http.sslCAInfo /etc/ssl/certs/corp-root.pem - Prüfen Sie die endgültige Datei:
Sie sehen Zeilen wie http.proxy=... und http.https://git.corp.local.proxy= mit leerem Wert.git config --global --list | grep -i proxy
Die Datei ~/.gitconfig sieht nach diesen Befehlen so aus:
[http] proxy = http://dev:s3cret@10.20.30.40:3128 sslCAInfo = /etc/ssl/certs/corp-root.pem [http "https://git.corp.local"] proxy = [http "https://github.com"] proxy = http://dev:s3cret@10.20.30.41:3128Eine solche Granularität ist über Umgebungsvariablen nicht erreichbar: no_proxy kann nur Hosts ausschließen, aber nicht verschiedenen Servern verschiedene Proxies zuweisen.
Was ist mit SSH-Adressen
Die Einstellung http.proxy wirkt sich nicht auf Adressen der Form git@github.com:user/repo.git aus, weil das das SSH-Protokoll ist, nicht HTTP. Wenn Ihr Proxy Tunneling auf Port 22 über CONNECT erlaubt, können Sie den SSH-Client in der Datei ~/.ssh/config mit der Direktive ProxyCommand und dem Dienstprogramm nc oder corkscrew konfigurieren. Aber viele Unternehmensproxys verbieten solche Verbindungen. Der einfachste und vorhersehbarste Weg ist, die Remote-Adressen auf HTTPS umzustellen: git remote set-url origin https://github.com/user/repo.git und ein Zugriffstoken statt eines Passworts zu verwenden.
Tipp: Um das Proxy-Passwort nicht im Klartext in ~/.gitconfig zu speichern, können Sie es in eine separate Datei mit Rechten 600 auslagern und per include-Direktive einbinden. Erstellen Sie ~/.gitconfig-proxy mit dem Abschnitt [http], und fügen Sie in der Hauptdatei [include] path = ~/.gitconfig-proxy hinzu. Die Hauptkonfiguration können Sie dann bedenkenlos Kollegen zeigen.
Prüfung: Führen Sie git ls-remote https://github.com/git/git.git HEAD aus. Nach ein paar Sekunden kommt eine Zeile mit dem Commit-Hash und dem Wort HEAD zurück. Der Befehl erstellt keine Dateien und klont nichts, das ist der ideale Test für den Netzwerkteil. Prüfen Sie dann die Ausnahme: git ls-remote zum internen Server sollte auch bei nicht erreichbarem Proxy funktionieren.
Mögliche Probleme
- Failed to connect to proxy oder Could not resolve proxy: Tippfehler in der Adresse.
- Received HTTP code 407 from proxy after CONNECT: Authentifizierungsfehler, prüfen Sie die Kodierung des Passworts.
- SSL certificate problem: unable to get local issuer certificate: http.sslCAInfo ist nötig. Verwenden Sie http.sslVerify false nicht dauerhaft.
- Die URL-Regel wird nicht angewendet: Das Präfix muss mit dem Anfang der Adresse im Remote übereinstimmen. Wenn das Remote als https://www.github.com geschrieben ist, greift die Regel für https://github.com nicht.
Ergebnis überprüfen: Gesamt-Checkliste
Wenn Sie alle fünf Tools konfiguriert haben, führen Sie die abschließende Prüfung durch. Sie ist bewusst so aufgebaut, dass der Einfluss von Umgebungsvariablen ausgeschlossen wird und sichergestellt ist, dass genau die Konfigurationen wirken.
- Öffnen Sie ein neues Terminal und entfernen Sie die Variablen, falls sie gesetzt sind: unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY. In PowerShell: Remove-Item Env:HTTP_PROXY und analog für die anderen.
- Prüfen Sie npm: npm view express version. Erwartet wird eine Versionsnummer.
- Prüfen Sie pip: pip download six --no-deps -d /tmp/t. Erwartet wird eine heruntergeladene whl-Datei.
- Prüfen Sie apt: sudo apt update. Erwartet werden Zeilen mit Hit oder Get ohne Err.
- Prüfen Sie Docker: docker pull hello-world und docker run --rm alpine env | grep -i proxy. Erwartet werden ein heruntergeladenes Image und Variablen im Container.
- Prüfen Sie git: git ls-remote https://github.com/git/git.git HEAD. Erwartet wird ein Commit-Hash.
Indikatoren für erfolgreiche Ausführung
- Alle sechs Befehle liefen ohne Umgebungsvariablen in der Konsole durch.
- In den Dateien .npmrc, pip.conf, 80proxy, daemon.json, config.json und .gitconfig ist dieselbe Referenz-Proxy-Zeichenkette eingetragen.
- Die Dateien mit Passwörtern (80proxy, daemon.json, .npmrc, pip.conf, .gitconfig) haben Rechte 600 oder sind nur für root zugänglich.
- Die Ausnahmen für interne Hosts funktionieren: Der Zugriff auf sie läuft auch bei ausgeschaltetem Proxy.
- Sicherungskopien der Originaldateien liegen bereit und Sie wissen, wie Sie sie zurückholen.
Prüfung: Wenn auch nur ein Punkt nicht erfüllt ist, gehen Sie zurück zum Abschnitt des entsprechenden Tools und vergleichen Sie Ihre Datei Zeichen für Zeichen mit dem Beispiel aus dem Leitfaden. In neun von zehn Fällen ist die Ursache ein Tippfehler oder ein nicht kodiertes Zeichen im Passwort.
Typische Fehler und Lösungen
Fehler 1: Überall der Code 407 Proxy Authentication Required
Ursache: Das Passwort enthält ein Sonderzeichen (@, :, #, %), das nicht kodiert wurde, und das Tool hat die Adresse falsch aufgelöst.
Lösung: Kodieren Sie die Zeichen mit Prozentcodes (@ zu %40, : zu %3A, # zu %23, % zu %25) und prüfen Sie die neue Zeichenkette mit curl -x, bevor Sie sie in die Konfigurationen schreiben.
Fehler 2: Funktioniert im Terminal, funktioniert nicht mit sudo
Ursache: sudo setzt die Umgebung zurück, und Sie haben die Konfiguration noch nicht erstellt. Klassiker bei apt.
Lösung: Erstellen Sie /etc/apt/apt.conf.d/80proxy wie in Schritt 4. Für andere Tools unter root denken Sie daran, dass root sein eigenes Home-Verzeichnis /root liest, nicht Ihres: Wenn npm oder pip unter root benötigt wird, muss die Konfiguration in /root/.npmrc oder /root/.config/pip/pip.conf liegen.
Fehler 3: Docker startet nach der Bearbeitung von daemon.json nicht
Ursache: Ungültiges JSON: ein überflüssiges Komma nach dem letzten Element, eine fehlende Klammer, einfache statt doppelte Anführungszeichen.
Lösung: Führen Sie sudo journalctl -u docker -n 30 aus, suchen Sie die Zeile mit dem Fehler, korrigieren Sie die Datei und prüfen Sie sie mit python3 -m json.tool vor dem nächsten Neustart. Im Extremfall stellen Sie daemon.json.bak wieder her.
Fehler 4: docker pull funktioniert, aber apt-get im Dockerfile schlägt fehl
Ursache: Der Daemon ist konfiguriert, aber nicht der Client. Prozesse im Container erben nicht die Einstellungen des Daemons.
Lösung: Erstellen Sie ~/.docker/config.json mit dem Block proxies.default wie in Teil C von Schritt 5. Danach übergibt docker build die Variablen automatisch an die RUN-Phasen.
Fehler 5: SSL-Zertifikatsfehler in allen Tools
Ursache: Der Proxy führt eine Verkehrsprüfung durch und setzt sein eigenes Zertifikat ein, dem das System nicht vertraut.
Lösung: Holen Sie das Root-Zertifikat des Proxys im PEM-Format vom Administrator und tragen Sie es ein: npm cafile, pip cert, git http.sslCAInfo. Für apt und Docker genügt es, das Zertifikat in den Systemspeicher aufzunehmen: Kopieren Sie es nach /usr/local/share/ca-certificates/ und führen Sie sudo update-ca-certificates aus, dann starten Sie Docker neu. Deaktivieren Sie nicht die Zertifikatsprüfung mit Flags wie strict-ssl, trusted-host und sslVerify.
Fehler 6: pip ignoriert pip.conf
Ursache: Auf der Maschine gibt es mehrere Python-Versionen, und Sie bearbeiten die Konfiguration für eine, starten aber eine andere. Oder die Datei liegt an einem veralteten Ort, den die jeweilige Version nicht liest.
Lösung: Führen Sie python3 -m pip config debug mit genau dem Befehl aus, mit dem Sie Pakete installieren. Die Ausgabe zeigt, welche Dateien gefunden wurden. Verschieben Sie die Einstellungen in den gefundenen benutzerspezifischen Pfad.
Fehler 7: git geht auch zum internen Server über den Proxy
Ursache: Die Ausnahmeregel ist für eine URL definiert, die nicht mit der Adresse im Remote übereinstimmt. Oder sie ist in der lokalen .git/config eines anderen Repositorys gesetzt.
Lösung: Sehen Sie sich die genaue Adresse mit git remote -v an, kopieren Sie den Anfang bis zum Hostnamen und setzen Sie die Regel http.GENAUE_URL.proxy mit leerem Wert über --global.
Fehler 8: Alles funktionierte, aber nach einem Passwortwechsel des Proxys ist es kaputt
Ursache: Das Passwort ist in fünf verschiedenen Dateien hinterlegt, und nicht alle wurden aktualisiert.
Lösung: Verwenden Sie den Befehl grep -rl 'altes_passwort' ~/.npmrc ~/.config/pip ~/.gitconfig ~/.docker und sudo grep -rl für /etc/apt/apt.conf.d und /etc/docker, um alle Vorkommen zu finden, und aktualisieren Sie jedes. Führen Sie dann die Gesamt-Checkliste aus.
Zusätzliche Möglichkeiten
Lokaler Proxy-Aggregator als einheitlicher Einstiegspunkt
Wenn sich die Proxy-Zugangsdaten häufig ändern oder ein Adresspool rotiert, ist es praktisch, lokal einen leichten Proxy laufen zu lassen (z. B. auf 127.0.0.1:3128), der selbst weiß, wohin und mit welchen Daten er gehen muss. Dann tragen Sie in alle fünf Konfigurationen eine Adresse ohne Passwort ein, und die Änderung der Zugangsdaten erfolgt an einer Stelle. Das löst auch das Problem von Tools, die mit Authentifizierung in URLs schlecht umgehen.
Mirrors und Cache-Proxys für Pakete
Ein Proxy muss nicht universell sein. Für apt gibt es Cache-Proxys, die deb-Dateien lokal speichern und dem ganzen Büro bereitstellen. Für npm und pip richten Unternehmen private Registries ein, die öffentliche proxyen und dabei cachen. In diesem Fall verwendet man statt des Schlüssels proxy ein registry in .npmrc und index-url in pip.conf, und der Proxy für die Außenwelt wird auf dieser Registry konfiguriert. Für Docker spielt der Schlüssel registry-mirrors in daemon.json eine ähnliche Rolle.
Getrennte Einstellungen für verschiedene Projekte
Projektbezogene .npmrc neben package.json, pip.conf innerhalb des venv und lokale .git/config ermöglichen es einem Projekt, über den Proxy zu gehen, und einem anderen direkt. Committen Sie nur keine Dateien mit Passwörtern ins Repository: Fügen Sie sie in .gitignore ein oder verwenden Sie Variablenplatzhalter wie ${PROXY_URL}, die npm beim Lesen von .npmrc aus der Umgebung auflösen kann.
Automatisierung der Ausrollung
Alle fünf Konfigurationen sind einfache Textdateien. Sie lassen sich bequem per Skript oder Konfigurationsmanagementsystem ausrollen: Das Skript erhält die Referenzzeichenkette als einen Parameter und generiert die Dateien in den benötigten Formaten. Verwenden Sie zur Prüfung nach der Ausrollung die Befehle aus der Gesamt-Checkliste: Sie erfordern keine Interaktivität und eignen sich für automatisierte Tests.
Sicherheit bei der Speicherung von Passwörtern
Das Minimum sind Rechte 600 auf jede Datei mit Passwort. Besser ist die Auslagerung von Geheimnissen in separate einbindbare Dateien (include in git, eine separate Datei in apt.conf.d nur für autorisierte Zeilen). Noch besser ist ein Proxy ohne Passwortauthentifizierung, aber mit IP-Beschränkung, oder ein lokaler Aggregator wie oben beschrieben. Und senden Sie niemals Konfigurationen mit Passwörtern vollständig in Chats oder Tickets.
FAQ: Häufige Fragen zur Konfiguration
Muss ich jetzt die Variablen http_proxy aus .bashrc entfernen
Nicht unbedingt. Die Tool-Konfigurationen haben Vorrang vor den Variablen, es gibt keinen Konflikt. Aber wenn Sie möchten, dass nur Paketmanager über den Proxy gehen und Browser und andere Programme direkt, sollten Sie die Variablen entfernen: Sie beeinflussen alles.
Warum wird in https-proxy für npm eine Adresse mit http:// und nicht mit https:// geschrieben
Weil das die Adresse des Proxy-Servers ist, nicht das Protokoll der Zielressource. Die meisten Proxys nehmen Verbindungen über normales HTTP an und tunneln HTTPS darin. Wenn Ihr Proxy tatsächlich TLS-Verbindungen annimmt, schreiben Sie https://, aber das ist selten.
Kann man einen SOCKS5-Proxy verwenden
npm – nein, es unterstützt nur HTTP-Proxy. pip – ja, mit installiertem pysocks-Paket und Adresse der Form socks5://host:port. git – ja, Format socks5h://host:port, der Buchstabe h bedeutet Namensauflösung auf der Proxy-Seite. apt – nur über zusätzliche Transporte, standardmäßig nein. Docker – nein. In der Praxis ist es einfacher, beim Anbieter einen HTTP-Port zu bekommen.
Wie deaktiviere ich den Proxy in allen Tools schnell
npm: npm config delete proxy und npm config delete https-proxy. pip: pip config unset global.proxy. git: git config --global --unset http.proxy. apt: Löschen oder benennen Sie /etc/apt/apt.conf.d/80proxy um. Docker: Entfernen Sie den Block proxies aus daemon.json und config.json, starten Sie den Dienst neu. Oder stellen Sie einfach die .bak-Dateien aus den Sicherungskopien wieder her.
Wo speichere ich die Konfigurationen unter Windows
npm: C:\Users\NAME\.npmrc. pip: C:\Users\NAME\AppData\Roaming\pip\pip.ini. git: C:\Users\NAME\.gitconfig. Docker: C:\Users\NAME\.docker\config.json für den Client und Docker Desktop-Einstellungen für den Daemon. apt wird unter Windows nicht verwendet, außer in WSL, wo die Linux-Pfade innerhalb des Subsystems gelten.
Funktioniert das in WSL
Ja, WSL ist ein normales Linux, alle Konfigurationen liegen an Linux-Pfaden innerhalb der Distribution. Beachten Sie, dass Docker Desktop mit WSL-Integration den Daemon auf der Windows-Seite verwendet, deshalb werden die Daemon-Einstellungen in Docker Desktop vorgenommen, und die Client-config.json liegt innerhalb von WSL im Home-Verzeichnis.
Wie finde ich heraus, welches Tool welche Datei gelesen hat
npm config list --json, pip config debug, apt-config dump, docker info, git config --show-origin --list. Jeder Befehl zeigt nicht nur Werte, sondern auch die Quelle, aus der sie stammen. Das ist das Erste, was man beim Debuggen ausführen sollte.
Warum sieht Docker Compose den Proxy nicht
Compose ist ein Client, es verwendet denselben Daemon und dieselbe ~/.docker/config.json. Wenn docker pull funktioniert, docker compose pull aber nicht, prüfen Sie, ob Sie Compose unter demselben Benutzer starten und ob in der Compose-Datei nicht Umgebungsvariablen der Container überschrieben werden, die den Proxy überdecken.
Kann man verschiedene Proxys für npm und pip festlegen
Ja, genau darin liegt der Vorteil eigener Konfigurationen. Jede Datei ist unabhängig. Zum Beispiel kann npm über einen Proxy gehen und pip über einen anderen, mit anderer IP und anderer Geolokation, wenn die Aufgabe es erfordert.
Fazit
Fassen wir zusammen. Sie haben den Proxy mit curl geprüft und eine Referenz-Verbindungszeichenkette mit korrekt kodiertem Passwort erhalten. Dann haben Sie sie an fünf Stellen eingetragen: in ~/.npmrc für npm, in pip.conf für pip, in /etc/apt/apt.conf.d/80proxy für apt, in daemon.json und ~/.docker/config.json für Docker und in ~/.gitconfig für git. Für jedes Tool haben Sie Ausnahmen für interne Hosts gesetzt, wo dies unterstützt wird, und sich vergewissert, dass alles auch bei vollständig geleerter Umgebung funktioniert. Genau das unterscheidet eigene Konfigurationen von Umgebungsvariablen: Sie hängen nicht davon ab, wer, von wo und über welchen Dienst den Befehl gestartet hat.
Was als Nächstes zu tun ist. Speichern Sie die fünf Referenzdateien in einem persönlichen Ordner und schreiben Sie ein kurzes Skript, das sie auf eine neue Maschine ausrollt. Prüfen Sie die Rechte der Dateien mit Passwörtern. Wenn Sie Kollegen mit demselben Problem haben, teilen Sie die Gesamt-Checkliste mit ihnen: Sie spart Stunden beim Debuggen.
Wohin man sich weiterentwickeln kann. Die nächste Stufe sind Cache-Proxys und private Registries für Pakete, ein lokaler Proxy-Aggregator als einheitlicher Einstiegspunkt und automatisierte Prüfung der Netzwerkeinstellungen in Pipelines. Und wenn Sie den Proxy nicht für Tools, sondern für eine bestimmte Terminal-Sitzung oder eine Aufgabe in CI einrichten müssen, gibt es dafür eine separate Anleitung zu Umgebungsvariablen. Jetzt wissen Sie genau, wo deren Möglichkeiten enden und die der Konfigurationen beginnen.