Node'un Yerleşik Proxy Desteğini Başlangıçta Etkinleştirin

Node'un ortam proxy anahtarını doğru fetch ve http/https sürüm eşikleriyle kullanın ve istemci kapsamını anlayın.

Node, yerleşik desteği süreç başlangıcında etkinleştirildiğinde proxy ortam değişkenlerini kendisi okuyabilir. Kullanılabilir istemciler çalışma zamanı sürümüne bağlıdır:

  • Yerleşik fetch, NODE_USE_ENV_PROXY'yi Node 24.0.0'dan itibaren destekler ve 22.21.0'a geri taşınmıştır.
  • Yerleşik node:http ve node:https desteği, varsayılan genel aracıları aracılığıyla 24.5.0'da başlar ve 22.21.0'a da geri taşınmıştır.
  • --use-env-proxy komut satırı anahtarı 24.5.0 ve 22.21.0'da başlar.

Uyumlu bir sürümde bu POSIX-shell örneği, her iki hedef şeması için tek bir kurumsal HTTP proxy'si ayarlar:

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

HTTPS_PROXY adı, HTTPS hedefleri için rotayı seçer; URL yine de bir HTTP proxy'sini adlandırabilir. NO_PROXY'yi onu atlaması gereken hedeflere göre ayarlayın. Proxy hesabı olmadan bağımsız bir genel URL testi için HTTP proxy listesinden bir HTTP girdisi, gerekli iç atlamalar korunurken her iki proxy değerini de sağlayabilir.

Ortam anahtarı biçimi bir alternatiftir:

export NODE_USE_ENV_PROXY=1
node app.js

Yönlendirme değişkenlerini Node'u her iki biçimden biriyle başlatmadan önce ayarlayın. opt-in bayrağını başlangıçtan sonra process.env'ye atamak başlangıç başlatmasını yeniden çalıştırmaz.

Gerçekte hangi HTTP istemcisinin kullanıldığını denetleyin

Varsayılan genel aracılar, onları kullanan http ve https çağrılarıyla ilgilidir. Kendi özel aracısı veya dağıtıcısı olan bir kitaplık kendi taşımasını denetler; ham TCP soketleri bu HTTP yönlendirme özelliğinin dışındadır. Uyumlu bir Undici istemcisi için açık bir ProxyAgent dağıtıcısı istemciye yerel ayrı bir arabirimdir.

Bir uygulama genel bir aracıyı değiştirirse, başlangıç proxy davranışını koruduğunu varsaymadan önce bu değişikliği inceleyin. Benzer şekilde, npm'in kayıt yapılandırması ayrı bir araç ayarıdır ve app.js'in istekleri nasıl yönlendirdiğini kanıtlamaz.

Kurumsal bir TLS güven gereksinimi için çalışma zamanına uygun güvenilir CA'yı yapılandırın. Proxy yönlendirmesini etkinleştirmek, sertifika doğrulamasının devre dışı bırakılmasını gerektirmez.

İlgili makaleler