Virkjaðu innbyggðan proxy-stuðning Node við ræsingu

Notaðu umhverfisproxy-rofa Node með réttum fetch- og http/https-útgáfumörkum og skildu biðlarasviðið.

Node getur sjálft lesið proxy-umhverfisbreytur þegar innbyggður stuðningur þess er virkjaður við ræsingu ferlisins. Fáanlegir biðlarar ráðast af útgáfu keyrsluumhverfisins:

  • Innbyggt fetch styður NODE_USE_ENV_PROXY frá Node 24.0.0, með afturfærslu á 22.21.0.
  • Innbyggður stuðningur node:http og node:https gegnum sjálfgefnu altæku agentana byrjar á 24.5.0, einnig afturfærður á 22.21.0.
  • Skipanalínurofinn --use-env-proxy byrjar á 24.5.0 og 22.21.0.

Á samhæfri útgáfu setur þetta POSIX-shell dæmi einn fyrirtækja-HTTP-proxy fyrir bæði áfangaskemu:

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

Nafnið HTTPS_PROXY velur leiðina fyrir HTTPS-áfangastaði; slóðin getur samt nefnt HTTP-proxy. Stilltu NO_PROXY fyrir þá áfangastaði sem eiga að fara fram hjá honum. Fyrir sjálfstætt próf á opinberri slóð án proxy-reiknings getur HTTP-færsla úr HTTP-proxylistanum veitt bæði proxy-gildin á meðan nauðsynlegar innri framhjáferðir haldast.

Umhverfisrofinn er valkostur:

export NODE_USE_ENV_PROXY=1
node app.js

Stilltu leiðarbreyturnar áður en þú ræsir Node með hvorri sem er myndinni. Að úthluta opt-in-flöggunni á process.env eftir ræsingu keyrir ekki ræsingarfrumsmíðina aftur.

Athugaðu hvaða HTTP-biðlara er í raun notaður

Sjálfgefnu altæku agentarnir eiga við http- og https-köll sem nota þá. Bókasafn með eigin sérsniðna agent eða sendingara stýrir eigin flutningi; hrá TCP-sokkar eru utan þessarar HTTP-leiðar. Fyrir samhæfðan Undici-biðlara er skyr ProxyAgent-sendingari aðskilið viðmót staðbundið biðlaranum.

Ef forrit skiptir út altækum agent ætti að skoða þá útskiptingu áður en gert er ráð fyrir að hún haldi ræsingarproxyhegðuninni. Á sama hátt er skráningarstilling npm aðskilin tólastilling og sannar ekki hvernig app.js leiðir beiðnir.

Fyrir fyrirtækjakröfu um TLS-traust, stilltu viðeigandi traust CA fyrir keyrsluumhverfið. Virkjun proxy-leiðar krefst ekki þess að slökkva á vottorðasannprófun.

Tengdir greinar