Activar la compatibilidad de proxy integrada de Node al iniciar

Use el interruptor de proxy de entorno de Node con los umbrales de versión correctos de fetch y http/https y comprenda su alcance de cliente.

Node puede leer por sí mismo las variables de entorno de proxy cuando su compatibilidad integrada se habilita al iniciar el proceso. Los clientes disponibles dependen de la versión del runtime:

  • El fetch integrado admite NODE_USE_ENV_PROXY desde Node 24.0.0, con una retroportación a 22.21.0.
  • La compatibilidad integrada de node:http y node:https a través de sus agentes globales predeterminados comienza en 24.5.0, también retroportada a 22.21.0.
  • El interruptor de línea de comandos --use-env-proxy comienza en 24.5.0 y 22.21.0.

En una versión compatible, este ejemplo de POSIX-shell establece un proxy HTTP corporativo para ambos esquemas de destino:

export HTTP_PROXY=http://proxy.example.net:8080
export HTTPS_PROXY=http://proxy.example.net:8080
export NO_PROXY=localhost,127.0.0.1,.internal.example

node --use-env-proxy app.js

El nombre HTTPS_PROXY selecciona la ruta para los destinos HTTPS; la URL aún puede nombrar un proxy HTTP. Ajuste NO_PROXY a los destinos que deben evitarlo. Para una prueba independiente de URL pública sin cuenta de proxy, una entrada HTTP de la lista de proxies HTTP puede proporcionar ambos valores de proxy mientras se mantienen los desvíos internos necesarios.

La forma de interruptor de entorno es una alternativa:

export NODE_USE_ENV_PROXY=1
node app.js

Establezca las variables de enrutamiento antes de iniciar Node con cualquiera de las dos formas. Asignar el indicador de activación a process.env después del inicio no vuelve a ejecutar la inicialización de inicio.

Compruebe qué cliente HTTP se usa realmente

Los agentes globales predeterminados son relevantes para las llamadas http y https que los usan. Una biblioteca con su propio agente o despachador personalizado controla su propio transporte; los sockets TCP sin procesar quedan fuera de esta función de enrutamiento HTTP. Para un cliente Undici compatible, un despachador ProxyAgent explícito es una interfaz separada local al cliente.

Si una aplicación reemplaza un agente global, inspeccione ese reemplazo antes de suponer que conserva el comportamiento de proxy de inicio. Del mismo modo, la configuración del registro de npm es un ajuste de herramienta aparte y no demuestra cómo enruta app.js las solicitudes.

Para un requisito corporativo de confianza TLS, configure la CA de confianza adecuada para el runtime. Habilitar el enrutamiento de proxy no requiere desactivar la verificación de certificados.

Artículos relacionados