Node.js için WeProxy proxy kurulumu

Node.js uygulamalarında proxy desteği kullanılan Node sürümüne ve HTTP istemcisine bağlıdır. Güncel Node.js sürümlerinde yerleşik fetch, ortam değişkenleriyle proxy kullanımını destekleyebilir. Daha açık ve istek bazlı kontrol için Node.js projesi olan Undici'nin ProxyAgent sınıfı kullanılabilir.

WeProxy Bilgilerini Ortam Değişkenlerine Ekleyin

Gerçek kimlik bilgilerini kaynak koduna veya Git deposuna yazmayın.

macOS/Linux:

export WEPROXY_HOST="PROXY_HOST"
export WEPROXY_PORT="PROXY_PORT"
export WEPROXY_USERNAME="PROXY_USERNAME"
export WEPROXY_PASSWORD="PROXY_PASSWORD"

PowerShell:

$env:WEPROXY_HOST="PROXY_HOST"
$env:WEPROXY_PORT="PROXY_PORT"
$env:WEPROXY_USERNAME="PROXY_USERNAME"
$env:WEPROXY_PASSWORD="PROXY_PASSWORD"

Güncel Node.js Sürümlerinde Ortam Proxy Desteği

Node.js 24.0.0 ve 22.21.0 sürümlerinden itibaren NODE_USE_ENV_PROXY=1, başlangıçta HTTP_PROXY, HTTPS_PROXY ve NO_PROXY değişkenlerini okuyabilir. Kullandığınız sürümün bu özelliği desteklediğini doğrulayın.

macOS/Linux örneği:

export HTTPS_PROXY="http://PROXY_USERNAME:PROXY_PASSWORD@PROXY_HOST:PROXY_PORT"
export HTTP_PROXY="$HTTPS_PROXY"
export NODE_USE_ENV_PROXY=1
node app.js

Alternatif olarak Node'u --use-env-proxy parametresiyle başlatabilirsiniz:

node --use-env-proxy app.js

Örnek app.js:

const response = await fetch('https://api.ipify.org?format=json');

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

console.log(await response.json());

Undici ProxyAgent ile Açık Yapılandırma

Önce güncel Undici paketini kurun:

npm install undici

Ardından proxy adresini ortam değişkenlerinden oluşturun:

import { ProxyAgent, fetch } from 'undici';

const {
  WEPROXY_HOST,
  WEPROXY_PORT,
  WEPROXY_USERNAME,
  WEPROXY_PASSWORD,
} = process.env;

const username = encodeURIComponent(WEPROXY_USERNAME);
const password = encodeURIComponent(WEPROXY_PASSWORD);
const proxyUrl = `http://${username}:${password}@${WEPROXY_HOST}:${WEPROXY_PORT}`;
const dispatcher = new ProxyAgent(proxyUrl);

const response = await fetch('https://api.ipify.org?format=json', {
  dispatcher,
  signal: AbortSignal.timeout(30_000),
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

console.log(await response.json());
await dispatcher.close();

Node.js Proxy Hataları

Ortam değişkenleri etkisiz kalıyor

Node sürümünüzü node --version ile kontrol edin. Eski sürümlerde yerleşik fetch ortam proxy ayarını otomatik kullanmayabilir; ProxyAgent yöntemini tercih edin.

407 Proxy Authentication Required

Kimlik bilgilerinin güncel olduğunu ve özel karakterlerin encodeURIComponent ile kodlandığını kontrol edin.

Sertifika hatası

TLS doğrulamasını kapatmayın. Kullandığınız proxy ve hedef sertifika zincirini kontrol edin. NODE_TLS_REJECT_UNAUTHORIZED=0 üretim için güvenli bir çözüm değildir.

Kaynaklar

• Node.js CLI: NODE_USE_ENV_PROXY
• Undici: ProxyAgent