Activa el suport de servidor intermedi integrat de Node a l'inici

Utilitza l'interruptor de servidor intermedi d'entorn de Node amb els llindars de versió correctes de fetch i http/https i entén l'abast del client.

Node pot llegir les variables d'entorn del servidor intermedi per si mateix quan el seu suport integrat s'activa a l'inici del procés. Els clients disponibles depenen de la versió del runtime:

  • El fetch integrat admet NODE_USE_ENV_PROXY des de Node 24.0.0, amb una retroportació a 22.21.0.
  • El suport integrat de node:http i node:https mitjançant els seus agents globals per defecte comença a 24.5.0, també retroportat a 22.21.0.
  • L'interruptor de línia d'ordres --use-env-proxy comença a 24.5.0 i 22.21.0.

En una versió compatible, aquest exemple de POSIX-shell defineix un servidor intermedi HTTP corporatiu per a tots dos esquemes de destinació:

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 nom HTTPS_PROXY selecciona la ruta per a les destinacions HTTPS; l'URL encara pot indicar un servidor intermedi HTTP. Ajusta NO_PROXY a les destinacions que l'han d'evitar. Per a una prova independent d'URL pública sense compte de servidor intermedi, una entrada HTTP de la llista de servidors intermedi HTTP pot proporcionar els dos valors de servidor intermedi mentre es mantenen els desviaments interns necessaris.

La forma d'interruptor d'entorn és una alternativa:

export NODE_USE_ENV_PROXY=1
node app.js

Defineix les variables d'encaminament abans d'iniciar Node amb qualsevol de les dues formes. Assignar el senyalador d'activació a process.env després de l'inici no torna a executar la inicialització d'inici.

Comprova quin client HTTP s'utilitza realment

Els agents globals per defecte són rellevants per a les crides http i https que els utilitzen. Una biblioteca amb el seu propi agent o distribuïdor personalitzat controla el seu propi transport; els sòcols TCP en brut queden fora d'aquesta funció d'encaminament HTTP. Per a un client Undici compatible, un distribuïdor ProxyAgent explícit és una interfície separada local al client.

Si una aplicació substitueix un agent global, inspecciona aquesta substitució abans de suposar que conserva el comportament del servidor intermedi d'inici. De la mateixa manera, la configuració del registre d'npm és un paràmetre d'eina separat i no demostra com app.js encamina les sol·licituds.

Per a un requisit corporatiu de confiança TLS, configura el CA de confiança adequat per al runtime. Activar l'encaminament del servidor intermedi no requereix desactivar la verificació de certificats.

Articles relacionats