¿Te ha pasado esto a causa del proxy?
Don’t worry! No eres el primero ni el último al que el proxy le arruina el día 🙃. Pero hoy te enseñaré a domarlo, incluso si es tu primera vez. ¿Listo para dejar de pelearte con la red corporativa o universitaria? Let’s Go!
🌐 Proxy: El «Intermediario» Que Te Está Bloqueando (y Cómo Hacerlo Tu Aliado)
Imagina que quieres pedir una pizza 🍕, pero tu edificio tiene un portero que solo deja pasar pedidos si les das tu nombre y clave. El proxy es ese portero: sin la info correcta, npm, Git y otros no pueden «traerte» nada de internet.
¿Para qué configurarlo?
- npm: Para instalar paquetes (lodash, react, etc.).
- nvm: Para cambiar versiones de Node.js.
- Git: Para clonar repositorios o subir tu código.

🛠️ Configuración Paso a Paso
1. npm
Problema común:
npm ERR! network timeout at: https://registry.npmjs.org/react
Solución:
Abre tu terminal y escribe (sustituye con tus datos):
# Si tu proxy NO pide usuario/contraseña (ej: universidad):
npm config set proxy http://proxy.uc.edu.ve:8080
npm config set https-proxy http://proxy.uc.edu.ve:8080
# Si SÍ requiere credenciales (ej: empresa "TechCorp"):
npm config set proxy http://juan:Pass2023@proxy.techcorp.com:8080
npm config set https-proxy http://juan:Pass2023@proxy.techcorp.com:8080
✅ Verifica que funcionó:
npm config get proxy
# Deberías ver tu URL configurada.
💡 Tip para Windows: Si tu contraseña tiene @ o #, envuélvela en comillas:
npm config set proxy "http://juan:P@ssw%23rd@proxy.techcorp.com:8080"
2. nvm
Problema común:
Could not retrieve https://nodejs.org/dist/v18.16.0/node-v18.16.0.tar.gz
Solución:
- En Linux/macOS:
export HTTP_PROXY=http://usuario:contraseña@proxy:puerto<br>export HTTPS_PROXY=http://usuario:contraseña@proxy:puerto<br>nvm install 18 # ¡Ahora sí debería funcionar!
- En Windows (PowerShell):
$env:HTTP_PROXY = "http://maria:S3gur@2023@proxy.empresa.com:8080"
$env:HTTPS_PROXY = "http://maria:S3gur@2023@proxy.empresa.com:8080"
nvm use 16 # Prueba con otra versión
⚠️ Atención: Estas variables son temporales. Si reinicias la terminal, se borran. ¿Quieres que sean permanentes? Agrégalas a tu archivo .bashrc (Linux/macOS) o variables de entorno del sistema (Windows).
3. Git
Problema común:
fatal: unable to access 'https://github.com/usuario/repo.git/': Failed to connect to github.com port 443: Timed out
Solución:
# Configura proxy para TODOS tus repos (global):
git config --global http.proxy http://proxy.empresa.com:8080
git config --global https.proxy http://proxy.empresa.com:8080
# Si requiere autenticación:
git config --global http.proxy http://luis:GitPass2023@10.0.0.4:8080
🔄 ¿Usas varios proxies? Configura solo un repositorio:
cd ruta/al/repo
git config http.proxy http://proxy.otraempresa.com:8080
🔓 Remover configuración:
git config --global --unset http.proxy
git config --global --unset https.proxy
🚨 Errores Comunes (y Cómo Evitarlos)
- «407 Proxy Authentication Required»
- Causa: Tu usuario/contraseña están mal.
- Solución: Verifica que no haya typos. Si usas
@
en la contraseña, reemplázala por%40
(ej: P@ss → P%40ss).
- Todo funciona en la oficina, pero no en casa
- Causa: Olvidaste quitar el proxy.
- Solución: Ejecuta los comandos
npm config rm proxy
ygit config --global --unset http.proxy
.
- npm funciona, pero Git sigue fallando
- Causa: Configuraste solo uno de los dos.
- Solución: ¡Revisa ambas configuraciones!
🎉 Conclusión: Tú vs. Proxy → ¡Tú Ganas!
Configurar un proxy puede parecer abrumador al principio, pero con estos pasos, recuperarás el control de tu entorno de desarrollo. Ya seas un principiante que está aprendiendo a manejar herramientas clave o un experimentado que trabaja en entornos restringidos, dominar estas configuraciones te ahorrará horas de frustración.
¿Sigues bloqueado? Déjame un comentario con tu error y te ayudo 🚀
Y si te sirvió esta guía, compártela con ese compañero que lleva horas peleando con el proxy… (seguro le salvas el día 😉)
¿Qué tema te gustaría ver en el próximo post?
(Escribelo en los comentarios 🗳️)
Sigueme en mis redes sociales para más contenido