Aktifkan Dukungan Proxy Bawaan Node saat Startup

Gunakan sakelar proxy lingkungan Node dengan ambang versi fetch dan http/https yang benar dan pahami cakupan kliennya.

Node dapat membaca variabel lingkungan proxy sendiri saat dukungan bawaannya diaktifkan pada startup proses. Klien yang tersedia bergantung pada versi runtime:

  • fetch bawaan mendukung NODE_USE_ENV_PROXY sejak Node 24.0.0, dengan backport ke 22.21.0.
  • Dukungan bawaan node:http dan node:https melalui agen global defaultnya dimulai pada 24.5.0, juga di-backport ke 22.21.0.
  • Sakelar baris perintah --use-env-proxy dimulai pada 24.5.0 dan 22.21.0.

Pada rilis yang kompatibel, contoh POSIX-shell ini menetapkan satu proxy HTTP perusahaan untuk kedua skema tujuan:

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

Nama HTTPS_PROXY memilih rute untuk tujuan HTTPS; URL tetap dapat menyebut proxy HTTP. Sesuaikan NO_PROXY ke tujuan yang harus melewatinya. Untuk uji URL publik independen tanpa akun proxy, entri HTTP dari daftar proxy HTTP dapat menyediakan kedua nilai proxy sementara bypass internal yang diperlukan tetap ada.

Bentuk sakelar lingkungan adalah alternatif:

export NODE_USE_ENV_PROXY=1
node app.js

Tetapkan variabel perutean sebelum meluncurkan Node dengan salah satu bentuk. Menetapkan flag opt-in ke process.env setelah startup tidak menjalankan ulang inisialisasi startup.

Periksa klien HTTP yang benar-benar digunakan

Agen global default relevan untuk panggilan http dan https yang menggunakannya. Pustaka dengan agen atau dispatcher khususnya sendiri mengendalikan transportnya sendiri; soket TCP mentah berada di luar fitur perutean HTTP ini. Untuk klien Undici yang kompatibel, dispatcher ProxyAgent eksplisit adalah antarmuka terpisah yang lokal bagi klien.

Jika aplikasi mengganti agen global, periksa penggantian itu sebelum menganggapnya mempertahankan perilaku proxy startup. Demikian pula, konfigurasi registri npm adalah pengaturan alat terpisah dan tidak membuktikan bagaimana app.js merutekan permintaan.

Untuk persyaratan kepercayaan TLS perusahaan, konfigurasikan CA tepercaya yang sesuai untuk runtime. Mengaktifkan perutean proxy tidak mengharuskan penonaktifan verifikasi sertifikat.

Artikel terkait