Activa a compatibilidade de proxy integrada de Node ao iniciar

Use o interruptor de proxy de ambiente de Node cos limiares de versión correctos de fetch e http/https e comprenda o seu alcance de cliente.

Node pode ler por si mesmo as variables de ambiente de proxy cando a súa compatibilidade integrada se habilita ao iniciar o proceso. Os clientes dispoñibles dependen da versión do runtime:

  • O fetch integrado admite NODE_USE_ENV_PROXY desde Node 24.0.0, cunha retroportación a 22.21.0.
  • A compatibilidade integrada de node:http e node:https a través dos seus axentes globais predeterminados comeza en 24.5.0, tamén retroportada a 22.21.0.
  • O interruptor de liña de ordes --use-env-proxy comeza en 24.5.0 e 22.21.0.

Nunha versión compatible, este exemplo de POSIX-shell establece un proxy HTTP corporativo para ambos os 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

O nome HTTPS_PROXY selecciona a ruta para os destinos HTTPS; a URL aínda pode nomear un proxy HTTP. Axuste NO_PROXY aos destinos que deben evitalo. Para unha proba independente de URL pública sen conta de proxy, unha entrada HTTP da lista de proxies HTTP pode proporcionar ambos os valores de proxy mentres se manteñen os desvíos internos necesarios.

A forma de interruptor de ambiente é unha alternativa:

export NODE_USE_ENV_PROXY=1
node app.js

Estableza as variables de enrutamento antes de iniciar Node con calquera das dúas formas. Asignar o indicador de activación a process.env despois do inicio non volve executar a inicialización de inicio.

Comprobe que cliente HTTP se usa realmente

Os axentes globais predeterminados son relevantes para as chamadas http e https que os usan. Unha biblioteca co seu propio axente ou despachador personalizado controla o seu propio transporte; os sockets TCP sen procesar quedan fóra desta función de enrutamento HTTP. Para un cliente Undici compatible, un despachador ProxyAgent explícito é unha interface separada local ao cliente.

Se unha aplicación substitúe un axente global, inspeccione esa substitución antes de supoñer que conserva o comportamento de proxy de inicio. Do mesmo xeito, a configuración do rexistro de npm é un axuste de ferramenta aparte e non demostra como app.js enruta as solicitudes.

Para un requisito corporativo de confianza TLS, configure a CA de confianza axeitada para o runtime. Habilitar o enrutamento de proxy non require desactivar a verificación de certificados.

Artigos relacionados