Įgalinti integruotą Node tarpinio serverio palaikymą paleidimo metu

Naudokite Node aplinkos tarpinio serverio jungiklį su tinkamomis fetch ir http/https versijų ribomis ir supraskite jo klientų aprėptį.

Node gali pats skaityti tarpinio serverio aplinkos kintamuosius, kai jo integruotas palaikymas įjungiamas proceso paleidimo metu. Galimi klientai priklauso nuo runtime versijos:

  • Integruotas fetch palaiko NODE_USE_ENV_PROXY nuo Node 24.0.0, su atgaliniu perkėlimu į 22.21.0.
  • Integruotas node:http ir node:https palaikymas per jų numatytuosius globaliuosius agentus prasideda nuo 24.5.0, taip pat atgal perkeltas į 22.21.0.
  • Komandinės eilutės jungiklis --use-env-proxy prasideda nuo 24.5.0 ir 22.21.0.

Suderintoje versijoje šis POSIX-shell pavyzdys nustato vieną įmonės HTTP tarpinį serverį abiem paskirties schemoms:

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

Pavadinimas HTTPS_PROXY parenka maršrutą HTTPS paskirties vietoms; URL vis tiek gali nurodyti HTTP tarpinį serverį. Sureguliuokite NO_PROXY pagal paskirties vietas, kurios turėtų jį apeiti. Nepriklausomam viešos URL testui be tarpinio serverio paskyros HTTP įrašas iš HTTP tarpinių serverių sąrašo gali pateikti abi tarpinio serverio vertes, o reikalingi vidiniai apėjimai išlieka.

Aplinkos jungiklio forma yra alternatyva:

export NODE_USE_ENV_PROXY=1
node app.js

Nustatykite maršrutizavimo kintamuosius prieš paleisdami Node bet kuria forma. Opt-in vėliavos priskyrimas process.env po paleidimo nepaleidžia paleidimo inicijavimo iš naujo.

Patikrinkite, kuris HTTP klientas iš tikrųjų naudojamas

Numatytieji globalieji agentai yra svarbūs http ir https kvietimams, kurie juos naudoja. Biblioteka su savo pasirinktiniu agentu ar dispečeriu valdo savo transportą; neapdoroti TCP lizdai yra už šios HTTP maršrutizavimo funkcijos ribų. Suderinamam Undici klientui aiškus ProxyAgent dispečeris yra atskira kliento lokali sąsaja.

Jei programa pakeičia globalųjį agentą, patikrinkite tą pakeitimą prieš manydami, kad jis išlaiko paleidimo tarpinio serverio elgesį. Taip pat npm registro konfigūracija yra atskiras įrankio nustatymas ir neįrodo, kaip app.js maršrutizuoja užklausas.

Dėl įmonės TLS pasitikėjimo reikalavimo sukonfigūruokite tinkamą patikimą CA runtime aplinkai. Tarpinio serverio maršrutizavimo įjungimas nereikalauja išjungti sertifikatų tikrinimo.

Susiję straipsniai