تفعيل دعم الوكيل المدمج في Node عند بدء التشغيل

يستطيع Node قراءة متغيرات بيئة الوكيل بنفسه عندما تُفعَّل ميزته المدمجة عند بدء تشغيل العملية. تعتمد العملاء المتاحة على إصدار بيئة التشغيل:

• يدعم fetch المدمج NODE_USE_ENV_PROXY اعتبارًا من Node 24.0.0، مع نقل الميزة إلى 22.21.0.
• يبدأ دعم node:http وnode:https المدمجين عبر وكلائهما العامّين الافتراضيين من 24.5.0، وقد نُقل أيضًا إلى 22.21.0.
• يبدأ مفتاح سطر الأوامر --use-env-proxy من 24.5.0 و22.21.0.

على إصدار متوافق، يضبط مثال POSIX-shell هذا وكيل HTTP مؤسسيًا واحدًا لكلا مخططي الوجهة:

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 المسار لوجهات HTTPS؛ ويمكن أن يشير عنوان URL مع ذلك إلى وكيل HTTP. اضبط NO_PROXY على الوجهات التي ينبغي تجاوزها. لاختبار مستقل بعنوان URL عام دون حساب وكيل، يمكن لإدخال HTTP من قائمة وكلاء HTTP أن يوفّر قيمتي الوكيل مع بقاء التجاوزات الداخلية المطلوبة.

صيغة مفتاح البيئة بديل:

export NODE_USE_ENV_PROXY=1
node app.js

اضبط متغيرات التوجيه قبل تشغيل Node بأي من الصيغتين. إن إسناد علم الاشتراك إلى process.env بعد بدء التشغيل لا يعيد تشغيل تهيئة البدء.

تحقّق من عميل HTTP المستخدم فعليًا

الوكلاء العامّون الافتراضيون مهمّون لنداءات http وhttps التي تستخدمهم. المكتبة التي لديها وكيل أو موزّع مخصص خاص بها تتحكم في نقلها الخاص؛ ومقابس TCP الخام خارج ميزة توجيه HTTP هذه. لعميل Undici متوافق، يُعدّ موزّع ProxyAgent الصريح واجهة منفصلة محلية للعميل.

إذا استبدلت تطبيقاتٌ وكيلًا عامًّا، فافحص ذلك البديل قبل افتراض أنه يحتفظ بسلوك وكيل البدء. وبالمثل، فإن إعداد سجل npm إعداد أداة منفصل ولا يثبت كيف يوجّه app.js الطلبات.

لمتطلب ثقة TLS مؤسسي، اضبط الجهة المصدرة الموثوقة CA المناسبة لبيئة التشغيل. ولا يتطلب تفعيل توجيه الوكيل تعطيل التحقق من الشهادة.