Omogućite ugrađenu podršku za proxy u Nodeu pri pokretanju

Koristite Nodeov prekidač za proxy okruženja s ispravnim pragovima verzija fetch i http/https i razumite njegov opseg klijenata.

Node može sam čitati varijable okruženja proxyja kada se njegova ugrađena podrška omogući pri pokretanju procesa. Dostupni klijenti zavise od verzije runtimea:

  • Ugrađeni fetch podržava NODE_USE_ENV_PROXY od Nodea 24.0.0, uz backport na 22.21.0.
  • Ugrađena podrška za node:http i node:https preko njihovih zadanih globalnih agenata počinje od 24.5.0, također backportana na 22.21.0.
  • Prekidač naredbenog retka --use-env-proxy počinje od 24.5.0 i 22.21.0.

Na kompatibilnom izdanju ovaj primjer POSIX ljuske postavlja jedan korporativni HTTP proxy za oba odredišna shema:

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 odabire rutu za HTTPS odredišta; URL i dalje može označavati HTTP proxy. Prilagodite NO_PROXY odredištima koja ga trebaju zaobići. Za neovisni test javnog URL-a bez proxy računa, HTTP unos s popisa HTTP proxyja može pružiti obje proxy vrijednosti dok potrebna interna zaobilaženja ostaju.

Oblik s prekidačem okruženja je alternativa:

export NODE_USE_ENV_PROXY=1
node app.js

Postavite varijable usmjeravanja prije pokretanja Nodea u bilo kojem obliku. Dodjela opt-in zastavice u process.env nakon pokretanja ne ponavlja inicijalizaciju pri pokretanju.

Provjerite koji se HTTP klijent stvarno koristi

Zadani globalni agenti relevantni su za http i https pozive koji ih koriste. Biblioteka s vlastitim prilagođenim agentom ili dispečerom kontrolira vlastiti prijenos; sirovi TCP socketti su izvan ove funkcije HTTP usmjeravanja. Za kompatibilnog Undici klijenta, eksplicitni ProxyAgent dispečer zasebno je sučelje lokalno za klijenta.

Ako aplikacija zamijeni globalni agent, pregledajte tu zamjenu prije nego pretpostavite da zadržava ponašanje proxyja pri pokretanju. Isto tako, npm konfiguracija registra zasebna je postavka alata i ne dokazuje kako app.js usmjerava zahtjeve.

Za korporativni zahtjev povjerenja TLS, konfigurirajte odgovarajući pouzdani CA za runtime. Omogućavanje proxy usmjeravanja ne zahtijeva onemogućavanje provjere certifikata.

Povezani članci