npm y yarn detrás de un proxy

Los gestores de paquetes descargan a través de HTTPS, por lo que necesitan un proxy HTTP CONNECT — que es exactamente el endpoint HTTP s4m en el puerto 3128. npm mantiene su propia configuración, por lo que establecer las variables de entorno del shell no siempre es suficiente; generalmente se configuran tanto proxy como https-proxy en la configuración de npm para que el tráfico del registro sea dirigido. Las dos generaciones de Yarn difieren: el yarn clásico v1 lee su propia configuración de proxy / https-proxy (y en gran medida respeta la de npm), mientras que Yarn Berry (v2+) utiliza las claves httpProxy y httpsProxy en .yarnrc.yml.

En todos ellos, también se respetan las variables de entorno estándar http_proxy, https_proxy y no_proxy, que es la forma más rápida de solucionar una instalación única de npm install en una máquina restringida. Con s4m te autenticas con USER:PASS contra proxy.s4m.online:3128. Consulta la página del proxy y la guía compartida de variables de entorno; la guía hermana de pip y conda cubre el equivalente en Python.

Dos cosas rompen las instalaciones incluso después de que se establece el proxy. Primero, caracteres especiales en la contraseña: si contiene @, : o #, codifícalos en URL (por ejemplo, @ se convierte en %40) o la configuración analiza la URL incorrectamente. Segundo, una mezcla de registros públicos y privados: coloca cualquier host de registro interno en noproxy para que se acceda directamente, mientras que el registro público de npm pasa a través del proxy.

El punto final HTTP de s4m es un proxy de centro de datos autenticado, con pago por uso — una opción limpia para los ejecutores de CI y las máquinas de desarrollo que deben acceder a npm desde detrás de una salida controlada. No es un proxy residencial y no es un caché de paquetes; para instalaciones fuera de línea utiliza un espejo de registro real. Cuando tu CI necesita una única IP de salida permitida, añade una IP personal dedicada. Un 407 significa credenciales incorrectas — consulta la guía 407. El mismo punto final alimenta pip/conda y Docker; valídalo con las herramientas.