Lubage Node'i sisseehitatud puhverserveri tugi käivitamisel

Kasutage Node'i keskkonnapuhverserveri lülitit õigete fetch'i ja http/https versioonilävedega ning mõistke selle kliendi ulatust.

Node saab ise lugeda puhverserveri keskkonnamuutujaid, kui selle sisseehitatud tugi on protsessi käivitamisel lubatud. Saadaolevad kliendid sõltuvad runtime'i versioonist:

  • Sisseehitatud fetch toetab NODE_USE_ENV_PROXY alates Node'ist 24.0.0, tagasiulatuv portimine versioonile 22.21.0.
  • Sisseehitatud node:http ja node:https tugi nende vaikimisi globaalsete agentide kaudu algab versioonist 24.5.0, samuti tagasiulatuv portimine versioonile 22.21.0.
  • Käsurea lüliti --use-env-proxy algab versioonidest 24.5.0 ja 22.21.0.

Ühilduval väljalaskel seab see POSIX-kesta näide ühe ettevõtte HTTP-puhverserveri mõlema sihtkoha skeemi jaoks:

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

Nimi HTTPS_PROXY valib marsruudi HTTPS-sihtkohtade jaoks; URL võib siiski nimetada HTTP-puhverserverit. Kohandage NO_PROXY sihtkohtadele, mis peaksid sellest mööda minema. Sõltumatu avaliku URL-i testi jaoks ilma puhverserveri kontota võib HTTP-kirje HTTP-puhverserverite loendist pakkuda mõlemat puhverserveri väärtust, samal ajal kui nõutavad sisemised möödaminekud jäävad alles.

Keskkonnalüliti vorm on alternatiiv:

export NODE_USE_ENV_PROXY=1
node app.js

Määrake marsruutimismuutujad enne Node'i käivitamist kummagi vormiga. Opt-in-lipu omistamine process.env-ile pärast käivitamist ei käivita käivitamise initsialiseerimist uuesti.

Kontrollige, millist HTTP-klientsi tegelikult kasutatakse

Vaikimisi globaalsed agendid on olulised http- ja https-kõnede jaoks, mis neid kasutavad. Oma kohandatud agendi või dispetšeriga teek juhib oma transporti; töötlemata TCP-pesad jäävad sellest HTTP-marsruutimise funktsioonist välja. Ühilduva Undici kliendi jaoks on selgesõnaline ProxyAgent-dispetšer eraldi kliendipõhine liides.

Kui rakendus asendab globaalse agendi, uurige seda asendust enne, kui eeldate, et see säilitab käivituspuhverserveri käitumise. Samuti on npm-i registri konfiguratsioon eraldi tööriistaseade ega tõenda, kuidas app.js päringuid marsruudib.

Ettevõtte TLS-usaldusnõude jaoks konfigureerige runtime'i jaoks sobiv usaldusväärne CA. Puhverserveri marsruutimise lubamine ei nõua sertifikaadi kontrollimise keelamist.

Seotud artiklid