Zapnite vstavanú podporu proxy v Node pri spustení

Použite prepínač proxy prostredia Node so správnymi prahmi verzií fetch a http/https a pochopte rozsah klienta.

Node môže sám čítať premenné prostredia proxy, keď je jeho vstavaná podpora povolená pri spustení procesu. Dostupné klienty závisia od verzie runtime:

  • Vstavaný fetch podporuje NODE_USE_ENV_PROXY od Node 24.0.0, s backportom do 22.21.0.
  • Vstavaná podpora node:http a node:https cez ich predvolených globálnych agentov začína na 24.5.0, tiež backportovaná do 22.21.0.
  • Prepínač príkazového riadka --use-env-proxy začína na 24.5.0 a 22.21.0.

Na kompatibilnom vydaní tento príklad POSIX shellu nastaví jeden podnikový HTTP proxy pre obe cieľové schémy:

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

Názov HTTPS_PROXY vyberá trasu pre ciele HTTPS; URL však stále môže označovať HTTP proxy. Upravte NO_PROXY na ciele, ktoré ho majú obísť. Pre nezávislý test verejnej URL bez proxy účtu môže HTTP záznam zo zoznamu HTTP proxy poskytnúť obe hodnoty proxy, zatiaľ čo požadované interné obchádzky zostávajú.

Forma s prepínačom prostredia je alternatívou:

export NODE_USE_ENV_PROXY=1
node app.js

Nastavte premenné smerovania pred spustením Node v ktorejkoľvek z foriem. Priradenie opt-in príznaku do process.env po spustení znovu nespustí inicializáciu pri spustení.

Skontrolujte, ktorý HTTP klient sa skutočne používa

Predvolení globálni agenti sú relevantní pre volania http a https, ktoré ich používajú. Knižnica s vlastným vlastným agentom alebo dispečerom riadi svoj vlastný prenos; surové TCP sockety sú mimo tejto funkcie HTTP smerovania. Pre kompatibilného klienta Undici je explicitný dispečer ProxyAgent samostatné rozhranie lokálne pre klienta.

Ak aplikácia nahradí globálneho agenta, preskúmajte túto náhradu, kým predpokladáte, že si zachová správanie proxy pri spustení. Podobne konfigurácia registra npm je samostatné nastavenie nástroja a nepreukazuje, ako app.js smeruje požiadavky.

Pre podnikovú požiadavku dôvery TLS nakonfigurujte príslušnú dôveryhodnú CA pre runtime. Povolenie smerovania proxy nevyžaduje vypnutie overovania certifikátov.

Súvisiace články