ProxyBroker

.. image:: https://img.shields.io/pypi/v/proxybroker.svg?style=flat-square :target: https://pypi.python.org/pypi/proxybroker/ .. image:: https://img.shields.io/travis/constverum/ProxyBroker.svg?style=flat-square :target: https://travis-ci.org/constverum/ProxyBroker .. image:: https://img.shields.io/pypi/wheel/proxybroker.svg?style=flat-square :target: https://pypi.python.org/pypi/proxybroker/ .. image:: https://img.shields.io/pypi/pyversions/proxybroker.svg?style=flat-square :target: https://pypi.python.org/pypi/proxybroker/ .. image:: https://img.shields.io/pypi/l/proxybroker.svg?style=flat-square :target: https://pypi.python.org/pypi/proxybroker/

ProxyBroker هي أداة مفتوحة المصدر تبحث بشكل غير متزامن عن بروكسيات عامة من مصادر متعددة وتختبرهم بالتزامن.

.. image:: https://raw.githubusercontent.com/constverum/ProxyBroker/master/docs/source/_static/index_find_example.gif

الميزات

• تجد أكثر من 7000 بروكسي عامل من حوالي 50 مصدرًا.
• تدعم البروتوكولات: HTTP(S) و SOCKS4/5. وأيضًا أسلوب CONNECT للمنافذ 80 و 23 (SMTP).
• يمكن تصفية البروكسيات حسب النوع، ومستوى عدم الكشف، ووقت الاستجابة، والدولة، والحالة في DNSBL.
• تعمل كخادم بروكسي يوزع الطلبات الواردة على بروكسيات خارجية. مع تدوير تلقائي للبروكسيات.
• جميع البروكسيات يتم اختبارها لدعم Cookies و Referer (وطلبات POST إذا لزم الأمر).
• تزيل البروكسيات المكررة تلقائيًا.
• غير متزامنة.

.. * حفظ البروكسيات التي تم العثور عليها في ملف بتنسيق مخصص.

المتطلبات

• بايثون 3.5 أو أعلى
• aiohttp <https://pypi.python.org/pypi/aiohttp>_
• aiodns <https://pypi.python.org/pypi/aiodns>_
• maxminddb <https://pypi.python.org/pypi/maxminddb>_

التثبيت

لتثبيت أحدث إصدار ثابت من pypi:

.. code-block:: bash

$ pip install proxybroker

يمكن تثبيت أحدث إصدار تطويري مباشرة من GitHub:

.. code-block:: bash

$ pip install -U git+https://github.com/constverum/ProxyBroker.git

الاستخدام

أمثلة CLI (واجهة الأوامر)

Find (بحث)
""""""""

ابحث عن 10 بروكسيات HTTP(S) من الولايات المتحدة بمستوى عالٍ من عدم الكشف واعرضها:

.. code-block:: bash

    $ proxybroker find --types HTTP HTTPS --lvl High --countries US --strict -l 10

.. image:: https://raw.githubusercontent.com/constverum/ProxyBroker/master/docs/source/_static/cli_find_example.gif


Grab (جلب)
""""""

ابحث واحفظ 10 بروكسيات أمريكية في ملف (بدون اختبار):

.. code-block:: bash

    $ proxybroker grab --countries US --limit 10 --outfile ./proxies.txt

.. image:: https://raw.githubusercontent.com/constverum/ProxyBroker/master/docs/source/_static/cli_grab_example.gif


Serve (تشغيل خادم)
"""""""

شغل خادم بروكسي محلي يوزع الطلبات الواردة على مجموعة من بروكسيات HTTP(S) التي تم العثور عليها بمستوى عالٍ من عدم الكشف:

.. code-block:: bash

    $ proxybroker serve --host 127.0.0.1 --port 8888 --types HTTP HTTPS --lvl High


.. image:: https://raw.githubusercontent.com/constverum/ProxyBroker/master/docs/source/_static/cli_serve_example.gif

| شغّل ``proxybroker --help`` للحصول على مزيد من المعلومات حول الخيارات المتاحة.
| شغّل ``proxybroker <command> --help`` للحصول على مزيد من المعلومات حول أمر معين.


مثال أساسي للكود

ابحث عن 10 بروكسيات HTTP(S) عاملة واعرضها:

.. code-block:: python

import asyncio
from proxybroker import Broker

async def show(proxies):
    while True:
        proxy = await proxies.get()
        if proxy is None: break
        print('Found proxy: %s' % proxy)

proxies = asyncio.Queue()
broker = Broker(proxies)
tasks = asyncio.gather(
    broker.find(types=['HTTP', 'HTTPS'], limit=10),
    show(proxies))

loop = asyncio.get_event_loop()
loop.run_until_complete(tasks)

المزيد من الأمثلة <https://proxybroker.readthedocs.io/en/latest/examples.html>_.

التوثيق

https://proxybroker.readthedocs.io/

ما سيتم إضافته (TODO)

• التحقق من وقت الاستجابة (ping)، زمن الاستجابة وسرعة نقل البيانات
• التحقق من الوصول إلى المواقع (Google، Twitter، إلخ) وحتى URLs مخصصة
• معلومات حول وقت التشغيل المتاح (uptime)
• فحص المجموع الاختباري للبيانات المرتجعة
• دعم مصادقة البروكسي
• إيجاد عنوان IP الصادر للبروكسي المتسلسل
• إمكانية تحديد عنوان البروكسي بدون منفذ (محاولة الاتصال على المنافذ الافتراضية)

المساهمة

• Fork: https://github.com/constverum/ProxyBroker/fork
• أنشئ فرع الميزة الخاص بك: git checkout -b my-new-feature
• احفظ تغييراتك: git commit -am 'Add some feature'
• ادفع إلى الفرع: git push origin my-new-feature
• أرسل طلب سحب (pull request)!

الترخيص

مرخص بموجب رخصة Apache، الإصدار 2.0

هذا المنتج يتضمن بيانات GeoLite2 المقدمة من MaxMind، والمتاحة من http://www.maxmind.com <http://www.maxmind.com>_.