Aktivera Nodes inbyggda proxy-stöd vid start

Använd Nodes miljöproxyväxel med rätt versionströsklar för fetch och http/https och förstå dess klientomfattning.

Node kan själv läsa proxy-miljövariabler när dess inbyggda stöd aktiveras vid processstart. Tillgängliga klienter beror på runtime-versionen:

  • Inbyggd fetch stöder NODE_USE_ENV_PROXY från Node 24.0.0, med en backport till 22.21.0.
  • Inbyggt node:http- och node:https-stöd via deras standardglobala agenter börjar vid 24.5.0, även backportat till 22.21.0.
  • Kommandoradsväxeln --use-env-proxy börjar vid 24.5.0 och 22.21.0.

På en kompatibel utgåva ställer detta POSIX-shell-exempel in en företags-HTTP-proxy för båda målschemana:

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

Namnet HTTPS_PROXY väljer vägen för HTTPS-mål; URL:en kan fortfarande ange en HTTP-proxy. Justera NO_PROXY till de mål som ska kringgå den. För ett oberoende offentlig-URL-test utan proxykonto kan en HTTP-post från HTTP-proxylistan leverera båda proxyvärdena medan de nödvändiga interna kringgåendena behålls.

Miljöväxelformen är ett alternativ:

export NODE_USE_ENV_PROXY=1
node app.js

Ange routingvariablerna innan du startar Node med någon av formerna. Att tilldela opt-in-flaggan till process.env efter start kör inte om startinitieringen.

Kontrollera vilken HTTP-klient som faktiskt används

Standardglobala agenter är relevanta för http- och https-anrop som använder dem. Ett bibliotek med egen anpassad agent eller dispatcher styr sin egen transport; råa TCP-sockets ligger utanför denna HTTP-routningsfunktion. För en kompatibel Undici-klient är en explicit ProxyAgent-dispatcher ett separat klientlokalt gränssnitt.

Om ett program ersätter en global agent, granska den ersättningen innan du antar att den behåller startproxybeteendet. På samma sätt är npms registerkonfiguration en separat verktygsinställning och bevisar inte hur app.js dirigerar förfrågningar.

För ett företagskrav på TLS-förtroende konfigurerar du rätt betrodd CA för runtime. Att aktivera proxy-routning kräver inte att certifikatvalidering inaktiveras.

Relaterade artiklar