Dayakan Sokongan Proksi Terbina dalam Node semasa Permulaan

Gunakan suis proksi persekitaran Node dengan ambang versi fetch dan http/https yang betul dan fahami skop kliennya.

Node boleh membaca pemboleh ubah persekitaran proksi sendiri apabila sokongan terbina dalamnya didayakan semasa permulaan proses. Klien yang tersedia bergantung pada versi runtime:

  • fetch terbina dalam menyokong NODE_USE_ENV_PROXY dari Node 24.0.0, dengan backport ke 22.21.0.
  • Sokongan terbina dalam node:http dan node:https melalui ejen global lalai mereka bermula pada 24.5.0, juga di-backport ke 22.21.0.
  • Suis baris arahan --use-env-proxy bermula pada 24.5.0 dan 22.21.0.

Pada keluaran yang serasi, contoh POSIX-shell ini menetapkan satu proksi HTTP korporat untuk kedua-dua skema destinasi:

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 laluan untuk destinasi HTTPS; URL masih boleh menamakan proksi HTTP. Laraskan NO_PROXY kepada destinasi yang sepatutnya memintasnya. Untuk ujian URL awam bebas tanpa akaun proksi, entri HTTP daripada senarai proksi HTTP boleh menyediakan kedua-dua nilai proksi sementara pintasan dalaman yang diperlukan kekal.

Bentuk suis persekitaran ialah alternatif:

export NODE_USE_ENV_PROXY=1
node app.js

Tetapkan pemboleh ubah penghalaan sebelum melancarkan Node dengan mana-mana bentuk. Menetapkan bendera opt-in kepada process.env selepas permulaan tidak menjalankan semula permulaan permulaan.

Periksa klien HTTP yang sebenarnya digunakan

Ejen global lalai relevan untuk panggilan http dan https yang menggunakannya. Pustaka dengan ejen atau penghantar tersuai sendiri mengawal pengangkutannya sendiri; soket TCP mentah berada di luar ciri penghalaan HTTP ini. Untuk klien Undici yang serasi, penghantar ProxyAgent eksplisit ialah antara muka berasingan setempat klien.

Jika aplikasi menggantikan ejen global, periksa penggantian itu sebelum menganggapnya mengekalkan tingkah laku proksi permulaan. Begitu juga, konfigurasi pendaftaran npm ialah tetapan alat berasingan dan tidak membuktikan cara app.js menghalakan permintaan.

Untuk keperluan kepercayaan TLS korporat, konfigurasikan CA dipercayai yang sesuai untuk runtime. Mendayakan penghalaan proksi tidak memerlukan penyahdayaan pengesahan sijil.

Artikel berkaitan