Zapněte vestavěnou podporu proxy v Node při spuštění

Použijte přepínač proxy prostředí Node se správnými prahy verzí fetch a http/https a pochopte rozsah klienta.

Node může sám číst proměnné prostředí proxy, když je jeho vestavěná podpora povolena při spuštění procesu. Dostupné klienty závisí na verzi runtime:

  • Vestavěný fetch podporuje NODE_USE_ENV_PROXY od Node 24.0.0, s backportem do 22.21.0.
  • Vestavěná podpora node:http a node:https přes jejich výchozí globální agenty začíná na 24.5.0, také backportovaná do 22.21.0.
  • Přepínač příkazového řádku --use-env-proxy začíná na 24.5.0 a 22.21.0.

Na kompatibilním vydání tento příklad POSIX shellu nastaví jednu podnikovou HTTP proxy pro obě cílová schémata:

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ázev HTTPS_PROXY vybírá trasu pro cíle HTTPS; URL však může stále označovat HTTP proxy. Upravte NO_PROXY na cíle, které ji mají obejít. Pro nezávislý test veřejné URL bez proxy účtu může HTTP záznam z seznamu HTTP proxy poskytnout obě hodnoty proxy, zatímco požadovaná interní obejití zůstanou.

Forma s přepínačem prostředí je alternativou:

export NODE_USE_ENV_PROXY=1
node app.js

Nastavte proměnné směrování před spuštěním Node v kterékoli z forem. Přiřazení příznaku opt-in do process.env po spuštění znovu nespustí inicializaci při spuštění.

Zkontrolujte, který HTTP klient se skutečně používá

Výchozí globální agenti jsou relevantní pro volání http a https, která je používají. Knihovna s vlastním vlastním agentem nebo dispečerem řídí svůj vlastní přenos; surové TCP sockety jsou mimo tuto funkci HTTP směrování. Pro kompatibilního klienta Undici je explicitní dispečer ProxyAgent samostatné rozhraní lokální pro klienta.

Pokud aplikace nahradí globálního agenta, prozkoumejte tuto náhradu, než předpokládáte, že si zachová chování proxy při spuštění. Stejně tak konfigurace registru npm je samostatné nastavení nástroje a neprokazuje, jak app.js směruje požadavky.

Pro podnikový požadavek důvěry TLS nakonfigurujte příslušnou důvěryhodnou CA pro runtime. Povolení směrování proxy nevyžaduje vypnutí ověřování certifikátů.

Související články