Aktivér Nodes indbyggede proxyunderstøttelse ved opstart

Brug Nodes miljøproxyskift med de korrekte versionstærskler for fetch og http/https, og forstå dens klientomfang.

Node kan selv læse proxy-miljøvariabler, når dens indbyggede understøttelse er aktiveret ved processtart. De tilgængelige klienter afhænger af runtime-versionen:

  • Indbygget fetch understøtter NODE_USE_ENV_PROXY fra Node 24.0.0, med en backport til 22.21.0.
  • Indbygget node:http- og node:https-understøttelse via deres standard globale agenter begynder ved 24.5.0, også backportet til 22.21.0.
  • Kommandolinjeskiftet --use-env-proxy begynder ved 24.5.0 og 22.21.0.

På en kompatibel udgivelse sætter dette POSIX-shell-eksempel én virksomheds-HTTP-proxy for begge destinationsskemaer:

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 vælger ruten for HTTPS-destinationer; URL'en kan stadig angive en HTTP-proxy. Juster NO_PROXY til de destinationer, der skal omgå den. Til en uafhængig offentlig-URL-test uden proxykonto kan en HTTP-post fra HTTP-proxylisten levere begge proxyværdier, mens de krævede interne omgåelser bevares.

Miljøskiftformen er et alternativ:

export NODE_USE_ENV_PROXY=1
node app.js

Indstil routingvariablerne, før du starter Node med en af formerne. Tildeling af opt-in-flaget til process.env efter start kører ikke startinitialiseringen igen.

Kontrollér, hvilken HTTP-klient der faktisk bruges

Standard-globalagenterne er relevante for http- og https-kald, der bruger dem. Et bibliotek med sin egen brugerdefinerede agent eller dispatcher styrer sin egen transport; rå TCP-sockets er uden for denne HTTP-routingfunktion. For en kompatibel Undici-klient er en eksplicit ProxyAgent-dispatcher en separat klientlokal grænseflade.

Hvis en applikation erstatter en global agent, skal du undersøge den erstatning, før du antager, at den bevarer opstartsproxyadfærden. Tilsvarende er npms registreringskonfiguration en separat værktøjsindstilling og beviser ikke, hvordan app.js ruter anmodninger.

Til et virksomhedskrav om TLS-tillid skal du konfigurere den relevante betroede CA til runtime. Aktivering af proxy-routing kræver ikke, at certifikatvalidering deaktiveres.

Relaterede artikler