A Node beépített proxy-támogatásának engedélyezése indításkor

Használja a Node környezeti proxykapcsolóját a helyes fetch- és http/https-verzióhatárokkal, és értse meg az ügyfélkörét.

A Node maga is olvashatja a proxy környezeti változóit, ha beépített támogatása a folyamat indításakor engedélyezve van. Az elérhető ügyfelek a futtatókörnyezet verziójától függenek:

  • A beépített fetch a Node 24.0.0-tól támogatja a NODE_USE_ENV_PROXY-t, visszaportolva a 22.21.0-ra.
  • A beépített node:http és node:https támogatás az alapértelmezett globális ügynökeiken keresztül a 24.5.0-tól indul, szintén visszaportolva a 22.21.0-ra.
  • A --use-env-proxy parancssori kapcsoló a 24.5.0-tól és a 22.21.0-tól indul.

Egy kompatibilis kiadáson ez a POSIX-shell példa egy vállalati HTTP-proxyt állít be mindkét cél sémához:

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

A HTTPS_PROXY név az HTTPS-célok útvonalát választja ki; az URL továbbra is megnevezhet HTTP-proxyt. Állítsa be a NO_PROXY-t azokra a célokra, amelyeknek meg kell kerülniük. Független nyilvános URL-teszthez proxyfiók nélkül a HTTP-proxylistáról származó HTTP-bejegyzés mindkét proxyértéket biztosíthatja, miközben a szükséges belső megkerülések megmaradnak.

A környezeti kapcsoló forma alternatíva:

export NODE_USE_ENV_PROXY=1
node app.js

Állítsa be az útválasztási változókat, mielőtt bármelyik formával elindítja a Node-ot. Az opt-in jelző process.env-nek való hozzárendelése indítás után nem futtatja újra az indítási inicializálást.

Ellenőrizze, melyik HTTP-ügyfél van ténylegesen használatban

Az alapértelmezett globális ügynökök az őket használó http- és https-hívások szempontjából relevánsak. A saját egyéni ügynökkel vagy diszpécserrel rendelkező könyvtár a saját átvitelét vezérli; a nyers TCP-socketek kívül esnek ezen a HTTP-útválasztási funkción. Egy kompatibilis Undici-ügyfélhez a egy explicit ProxyAgent-diszpécser külön, ügyfélszintű felület.

Ha egy alkalmazás lecserél egy globális ügynököt, vizsgálja meg ezt a cserét, mielőtt feltételezné, hogy megtartja az indítási proxy viselkedését. Hasonlóképpen, az npm bejegyzési konfigurációja külön eszközbeállítás, és nem bizonyítja, hogyan irányítja az app.js a kéréseket.

Vállalati TLS-megbízhatósági követelmény esetén konfigurálja a megfelelő megbízható CA-t a futtatókörnyezethez. A proxy-útválasztás engedélyezése nem igényli a tanúsítvány-ellenőrzés letiltását.

Kapcsolódó cikkek