Configurer un proxy dans Git
En bref : Lancez git config –global http.proxy http://LOGIN:PASSWORD@HOST:PORT pour faire passer Git par un proxy HTTP, ou utilisez socks5h://HOST:PORT pour SOCKS5. Cela ne couvre que les dépôts distants en http et https, pas ceux en SSH. Retirez-le avec git config –global –unset http.proxy. Les identifiants sont enregistrés en clair dans votre fichier de configuration Git.
Git joint les dépôts distants en http et https par libcurl : il suit donc les mêmes règles de proxy que curl. Prenez l’hôte, le port, l’identifiant et le mot de passe sur une ligne de Mes Proxies dans votre tableau de bord.
Le régler pour tous vos dépôts
git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT
Cela écrit une seule ligne dans ~/.gitconfig. Un seul réglage couvre les dépôts distants en
http comme en https. Vérifiez-le avec git config --get http.proxy.
Pour une commande en SOCKS5, basculez-la avec Changer le protocole, recopiez les informations et utilisez :
git config --global http.proxy socks5h://LOGIN:PASSWORD@HOST:PORT
Le h fait résoudre les noms d’hôte par le proxy. Pour le protocole, voir la page
Proxys SOCKS5.
Encoder les caractères spéciaux
L’identifiant se trouve dans une URL : @ doit donc s’écrire %40, : s’écrit %3A, /
s’écrit %2F, # s’écrit %23 et % s’écrit %25. Un mot de passe non encodé est tronqué
et le proxy répond 407.
Un seul dépôt ou un seul hôte
Retirez --global dans un dépôt pour ne régler le proxy que pour ce dépôt :
git config http.proxy http://LOGIN:PASSWORD@HOST:PORT
Pour limiter le proxy à un seul hôte, mettez l’hôte dans la clé :
git config --global http.https://example.com.proxy http://LOGIN:PASSWORD@HOST:PORT
Variables d’environnement
Git lit aussi http_proxy, https_proxy et all_proxy dans le shell, ainsi que la liste
no_proxy des hôtes à exclure. La clé de configuration, quand elle est définie, l’emporte sur
elles.
Quelle portée choisir
Un réglage global est le plus simple, mais il fait passer par le proxy tous les dépôts
distants en http et https, y compris les serveurs internes que le proxy ne peut pas joindre. Si
vous tombez sur ce cas, limitez le proxy à un hôte ou à un dépôt, ou listez les hôtes internes
dans no_proxy. Une clé par hôte est le choix le plus sûr quand un seul dépôt distant a besoin
du proxy.
Le retirer
git config --global --unset http.proxy
À savoir
- Le mot de passe est enregistré en clair dans votre fichier de configuration Git. Gardez ce fichier privé et ne le versionnez pas.
- Les dépôts distants en SSH (
git@host:...) ignorenthttp.proxy. - Un 407 renvoyé par
git clonesignifie que le proxy a refusé l’identifiant : l’erreur proxy 407 énumère les vérifications, et l’échec d’authentification du proxy traite du mode liste d’IP autorisées. - N’utilisez le proxy que pour les dépôts auxquels vous avez le droit d’accéder, comme l’exige la Politique d’utilisation acceptable. Les offres figurent sur la page des proxys ISP.
