بروكسيات بمصادقة في Node.js: مكتبات Axios وfetch المدمجة وGot
بقلم الفريق الهندسي لـ ProxyV4 · Updated:
الطريقة الموثوقة لاستخدام بروكسي Node.js مع Axios هي تمرير HttpsProxyAgent كـ httpsAgent مع proxy: false. لا ينشئ إعداد proxy: { host, port } الخاص بـ Axios نفق HTTP CONNECT، لذا يتعطل مع روابط https://؛ بينما يحتاج fetch() المدمج إلى ProxyAgent من undici بدلاً من ذلك. توضح هذه الصفحة طريقة استخدام كل عميل مع رابط http://user:pass@ip:port من ProxyV4 وكيفية تأكيد IP الخروج.
new HttpsProxyAgent('http://user:pass@ip:port')- عنوان IP واحد1.85 US$
- +3 عناوين IP1.70 US$
- +10 عناوين IP1.60 US$
- +25 عناوين IP1.50 US$
- +50 عناوين IP1.40 US$
- +100 عناوين IP1.30 US$
- +200 عناوين IP1.20 US$
- +500 عناوين IP1.10 US$
- عنوان IP واحد1.85 US$
- +3 عناوين IP1.70 US$
- +10 عناوين IP1.60 US$
- +25 عناوين IP1.50 US$
- +50 عناوين IP1.40 US$
- +100 عناوين IP1.30 US$
- +200 عناوين IP1.20 US$
- +500 عناوين IP1.10 US$
اختر المقتطف البرمجي المناسب لعميل HTTP الخاص بك
تقبل جميع العملاء الثلاثة نفس رابط البروكسي. قم ببنائه من سطر ip:port:user:pass الموجود في طلبك؛ يظل المخطط http:// لأن العميل يتواصل مع البروكسي عبر HTTP ويمرر TLS عبر النفق.
| العميل | التثبيت | ربط البروكسي |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
fetch المدمج (Node 18+) | npm i undici | fetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') }) |
| Got | npm i hpagent | got(url, { agent: { https: new HttpsProxyAgent({ proxy: 'http://user:pass@ip:port' }) } }) |
أهمية إعداد `proxy: false` في Axios
يتحقق Axios من متغيرات البيئة HTTP_PROXY وHTTPS_PROXY تلقائياً. إذا تم تعيين أحدهما على الجهاز (وهو أمر شائع في بيئات CI والحاويات) وقمت أيضاً بتمرير وكيل (agent)، فسيحدث تعارض بين الإعدادين. يوجه proxy: false مكتبة Axios لتجاهل البيئة ومنطق البروكسي المدمج فيها، بحيث يكون الوكيل هو المسؤول الوحيد عن تحديد مسار الطلب.
إعادة استخدام الوكلاء عبر عدة طلبات
- أنشئ وكيلاً واحداً لكل عنوان IP بروكسي خارج حلقة الطلبات؛ يحتفظ الوكيل باتصالات keep-alive، بينما يؤدي إنشاء وكيل جديد مع كل استدعاء إلى التخلص منها
- عند استخدام عدة بروكسيات، احتفظ بـ
Mapيربط كل IP بالوكيل الخاص به واختر منه، بدلاً من إنشاء الوكلاء بشكل فوري - حدد مهلة زمنية
timeoutلكل استدعاء (على سبيل المثالtimeout: 10000في Axios) حتى لا يؤدي هدف معطل إلى حجز مسار المعالجة إلى الأبد - هل تحتاج إلى قائمة البروكسي كبيانات؟ تقوم أداة تحويل صيغ البروكسي بتحويل أسطر
ip:port:user:passإلى مصفوفة JSON يمكنك تضمينها عبرrequireأوimport
ما يوفره عنوان IP ثابت لمهام Node.js
ينتمي عنوان IPv4 الخاص من ProxyV4 لعميل واحد طوال فترة الإيجار ويحتفظ بنفس العنوان عند التجديد، مما يضمن بقاء واجهة برمجة التطبيقات المدرجة في القائمة البيضاء، أو الجلسة المسجلة، أو معدل الطلبات المخصص المرتبط بذلك الـ IP صالحاً بين عمليات النشر. استهلاك البيانات غير محدود، مما يحافظ على استقرار وموثوقية مهام التشغيل الطويلة. لمعرفة أنماط الزحف وتنظيم معدل الطلبات، راجع حالة استخدام استخراج بيانات الويب.
خطوة بخطوة
- 1
تثبيت العميل والوكيل
شغّل
npm install axios https-proxy-agentداخل المشروع (أوnpm install undiciإذا كنت تستخدمfetchالمدمج). - 2
إنشاء الوكيل مرة واحدة
أنشئ
const agent = new HttpsProxyAgent('http://user:pass@ip:port');باستخدام القيم المأخوذة من طلبك لدى ProxyV4. - 3
إرسال طلب عبره
استدعِ
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });. - 4
مقارنة عنوان IP
يجب أن يطبع
console.log(res.data)عنوان IP الخاص بالبروكسي. وإذا طبع عنوان خادمك الفعلي، فهذا يعني أنه لم يتم تطبيق الوكيل.
الأسئلة الشائعة
لماذا يفشل إعداد proxy: { host, port, auth } في Axios مع مواقع HTTPS؟
يرسل هذا الخيار طلب HTTP عادياً إلى البروكسي بدلاً من طلب نفق HTTP CONNECT أولاً، وبالتالي لا يتم إنشاء اتصال TLS بالوجهة بالشكل الصحيح. استخدم httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') واضبط proxy: false.
كيف أضيف بروكسي إلى fetch() المدمج في Node 18 أو 20 أو 22؟
يعتمد fetch في Node على مكتبة undici، لذا قم باستيراد ProxyAgent من undici وتمرير { dispatcher: new ProxyAgent('http://user:pass@ip:port') } كجزء من خيارات fetch().
كلمة المرور تحتوي على @ أو :. هل سيتعطل الرابط؟
قد يتعطل، لأن هذه الرموز لها دلالة خاصة داخل الروابط. قم بترميز كلمة المرور باستخدام encodeURIComponent(password) قبل إنشاء http://user:pass@ip:port.
الطلب يرجع الخطأ 407. ما المشكلة؟
استجاب البروكسي لكنه رفض تسجيل الدخول. أعد التحقق من اسم المستخدم وكلمة المرور من تفاصيل طلبك؛ تسرد صفحة استكشاف أخطاء 407 وإصلاحها الأسباب الشائعة.
المصادر
عناوين IPv4 ثابتة لمهام Node.js
عناوين IPv4 خاصة في 7 دول بالإضافة إلى ISP ثابت في US وVietnam، بدون قيود على الاستهلاك، عميل واحد لكل IP. اشترِ عنواناً واحداً أو أكثر.
تحقق من أسعار US المباشرة