دليل · Python

استخدام البروكسيات مع Python requests و httpx

تعد requests مكتبة HTTP الأكثر شعبية في Python وتتضمن دعماً مدمجاً للبروكسيات المحمية بمصادقة. وتتمثل الأخطاء الأكثر شيوعاً في تحديد مفتاح https بشكل غير صحيح في قاموس proxies وترك الرموز الخاصة في كلمات المرور دون ترميز. يغطي هذا الدليل الإعداد الصحيح، بما في ذلك مهل الاتصال والتعامل مع الأخطاء للنصوص البرمجية التي تعمل لفترات طويلة.

الكاتب: Bùi Toàn · تم التحديث: 19/11/2026

الإعداد الأساسي

  • نسّق سلسلة ip:port:user:pass في رابط URL: proxy_url = "http://user:pass@IP:PORT".
  • صرّح عن كلا المفتاحين: proxies = {"http": proxy_url, "https": proxy_url}. المفتاح "https" يظل مشيراً إلى عنوان URL يبدأ بـ http:// لأن بروكسيات ONET هي بروكسيات HTTP؛ حيث تستخدم requests تلقائياً CONNECT لمواقع HTTPS.
  • أرسل الطلب: r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30)); print(r.text). يجب أن تكون النتيجة هي عنوان IP الخاص بالبروكسي.
  • لا تكتب "https": "https://IP:PORT". لا تقبل بروكسيات ONET اتصالات TLS إليها مباشرة وستُرجع خطأ SSL أو تغلق الاتصال.

كيف تستخدم بروكسي بكلمة مرور تحوي رموزاً خاصة في requests؟

قم بترميز اسم المستخدم وكلمة المرور بتنسيق URL قبل التجميع: from urllib.parse import quote; proxy_url = f"http://{quote(user, safe='')}:{quote(pw, safe='')}@{ip}:{port}". بدون هذه الخطوة، ستتسبب الرموز @ أو : داخل كلمة المرور في تحليل requests لعنوان البروكسي بشكل خاطئ.

استخدام Session وإعادة المحاولة

  • أنشئ s = requests.Session(); s.proxies.update(proxies). تشترك جميع الطلبات التي تتم عبر s في البروكسي وتحافظ على الاتصالات، وهو أمر أسرع من استدعاء requests.get بشكل متكرر.
  • قم بتركيب HTTPAdapter مع Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 503]) لإعادة المحاولة تلقائياً عند حدوث أخطاء عابرة.
  • اضبط مهلة زمنية دائماً. بدون تحديد مهلة، قد يؤدي الاتصال المعلق إلى تجميد برنامجك إلى أجل غير مسمى.
  • تتم قراءة متغير البيئة HTTPS_PROXY أيضاً بواسطة requests، ما لم تقم بضبط s.trust_env = False.

مع httpx

بدءاً من httpx 0.26، مرر البروكسي باستخدام معامل proxy: httpx.Client(proxy="http://user:pass@IP:PORT", timeout=30). تستخدم الإصدارات الأقدم proxies={"all://": url}. يدعم httpx الوضع غير المتزامن (httpx.AsyncClient) إذا كنت بحاجة إلى تشغيل طلبات متزامنة.

ما هي أخطاء البروكسي الشائعة في مكتبة requests في Python؟

الأخطاء الثلاثة الشائعة هي: الخطأ 407 بسبب عدم صحة اسم المستخدم أو كلمة المرور، وانتهاء المهلة نتيجة تعذر الوصول للبروكسي، والخطأ 429 الناجم عن تجاوز حدود الطلبات للموقع المستهدف.

ProxyError … 407 Proxy Authentication Required

اسم المستخدم أو كلمة المرور غير صحيحة، أو لم يتم ترميز الرموز الخاصة.

ConnectTimeout أو ProxyError … timed out

تعذر الوصول إلى البروكسي: عنوان IP أو المنفذ غير صحيح، أو هناك حظر في الشبكة. تحقق باستخدام curl.

HTTP 429 من الموقع الوجهة

تم تجاوز حد الطلبات من الموقع المستهدف. قلل عدد الطلبات لكل IP، أضف فترات تأخير، أو وزّع الحمل عبر بروكسيات متعددة.

ليس لديك بروكسي؟ اشترِ بروكسيات مخصصة مع تفعيل تلقائي

بروكسيات IPv4 مخصصة في 9 دول تبدأ من 20.000₫/IP/شهرياً عند شراء 2.000 IP أو أكثر (39.000₫ لـ 1 IP)، بالإضافة إلى بروكسيات ISP ثابتة في فيتنام والولايات المتحدة. دعم HTTP(S) و SOCKS5 مع اسم مستخدم وكلمة مرور، باندويث غير محدود، وتفعيل تلقائي فور الدفع. بروكسيات فيتنام تدعم حالياً HTTP(S) فقط، بدون SOCKS5.

اشترِ بروكسيات الآن

الأسئلة الشائعة

هل تفرض بروكسيات ONET قيوداً على المسارات أو نقل البيانات؟+

باندويث غير محدود. عدد الطلبات التي يمكنك إرسالها إلى الموقع المستهدف يحدده ذلك الموقع نفسه؛ وتجاوزه سيؤدي إلى ظهور الخطأ 429.

هل يمكنني استخدام aiohttp؟+

نعم. مرر proxy="http://IP:PORT" و proxy_auth=aiohttp.BasicAuth(user, pass) مع كل طلب.