¿Te ha pasado esto a causa del proxy?

npm install se queda cargando eternamente…
git clone te muestra un error críptico de conexión.
nvm se niega a instalar esa versión de Node.js que tanto necesitas.

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.
Si no configuras el proxy Errores de conexión por doquier

🛠️ 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)

  1. «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).
  2. Todo funciona en la oficina, pero no en casa
    • Causa: Olvidaste quitar el proxy.
    • Solución: Ejecuta los comandos npm config rm proxy y git config --global --unset http.proxy.
  3. 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?

Debugging en Node.js como un pro.
Configurar SSH para Git sin contraseñas.
Otro.

(Escribelo en los comentarios 🗳️)


Avatar de darkusphantom

Sigueme en mis redes sociales para más contenido


darkusphantom Programación , , , , ,

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *