Aktiver den innebygde proxy-støtta til Node ved oppstart

Bruk miljøproxysvitsjen til Node med dei rette versjonstersklane for fetch og http/https, og forstå klientomfanget.

Node kan sjølv lese proxy-miljøvariablar når den innebygde støtta er aktivert ved prosessoppstart. Tilgjengelege klientar avheng av runtime-versjonen:

  • Innebygd fetch støttar NODE_USE_ENV_PROXY frå Node 24.0.0, med ein backport til 22.21.0.
  • Innebygd node:http- og node:https-støtte via dei standard globale agentane deira startar ved 24.5.0, også backporta til 22.21.0.
  • Kommandolinjesvitsjen --use-env-proxy startar ved 24.5.0 og 22.21.0.

På ein kompatibel utgiving set dette POSIX-shell-dømet éin bedrifts-HTTP-proxy for begge destinasjonsskjema:

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 vel ruta for HTTPS-destinasjonar; URL-en kan framleis nemne ein HTTP-proxy. Juster NO_PROXY til destinasjonane som skal omgå han. For ein uavhengig offentleg-URL-test utan proxykonto kan ein HTTP-oppføring frå HTTP-proxylista levera begge proxyverdiane medan dei nødvendige interne omgåingane blir haldne.

Miljøsvitsjforma er eit alternativ:

export NODE_USE_ENV_PROXY=1
node app.js

Set rutingsvariablane før du startar Node med nokon av formene. Å tilordne opt-in-flagg til process.env etter oppstart køyrer ikkje oppstartsinitialiseringa på nytt.

Kontroller kva HTTP-klient som faktisk blir brukt

Dei standard globale agentane er relevante for http- og https-kall som brukar dei. Eit bibliotek med sin eigen tilpassa agent eller dispatcher styrer sin eigen transport; rå TCP-soklar er utanfor denne HTTP-rutingfunksjonen. For ein kompatibel Undici-klient er ein eksplisitt ProxyAgent-dispatcher eit separat klientlokalt grensesnitt.

Viss ein applikasjon erstattar ein global agent, undersøk den erstatninga før du antar at ho held på oppstartsproxyåtferda. På same måte er registerkonfigurasjonen til npm ei separat verktøyinnstilling og beviser ikkje korleis app.js ruter førespurnader.

For eit bedriftskrav om TLS-tillit, konfigurer den rette klarerte CA-en for runtime. Aktivering av proxy-ruting krev ikkje at sertifikatvalidering blir deaktivert.

Relaterte artiklar