## المصدر

باستخدام مترجم [Go](https://golang.org/doc/install):```bash
▶ go install -v github.com/mubeng/mubeng@latest

# الاستخدام

للاستخدام، من الضروري دائمًا توفير قائمة البروكسي الخاصة بك، سواء كانت تُستخدم للتحقق أو كمجموعة بروكسي لتدوير عنوان IP الخاص بك.

<center>
  <a href="#"><img alt="kitabisa mubeng" src="https://assets.kitploit.com/production/public/readmes/6846/00da09beb0579d8445f07b09eb977f63be93627d3e6e9ebfcb96dcaed4f3fafd.png" width="80%"></a>
</center>

## أساسي```bash
▶ mubeng [-c|-a :8080] -f file.txt [options...]

| **العلم**                       | **الوصف**                                              	|
|-------------------------------  |-------------------------------------------------------------- |
| -f, --file `<FILE>`             | ملف الوكيل.                                                   |
| -a, --address `<ADDR>:<PORT>`   | تشغيل خادم الوكيل.                                             |
| -A, --auth `<USER>:<PASS>`      | تعيين التفويض لخادم الوكيل.                           |
| -d, --daemon                    | تشغيل خادم الوكيل كخدمة.                                       |
| -c, --check                     | إجراء فحص توفر الوكيل.                                  |
| -g, --goroutine `<N>`           | أقصى عدد من الغوروتينات للاستخدام (الافتراضي: 50).            |
|     --only-cc `<AA>,<BB>`       | عرض رمز الدولة المحدد فقط (مفصول بفاصلة).            |
| -t, --timeout                   | أقصى وقت مسموح به لخادم الوكيل/الفحص (الافتراضي: 30s).      |
| -r, --rotate `<AFTER>`          | تدوير IP الوكيل بعد كل `AFTER` طلب (الافتراضي: 1).       |
|     --rotate-on-error           | تدوير IP الوكيل وإعادة محاولة طلبات HTTP الفاشلة.               |
|     --remove-on-error           | إزالة IP الوكيل من مجموعة الوكيل عند فشل طلبات HTTP.      |
|     --max-errors `<N>`          | أقصى عدد من الأخطاء المسموح بها أثناء التدوير (الافتراضي: 3).             |
|                                 | استخدم هذا مع `--rotate-on-error`.                            |
|                                 | إذا كانت القيمة أقل من 0 (مثل -1)، فسيستمر التدوير             |
|                                 | إلى أجل غير مسمى.                                        |
|     --max-redirs `<N>`          | أقصى عدد من عمليات إعادة التوجيه المسموح بها (الافتراضي: 10).                         |
|     --max-retries `<N>`         | أقصى عدد من إعادة المحاولة لطلبات HTTP الفاشلة (الافتراضي: 0).           |
| -m, --method `<METHOD>`         | طريقة التدوير (متسلسل/عشوائي) (الافتراضي: متسلسل).          |
| -s, --sync                      | المزامنة ستنتظر حتى يكتمل الطلب السابق.          |
| -v, --verbose                   | إظهار طلبات/استجابات HTTP أو عرض الوكلاء المعطلين عند الفحص.      |
| -o, --output `<FILE>`           | حفظ المخرجات من خادم الوكيل أو الفحص المباشر.                  |
| -u, --update                    | تحديث mubeng إلى أحدث إصدار مستقر.                   |
| -w, --watch                     | مراقبة ملف الوكيل، إعادة تحميل مباشر من التغييرات.                   |
| -V, --version                   | عرض إصدار mubeng الحالي.                                  |

<table>
	<td>
		<h4>ملاحظات:</h4>
		<ul>
			<li>يتم حساب عمليات التدوير لجميع الطلبات، حتى لو فشل الطلب.
				<!-- <ul>
					<li>الدوران تراكمي يبدأ من بداية القائمة.</li>
					<li>التدوير يعني عشوائيًا، <b>ليس</b> اختيار وكيل بعد/تراكم من مجموعة الوكيل. لا نضع شروطًا إذا تم استخدام وكيل. لذلك، لا يوجد ضمان بأن طلبك سيصل إلى القيمة <i>N</i> <code>(-r/--rotate)</code> وسيتم تدوير IP الوكيل الخاص بك.</li>
				</ul> -->
			</li>
			<li>يعمل خادم الوكيل بشكل غير متزامن افتراضيًا، لذلك لا يضمن أن طلباتك بعد <i>N</i> (أي <i>N+1</i> وهكذا) ستدور IP الوكيل، بدلاً من ذلك استخدم العلامة <code>-s/--sync</code> لانتظار اكتمال الطلبات إلى الوكيل السابق.</li>
			<li>وضع الخدمة <code>(-d/--daemon)</code> سيقوم بتثبيت mubeng كخدمة على نظام (Linux/OSX) / إعداد رد الاتصال (Windows).
				<ul>
					<li>وبالتالي يمكنك التحكم في الخدمة باستخدام أوامر <code>journalctl</code> أو <code>service</code> أو <code>net</code> (لنظام Windows) لبدء/إيقاف خادم الوكيل.</li>
					<li>عند تفعيل وضع الخدمة، يعمل عن طريق إيقاف وإلغاء تثبيت خدمة mubeng الحالية بالقوة، ثم إعادة التثبيت وتشغيلها كخدمة.</li>
				</ul>
			</li>
			<li>وضع الإسهاب <code>(-v/--verbose)</code> والمهلة <code>(-t/--timeout)</code> ينطبقان على كل من فحص الوكيل وإجراءات تدوير IP الوكيل.</li>
			<li>يتم عرض طلبات واستجابات حركة مرور HTTP عند تمكين وضع الإسهاب <code>(-v/--verbose)</code>، ولكن
				<ul>
					<li>نحن <b>لا</b> نعرض بشكل صريح نص الطلب/الاستجابة، و</li>
					<li>سيتم حذف جميع قيم ملفات تعريف الارتباط في الرؤوس تلقائيًا.</li>
				</ul>
			</li>
			<li>إذا كنت تستخدم خيار الإخراج <code>(-o/--output)</code> لتشغيل مدور IP الوكيل، فسيتم <b>عدم</b> كتابة رؤوس الطلب/الاستجابة إلى ملف السجل.</li>
			<li>قيمة خيار المهلة <code>(-t/--timeout)</code> هي سلسلة محتملة من الأرقام العشرية مع أو بدون علامة، كل منها بجزء كسري اختياري ولاحقة وحدة، مثل "5s" أو "300ms" أو "-1.5h" أو "2h45m".
				<ul>
					<li>وحدات الوقت الصالحة هي "ns" و "us" (أو "µs") و "ms" و "s" و "m" و "h".</li>
				</ul>
			</li>
			<li>الحد الأقصى للأخطاء <code>(--max-errors)</code> ≠ الحد الأقصى لإعادة المحاولة <code>(--max-retries)</code>.</li>
			<ul>
					<li>الحد الأقصى لإعادة المحاولة <code>(--max-retries)</code> ينطبق على إعادة محاولة طلب HTTP فاشل بنفس الوكيل.</li>
					<li>في حين يشير الحد الأقصى للأخطاء <code>(--max-errors)</code> إلى إجمالي طلبات HTTP الفاشلة من الوكلاء المستخدمين.</li>
					<li>على سبيل المثال، بمجرد الوصول إلى الحد الأقصى لإعادة المحاولة <code>(--max-retries)</code> <i>(إذا تم توفيره)</i>، يتم حساب الخطأ، وسيتم تدوير IP الوكيل لنفس طلب HTTP الفاشل حتى يتم الوصول إلى الحد الأقصى للأخطاء <code>(--max-errors)</code>، بينما الحد الأقصى لإعادة المحاولة <code>(--max-retries)</code> <b>لا</b> يؤدي إلى تدوير الوكيل.</li>
				</ul>
			<li>إذا كانت قيمة الحد الأقصى للأخطاء <code>(--max-errors)</code> أقل من <b>0</b> (مثل <b>-1</b>)، فسيستمر التدوير إلى أجل غير مسمى.</li>
		</ul>
	</td>
</table>

## تثبيت شهادة SSL

يستخدم mubeng هيئة شهادات مدمجة بواسطة [GoProxy](https://github.com/elazarl/goproxy). مع تشغيل خادم وكيل mubeng، يمكن تصدير الشهادة المولدة عن طريق زيارة `http://mubeng/cert` في متصفح.

خطوات تثبيت شهادة CA مشابهة [لأدوات الوكيل الأخرى](https://portswigger.net/burp/documentation/desktop/external-browser-config/certificate).

## أمثلة

على سبيل المثال، لديك مجموعة وكيل `(proxies.txt)` كالتالي:

<table>
	<td>
		<pre>http://127.0.0.1:8080
https://127.0.0.1:443
socks4://127.0.0.1:4145
socks5://127.0.0.1:2121
...
...</pre>
	</td>
</table>

> لأننا نستخدم نقل التبديل التلقائي، يمكن أن يقبل `mubeng` مخططات بروتوكول وكيل متعددة في وقت واحد.<br>
> يرجى الرجوع إلى [التوثيق](https://pkg.go.dev/github.com/mubeng/mubeng/pkg/mubeng#Transport) لهذه الحزمة.

### فاحص الوكيل

مرر علامة `--check` في الأمر لإجراء فحوصات الوكيل:```bash
▶ mubeng -f proxies.txt --check --only-cc AU,US,UK --output live.txt

**متغيرات القالب المتاحة:**

| المتغير | الوصف | مثال |
|---------|-------|------|
| `{{proxy}}` | عنوان الوكيل الكامل | `http://192.168.1.1:8080` |
| `{{protocol}}` | بروتوكول الوكيل | `http`, `https`, `socks5` |
| `{{host}}` | مضيف الوكيل/عنوان IP | `192.168.1.1` |
| `{{port}}` | منفذ الوكيل | `8080` |
| `{{ip}}` | عنوان IP الخارجي | `203.0.113.1` |
| `{{country}}` | رمز الدولة | `US`, `UK`, `AU` |
| `{{city}}` | اسم المدينة | `New York`, `London` |
| `{{org}}` | المؤسسة/مزود الخدمة | `Google Inc.` |
| `{{region}}` | المنطقة/الولاية | `California`, `England` |
| `{{timezone}}` | المنطقة الزمنية | `America/New_York` |
| `{{loc}}` | خط العرض، خط الطول | `40.7128,-74.0060` |
| `{{hostname}}` | اسم المضيف | `example.com` |
| `{{duration}}` | زمن الاستجابة | `245ms` |

**أمثلة:**```bash
# JSON-like format
▶ mubeng -f proxies.txt --check --output-format '{"proxy":"{{proxy}}","country":"{{country}}","duration":"{{duration}}"}'

# CSV format
▶ mubeng -f proxies.txt --check --output-format "{{proxy}},{{country}},{{city}},{{duration}}"

# Custom detailed format
▶ mubeng -f proxies.txt --check --output-format "[{{country}}] {{proxy}} ({{org}}) - {{duration}}"

العلامة `-r` _(--rotate)_ تقوم بتدوير IP الخاص بك لكل قيمة طلب _N_ تقدمها `(10)`، والعلامة `-m` _(--method)_ ستقوم بتدوير البروكسي بشكل تسلسلي/عشوائي.

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/6846/add87f63071a7416cb66f40df56dcace5e9461cc80e0c2b0abadacd74114316d.png">
  <i>(الشكل: تشغيل mubeng كمُدور IP للبروكسي مع وضع المفصل)</i>
</p>

### [Burp Suite](https://portswigger.net/burp/documentation/desktop/getting-started/installing-burp) البروكسي العلوي

في حال أردت استخدام `mubeng` _(مُدور IP للبروكسي)_ كبروكسي علوي في Burp Suite، بحيث يعمل كوسيط بين Burp Suite وmubeng إلى الإنترنت، فلا تحتاج إلى أي إضافات إضافية في Burp Suite لذلك. لتوضيح ذلك:

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/6846/be07464247cdef251240ecc10ac0515484489bf1e5b1f3a4e44c7bf5d1bb2461.jpg">
  <i>(الشكل: إعدادات البروكسي العلوي في Burp Suite إلى mubeng)</i>
</p>

في نسخة Burp Suite الخاصة بك، اختر قائمة **Project options**، ثم انقر على علامة التبويب **Connections**. في قسم **Upstream Proxy Servers**، حدد **Override user options** ثم اضغط على زر **Add** لإضافة قاعدة البروكسي العلوي. بعد ذلك، املأ الأعمدة المطلوبة _(Destination host, Proxy host & Proxy port)_ بالتفاصيل الصحيحة. انقر على **OK** لحفظ الإعدادات.

### [OWASP ZAP](https://www.zaproxy.org/download/) سلسلة البروكسي

يعمل بنفس الطريقة عند استخدام بروكسي علوي. يسمح لك OWASP ZAP بالاتصال ببروكسي آخر للاتصالات الصادرة في جلسة OWASP ZAP. لربطها مع خادم بروكسي mubeng:

<p align="center">
	<img src="https://assets.kitploit.com/production/public/readmes/6846/0f8ad5ce8fa502cd51c61f9be5eea8119176df378502ada3c34b89469276bc1d.png">
	<i>(الشكل: إعدادات اتصال سلسلة البروكسي في OWASP ZAP إلى mubeng)</i>
</p>

اختر **Tools** في شريط القائمة في نافذة جلسة ZAP الخاصة بك، ثم اختر القائمة الفرعية **Options** _(اختصار: Ctrl+Alt+O)_، وانتقل إلى قسم **Connection**. في تلك النافذة، انتقل إلى جزء **Use proxy chain** ثم حدد **Use an outgoing proxy server**. بعد ذلك، املأ الأعمدة المطلوبة _(Address/Domain Name & Port)_ بالتفاصيل الصحيحة. انقر على **OK** لحفظ الإعدادات.

### تنسيق البروكسي

حاليًا يدعم mubeng بروتوكول HTTP(S) و SOCKSv4(A)/v5، انظر [الأمثلة](#examples) أعلاه. ولكن ليس مقتصرًا على ذلك، نحن ندعم أيضًا استبدال سلسلة البروكسي ووظائف مساعدة لمجموعة البروكسي الخاصة بك.

#### القوالب

إذا كان لديك بروكسي مصادق عليه، فبالتأكيد لا تريد كتابة بيانات الاعتماد باستمرار في ملف مجموعة البروكسي. يمكن لـ **mubeng** تقييم متغير البيئة بنمط الكتابة `{{VARIABLE}}`.

على سبيل المثال:

1. استبدال السلسلة```console
$ export USERNAME="FOO"
$ export PASSWORD="BAR"
$ echo "http://{{USERNAME}}:{{PASSWORD}}@192.168.0.1:31337" > list.txt
$ mubeng -f list.txt -a :8080

#### بوابة API لأمازون

يدعم مُدور البروكسي mubeng أيضًا التكامل مع بوابة API لأمازون. يتيح لك ذلك توجيه حركة المرور عبر مناطق AWS متعددة لتعزيز التكرار والتوزيع الجغرافي.

تنسيق سلاسل البروكسي لـ AWS:```
aws://AWS_ACCESS_KEY_ID:AWS_SECRET_ACCESS_KEY@REGION

2. أنشئ ملف قائمة proxy يحتوي على مناطق AWS

قم بإنشاء إدخالات proxy لمناطق AWS متعددة:```bash
echo "aws://{{AWS_ACCESS_KEY_ID}}:{{AWS_SECRET_ACCESS_KEY}}@"{us,eu}"-"{east,west}"-"{1,2} | tr ' ' '\n' > list.txt

يتيح هذا الإعداد لـ mubeng تدوير حركة المرور تلقائيًا عبر مناطق AWS متعددة عبر API Gateway. عند تشغيل خادم الوكيل، سيقوم mubeng باستبدال بيانات اعتماد AWS الخاصة بك ديناميكيًا من متغيرات البيئة باستخدام ميزة [القوالب](#templating) الموضحة أعلاه.

> [!NOTE]
> تأكد من أن بيانات اعتماد AWS الخاصة بك تمتلك الأذونات المناسبة للوصول إلى API Gateway في المناطق المحددة.

# القيود

حاليًا، يعمل تدوير عنوان IP على تشغيل خادم الوكيل فقط كبروتوكول HTTP، وليس بروتوكول SOCKSv4(A)/v5، على الرغم من أن المورد الذي لديك هو SOCKSv4(A)/v5. بمعنى آخر، يتم استخدام مورد SOCKSv4(A)/v5 الذي تقدمه بشكل صحيح لأنه يستخدم النقل التلقائي على العميل، لكن خادم الوكيل هذا **لا يقوم** بالتبديل إلى أي شيء آخر غير بروتوكول HTTP.

# المساهمون

[![contributions](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/mubeng/mubeng/issues)

هذا المشروع موجود بفضل جميع الأشخاص الذين يساهمون. لمعرفة كيفية إعداد بيئة تطوير وللحصول على إرشادات المساهمة، راجع [CONTRIBUTING.md](https://github.com/mubeng/mubeng/blob/master/.github/CONTRIBUTING.md).

<a href="https://github.com/mubeng/mubeng/graphs/contributors">
	<img src="https://raw.githubusercontent.com/mubeng/mubeng/HEAD/.github/CONTRIBUTORS.svg">
</a>

# النطق

[`jv_ID`](https://www.localeplanet.com/java/jv-ID/index.html) • **/mo͞oˌbēNG/** — mubeng-mubeng nganti mumet. (ꦩꦸꦧꦺꦁ​ꦔꦤ꧀ꦠꦶ​ꦩꦸꦩꦺꦠ꧀)

# التغييرات

للتغييرات، راجع [CHANGELOG.md](https://github.com/mubeng/mubeng/blob/master/CHANGELOG.md).

# الترخيص

هذا البرنامج هو برنامج مجاني: يمكنك إعادة توزيعه و/أو تعديله بموجب شروط [ترخيص Apache](https://github.com/mubeng/mubeng/blob/master/LICENSE). mubeng وأي مساهمات هي حقوق نشر © لـ Dwi Siswanto 2021-2025.