Ŝalti la enkonstruitan prokuran subtenon de Node ĉe startigo

Uzu la mediprokuran ŝaltilon de Node kun la ĝustaj sojloj de versioj fetch kaj http/https kaj komprenu ĝian klientan amplekson.

Node povas mem legi prokurajn mediajn variablojn kiam ĝia enkonstruita subteno estas ŝaltita ĉe proceza startigo. La disponeblaj klientoj dependas de la rulversio:

  • La enkonstruita fetch subtenas NODE_USE_ENV_PROXY ekde Node 24.0.0, kun retroporto al 22.21.0.
  • La enkonstruita subteno de node:http kaj node:https per iliaj defaŭltaj tutmondaj agentoj komenciĝas ĉe 24.5.0, ankaŭ retroportita al 22.21.0.
  • La komandlinia ŝaltilo --use-env-proxy komenciĝas ĉe 24.5.0 kaj 22.21.0.

Ĉe kongrua eldono, ĉi tiu POSIX-shell-ekzemplo agordas unu firmaan HTTP-prokuron por ambaŭ celaj skemoj:

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

La nomo HTTPS_PROXY elektas la vojon por HTTPS-celoj; la URL povas ankoraŭ nomi HTTP-prokuron. Ĝustigu NO_PROXY al la celoj, kiuj devas eviti ĝin. Por sendependa publika-URL-testo sen prokura konto, HTTP-enskribo el la listo de HTTP-prokuroj povas provizi ambaŭ prokurajn valorojn dum la bezonataj internaj evitoj restas.

La mediprokura ŝaltilo estas alternativo:

export NODE_USE_ENV_PROXY=1
node app.js

Agordu la enkursigajn variablojn antaŭ ol lanĉi Node per iu ajn formo. Asigni la opt-in-flagon al process.env post startigo ne reekzekutas la startan inicialigon.

Kontrolu, kiu HTTP-kliento efektive uzatas

La defaŭltaj tutmondaj agentoj gravas por http- kaj https-vokoj, kiuj uzas ilin. Biblioteko kun propra kutima agento aŭ disdonilo regas sian propran transporton; krudaj TCP-ingoj estas ekster ĉi tiu HTTP-enkursiga trajto. Por kongrua Undici-kliento, eksplicita ProxyAgent-disdonilo estas aparta klient-loka interfaco.

Se aplikaĵo anstataŭigas tutmondan agenton, ekzamenu tiun anstataŭon antaŭ ol supozi, ke ĝi konservas la startan prokuran konduton. Same, la registra agordo de npm estas aparta ilagordo kaj ne pruvas, kiel app.js enkursigas petojn.

Por firmaa TLS-fidopostulo, agordu la taŭgan fidata CA por la rulversio. Ŝalti prokuran enkursigon ne postulas malŝalti atestilan kontrolon.

Rilataj artikoloj