Configurando un proxy para npm, yarn y p

Configuración de Proxies para npm, yarn y pnpm

Introducción

Los gestores de paquetes de Node.js (npm, yarn, pnpm) descargan paquetes del registro de npm. En una red corporativa o al usar un proxy para el anonimato, es necesario configurar un proxy para que estos gestores de paquetes funcionen correctamente.

Configuración Básica

npm

npm config set proxy http://proxy_ip:port
npm config set https-proxy http://proxy_ip:port

Con autenticación:
npm config set proxy http://user:pass@proxy_ip:port

Verificación:
npm config get proxy

Eliminación:
npm config delete proxy
npm config delete https-proxy

yarn

yarn config set proxy http://proxy_ip:port
yarn config set https-proxy http://proxy_ip:port

pnpm

pnpm config set proxy http://proxy_ip:port
pnpm config set https-proxy http://proxy_ip:port

Alternativamente, a través de variables de entorno: HTTP_PROXY, HTTPS_PROXY — esto funciona para los tres gestores.

Configuración Avanzada

Variables de Entorno

La mayoría de las herramientas soportan variables de entorno estándar para proxies:
- HTTP_PROXY / http_proxy — proxy para solicitudes HTTP
- HTTPS_PROXY / https_proxy — proxy para solicitudes HTTPS
- NO_PROXY / no_proxy — lista de exclusiones (direcciones que omiten el proxy)
- ALL_PROXY / all_proxy — proxy para todos los protocolos

SSL y Certificados Auto-Firmados

Los proxies corporativos a menudo usan sus propios certificados SSL. Para trabajar a través de ellos, necesita:
1. Obtener el certificado CA del proxy del administrador
2. Añadirlo al almacén de certificados de su sistema
3. O deshabilitar la verificación SSL (solo para pruebas)

Autenticación

Se soportan dos métodos principales de autenticación:

Nombre de usuario y Contraseña — autenticación HTTP Basic estándar. Las credenciales se envían con cada solicitud. Formato de URL: http://user:pass@proxy_ip:port

Por Dirección IP (lista blanca) — su IP se añade a una lista blanca. No es necesario enviar credenciales.

Verificación de la Configuración

Después de la configuración, verifique:
1. Realice una solicitud de prueba a través del proxy
2. Asegúrese de que su dirección IP ha cambiado
3. Compruebe la velocidad de conexión
4. Confirme que no hay fugas de DNS

Solución de Problemas

El Proxy Falla al Conectarse

• Verifique la dirección y el puerto para su corrección
• Asegúrese de que su firewall no esté bloqueando la conexión
• Verifique la accesibilidad del proxy desde su red

Errores SSL

• Para proxies corporativos, añada el certificado CA
• Para pruebas, deshabilite temporalmente la verificación SSL
• Actualice las bibliotecas SSL a la última versión

Errores de Autenticación

• Verifique su nombre de usuario y contraseña
• Asegúrese de que el formato de las credenciales sea correcto
• Intente codificar URL los caracteres especiales en la contraseña

Mejores Prácticas

1. Use variables de entorno — para flexibilidad y seguridad
2. Evite codificar credenciales — use variables de entorno o archivos de configuración
3. Configure exclusiones — no use proxy para localhost y direcciones internas
4. Documente la configuración — en el README de su proyecto o en la wiki del equipo
5. Pruebe después de los cambios — cualquier cambio de configuración requiere verificación

Conclusión

Una configuración de proxy correcta asegura un funcionamiento estable de la herramienta y conexiones seguras. Siga las recomendaciones de esta guía y siempre verifique la funcionalidad después de la configuración.