Changer de langue
Français English Русский Deutsch Español Italiano Українська Tiếng Việt Türkçe Bahasa Indonesia हिन्दी 日本語 Português 中文
Menu
Tarifs
Proxys
TYPES DE PROXY
Solutions
Ressources

Configurer un proxy dans Git

Sujet: Configuration par appareil et appli Toutes les réponses

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:...) ignorent http.proxy.
  • Un 407 renvoyé par git clone signifie 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.

Réponses rapides sur Git et les proxys

Le proxy s'applique-t-il aux dépôts distants en git@ ?

Non. http.proxy agit sur les dépôts distants en http et https. Un dépôt en git@ passe par SSH, qui a son propre réglage de proxy.

Comment utiliser le proxy pour un seul hôte ?

Ajoutez l'hôte à la clé : git config --global http.https://example.com.proxy http://HOST:PORT, en remplaçant example.com par votre propre hôte.

Comment voir ce que Git envoie ?

Lancez la commande avec GIT_CURL_VERBOSE=1 devant. La sortie affiche la requête CONNECT envoyée à votre proxy.

Pages liées