Cómo configurar un proxy en Git
En resumen: 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.
Git se comunica con los remotos http y https a través de libcurl, así que sigue las mismas reglas de proxy que curl. Toma el host, el puerto, el usuario y la contraseña de una fila de Mis Proxies en tu panel.
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 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:...) ignoranhttp.proxy. - Un 407 en
git clonesignifica que el proxy rechazó el inicio de sesión: el error 407 del proxy enumera las comprobaciones, y la autenticación del proxy fallida 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. Los planes están en la página de proxies ISP.
