Node's ingebouwde proxy-ondersteuning bij het opstarten inschakelen

Gebruik de omgevingsproxyschakelaar van Node met de juiste fetch- en http/https-versiedrempels en begrijp het clientbereik.

Node kan zelf proxy-omgevingsvariabelen lezen wanneer de ingebouwde ondersteuning bij het starten van het proces is ingeschakeld. De beschikbare clients hangen af van de runtime-versie:

  • Ingebouwde fetch ondersteunt NODE_USE_ENV_PROXY vanaf Node 24.0.0, met een backport naar 22.21.0.
  • Ingebouwde ondersteuning voor node:http en node:https via hun standaard globale agents begint bij 24.5.0, ook teruggeport naar 22.21.0.
  • De opdrachtregelschakelaar --use-env-proxy begint bij 24.5.0 en 22.21.0.

Op een compatibele release stelt dit POSIX-shellvoorbeeld één bedrijfs-HTTP-proxy in voor beide bestemmingsschema's:

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

De naam HTTPS_PROXY selecteert de route voor HTTPS-bestemmingen; de URL kan nog steeds een HTTP-proxy aanduiden. Pas NO_PROXY aan op de bestemmingen die hem moeten omzeilen. Voor een onafhankelijke openbare-URL-test zonder proxyaccount kan een HTTP-vermelding uit de HTTP-proxylijst beide proxywaarden leveren terwijl de vereiste interne omzeilingen behouden blijven.

De omgevingsschakelaarvorm is een alternatief:

export NODE_USE_ENV_PROXY=1
node app.js

Stel de routeringsvariabelen in voordat u Node met een van beide vormen start. Het toewijzen van de opt-in-vlag aan process.env na het opstarten voert de opstartinitialisatie niet opnieuw uit.

Controleer welke HTTP-client daadwerkelijk wordt gebruikt

De standaard globale agents zijn relevant voor http- en https-aanroepen die ze gebruiken. Een bibliotheek met een eigen aangepaste agent of dispatcher beheert zijn eigen transport; onbewerkte TCP-sockets vallen buiten deze HTTP-routeringsfunctie. Voor een compatibele Undici-client is een expliciete ProxyAgent-dispatcher een afzonderlijke client-lokale interface.

Als een toepassing een globale agent vervangt, inspecteer die vervanging voordat u aanneemt dat deze het opstartproxygedrag behoudt. Evenzo is de registerconfiguratie van npm een aparte toolinstelling en bewijst niet hoe app.js verzoeken routeert.

Voor een bedrijfs-TLS-vertrouwensvereiste configureert u de juiste vertrouwde CA voor de runtime. Proxyroutering inschakelen vereist niet dat certificaatverificatie wordt uitgeschakeld.

Gerelateerde artikelen