Einen Proxy in Git einrichten
Kurz gesagt: Mit git config –global http.proxy http://LOGIN:PASSWORD@HOST:PORT schicken Sie Git über einen HTTP Proxy, mit socks5h://HOST:PORT über SOCKS5. Das gilt nur für http- und https-Remotes, nicht für SSH. Entfernen Sie den Proxy mit git config –global –unset http.proxy. Die Zugangsdaten stehen im Klartext in Ihrer Git-Konfigurationsdatei.
Git spricht mit http- und https-Remotes über libcurl und folgt deshalb denselben Proxy-Regeln wie curl. Host, Port, Login und Passwort entnehmen Sie einer Zeile unter Meine Proxies in Ihrem Dashboard.
Für alle Repositories festlegen
git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT
Das schreibt eine Zeile in ~/.gitconfig. Eine Einstellung deckt http- und https-Remotes
ab. Prüfen Sie sie mit git config --get http.proxy.
Bei einer SOCKS5-Bestellung stellen Sie diese zuerst mit Protokoll ändern um, kopieren die Zugangsdaten erneut und verwenden:
git config --global http.proxy socks5h://LOGIN:PASSWORD@HOST:PORT
Das h sorgt dafür, dass der Proxy die Hostnamen auflöst. Das Protokoll beschreibt die
Seite SOCKS5-Proxys.
Sonderzeichen kodieren
Der Login steht innerhalb einer URL, deshalb schreiben Sie @ als %40, : als %3A, /
als %2F, # als %23 und % als %25. Ein nicht kodiertes Passwort wird abgeschnitten,
und der Proxy antwortet mit 407.
Ein Repository oder ein Host
Lassen Sie innerhalb eines Repositorys --global weg, dann gilt die Einstellung nur für
dieses Repository:
git config http.proxy http://LOGIN:PASSWORD@HOST:PORT
Um den Proxy auf einen Host zu beschränken, setzen Sie den Host in den Schlüssel:
git config --global http.https://example.com.proxy http://LOGIN:PASSWORD@HOST:PORT
Umgebungsvariablen
Git liest außerdem http_proxy, https_proxy und all_proxy aus der Shell sowie die
Liste no_proxy mit den Hosts, die übersprungen werden. Ist der Konfigurationsschlüssel
gesetzt, hat er Vorrang vor ihnen.
Welchen Geltungsbereich wählen
Eine globale Einstellung ist am einfachsten, schickt aber jeden http- und https-Remote
durch den Proxy, auch interne Server, die der Proxy nicht erreicht. Tritt das auf,
beschränken Sie den Proxy auf einen Host oder ein Repository oder tragen interne Hosts in
no_proxy ein. Ein Schlüssel pro Host ist die sicherste Wahl, wenn nur ein Remote den
Proxy braucht.
Entfernen
git config --global --unset http.proxy
Gut zu wissen
- Das Passwort liegt im Klartext in Ihrer Git-Konfigurationsdatei. Halten Sie die Datei privat und committen Sie sie nicht.
- SSH-Remotes (
git@host:...) ignorierenhttp.proxy. - Ein 407 bei
git cloneheißt, dass der Proxy den Login abgelehnt hat: Proxy-Fehler 407 nennt die Prüfschritte, und Proxy-Authentifizierung fehlgeschlagen behandelt den Allowlist-Modus. - Nutzen Sie den Proxy nur für Repositories, auf die Sie zugreifen dürfen, wie es die Richtlinie zur zulässigen Nutzung verlangt. Die Tarife stehen auf der Seite ISP Proxys.
