# Git proxy : configurer http.proxy et socks5h | ProxyJam

Git proxy : réglez un proxy HTTP ou SOCKS5 avec git config http.proxy, par hôte ou par dépôt, avec identifiant et mot de passe, et retirez-le.

- Canonical: https://proxyjam.com/fr/faq/git-proxy-config/
- Updated: 2026-11-18
- Language: fr

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.


## 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.



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](/fr/faq/curl-proxy/). Prenez l'hôte, le port, l'identifiant et le mot de passe
sur une ligne de **Mes Proxies** dans votre [tableau de bord](https://app.proxyjam.com).

## 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](/fr/socks5-proxies/).

## 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](/fr/faq/proxy-error-407/) énumère les vérifications, et
  [l'échec d'authentification du proxy](/fr/faq/proxy-authentication-failed/) 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](/fr/acceptable-use-policy/). Les offres figurent sur
  la page des [proxys ISP](/fr/isp-proxies/).

