# Git proxy config: http.proxy y socks5h | ProxyJam

Git proxy config: define un proxy HTTP o SOCKS5 con git config http.proxy, por host o por repositorio, con usuario y contraseña, y cómo quitarlo.

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

Ejecuta git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT para enviar Git por un proxy HTTP, o usa socks5h://HOST:PORT para SOCKS5. Solo cubre los remotos http y https, no los SSH. Quítalo con git config --global --unset http.proxy. Las credenciales quedan en texto plano en tu archivo de configuración de Git.


## Respuestas rápidas sobre Git y los proxies

### ¿El proxy se aplica a los remotos git@?

No. http.proxy afecta a los remotos http y https. Un remoto git@ funciona por SSH, que tiene su propio ajuste de proxy.

### ¿Cómo uso el proxy solo para un host?

Añade el host a la clave: git config --global http.https://example.com.proxy http://HOST:PORT, con tu propio host en lugar de example.com.

### ¿Cómo veo lo que envía Git?

Ejecuta el comando con GIT_CURL_VERBOSE=1 por delante. La salida muestra la petición CONNECT a tu proxy.



Git se comunica con los remotos http y https a través de libcurl, así que sigue las mismas
reglas de proxy que [curl](/es/faq/curl-proxy/). Toma el host, el puerto, el usuario y la
contraseña de una fila de **Mis Proxies** en tu [panel](https://app.proxyjam.com).

## Configúralo para todos tus repositorios

```
git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT
```

Esto escribe una línea en `~/.gitconfig`. Un solo ajuste cubre los remotos http y https.
Compruébalo con `git config --get http.proxy`.

Si tu pedido es SOCKS5, cámbialo con **Cambiar protocolo**, copia de nuevo los datos y usa:

```
git config --global http.proxy socks5h://LOGIN:PASSWORD@HOST:PORT
```

La `h` hace que el proxy resuelva los nombres de host. Consulta la página de
[proxies SOCKS5](/es/socks5-proxies/) para conocer el protocolo.

## Codifica los caracteres especiales

El usuario va dentro de una URL, así que `@` se escribe `%40`, `:` como `%3A`, `/` como
`%2F`, `#` como `%23` y `%` como `%25`. Una contraseña sin codificar se corta y el proxy
responde 407.

## Un repositorio o un host

Quita `--global` dentro de un repositorio para aplicarlo solo a ese repositorio:

```
git config http.proxy http://LOGIN:PASSWORD@HOST:PORT
```

Para limitar el proxy a un host, pon el host en la clave:

```
git config --global http.https://example.com.proxy http://LOGIN:PASSWORD@HOST:PORT
```

## Variables de entorno

Git también lee `http_proxy`, `https_proxy` y `all_proxy` del shell, además de la lista
`no_proxy` con los hosts que se deben omitir. Si la clave de configuración está definida,
tiene prioridad sobre ellas.

## Qué ámbito usar

Un ajuste global es lo más sencillo, pero envía por el proxy todos los remotos http y https,
incluidos los servidores internos a los que el proxy no llega. Si te pasa eso, limita el
proxy a un host o a un repositorio, o indica los hosts internos en `no_proxy`. Una clave por
host es la opción más segura cuando solo un remoto necesita el proxy.

## Quitarlo

```
git config --global --unset http.proxy
```

## Qué conviene saber

- La contraseña se guarda en texto plano en tu archivo de configuración de Git. Mantén ese
  archivo en privado y no lo subas al repositorio.
- Los remotos SSH (`git@host:...`) ignoran `http.proxy`.
- Un 407 en `git clone` significa que el proxy rechazó el inicio de sesión:
  [el error 407 del proxy](/es/faq/proxy-error-407/) enumera las comprobaciones, y
  [la autenticación del proxy fallida](/es/faq/proxy-authentication-failed/) trata el modo
  de lista de IP permitidas.
- Usa el proxy solo para repositorios a los que tengas derecho de acceso, como exige la
  [Política de Uso Aceptable](/es/acceptable-use-policy/). Los planes están en la página de
  [proxies ISP](/es/isp-proxies/).

