Aktiver Nodes innebygde proxy-støtte ved oppstart

Bruk Nodes miljøproxysvitsj med de riktige versjonstersklene for fetch og http/https, og forstå klientomfanget.

Node kan selv lese proxy-miljøvariabler når den innebygde støtten er aktivert ved prosessoppstart. Tilgjengelige klienter avhenger av runtime-versjonen:

  • Innebygd fetch støtter NODE_USE_ENV_PROXY fra Node 24.0.0, med en backport til 22.21.0.
  • Innebygd node:http- og node:https-støtte via deres standard globale agenter starter ved 24.5.0, også backportet til 22.21.0.
  • Kommandolinjesvitsjen --use-env-proxy starter ved 24.5.0 og 22.21.0.

På en kompatibel utgivelse setter dette POSIX-shell-eksemplet én bedrifts-HTTP-proxy for begge destinasjonsskjemaene:

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

Navnet HTTPS_PROXY velger ruten for HTTPS-destinasjoner; URL-en kan fortsatt navngi en HTTP-proxy. Juster NO_PROXY til destinasjonene som skal omgå den. For en uavhengig offentlig-URL-test uten proxykonto kan en HTTP-oppføring fra HTTP-proxylisten levere begge proxyverdiene mens de nødvendige interne omgåelsene beholdes.

Miljøsvitsjformen er et alternativ:

export NODE_USE_ENV_PROXY=1
node app.js

Angi rutingvariablene før du starter Node med en av formene. Å tilordne opt-in-flagget til process.env etter oppstart kjører ikke oppstartsinitialiseringen på nytt.

Kontroller hvilken HTTP-klient som faktisk brukes

Standard globale agenter er relevante for http- og https-kall som bruker dem. Et bibliotek med sin egen tilpassede agent eller dispatcher styrer sin egen transport; rå TCP-sokler er utenfor denne HTTP-rutingfunksjonen. For en kompatibel Undici-klient er en eksplisitt ProxyAgent-dispatcher et separat klientlokalt grensesnitt.

Hvis en applikasjon erstatter en global agent, undersøk den erstatningen før du antar at den beholder oppstartsproxyatferden. På samme måte er npms registerkonfigurasjon en separat verktøyinnstilling og beviser ikke hvordan app.js ruter forespørsler.

For et bedriftskrav om TLS-tillit, konfigurer den riktige klarerte CA-en for runtime. Aktivering av proxy-ruting krever ikke at sertifikatvalidering deaktiveres.

Relaterte artikler