Omogočite vgrajeno podporo za proxy v Nodeu ob zagonu

Uporabite Nodeov stikalo za proxy okolja s pravilnimi pragovi različic fetch in http/https in razumejte njegov obseg odjemalcev.

Node lahko sam bere spremenljivke okolja proxy, ko je njegova vgrajena podpora omogočena ob zagonu procesa. Razpoložljivi odjemalci so odvisni od različice runtime:

  • Vgrajeni fetch podpira NODE_USE_ENV_PROXY od Node 24.0.0, z backportom v 22.21.0.
  • Vgrajena podpora node:http in node:https prek njunih privzetih globalnih agentov se začne pri 24.5.0, prav tako backportana v 22.21.0.
  • Stikalo ukazne vrstice --use-env-proxy se začne pri 24.5.0 in 22.21.0.

Na združljivi izdaji ta primer POSIX-shell nastavi en korporativni HTTP proxy za obe ciljni shemi:

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

Ime HTTPS_PROXY izbere pot za cilje HTTPS; URL lahko še vedno navaja HTTP proxy. Prilagodite NO_PROXY ciljem, ki ga morajo obiti. Za neodvisen test javnega URL brez proxy računa lahko vnos HTTP s seznama HTTP proxyjev zagotovi obe vrednosti proxy, medtem ko zahtevani notranji obhodi ostanejo.

Oblika s stikalom okolja je alternativa:

export NODE_USE_ENV_PROXY=1
node app.js

Nastavite spremenljivke usmerjanja pred zagonom Node v kateri koli obliki. Dodelitev zastavice opt-in v process.env po zagonu ne ponovi inicializacije ob zagonu.

Preverite, kateri odjemalec HTTP se dejansko uporablja

Privzeti globalni agenti so pomembni za klice http in https, ki jih uporabljajo. Knjižnica z lastnim agentom po meri ali dispečerjem nadzoruje lastni transport; surovi vtičniki TCP so zunaj te funkcije usmerjanja HTTP. Za združljivega odjemalca Undici je izrecen dispečer ProxyAgent ločen vmesnik, lokalen odjemalcu.

Če aplikacija zamenja globalnega agenta, preglejte to zamenjavo, preden domnevate, da ohranja vedenje proxyja ob zagonu. Podobno je konfiguracija registra npm ločena nastavitev orodja in ne dokazuje, kako app.js usmerja zahteve.

Za korporativno zahtevo zaupanja TLS konfigurirajte ustrezno zaupanja vredno CA za runtime. Omogočanje usmerjanja proxy ne zahteva onemogočitve preverjanja potrdil.

Sorodni članki