Skip to content

Commit cadbce0

Browse files
authored
Add Chain Proxy Builder details to README-fa.md
Added Chain Proxy Builder section with features and usage instructions.
1 parent beaa19b commit cadbce0

1 file changed

Lines changed: 118 additions & 62 deletions

File tree

README-fa.md

Lines changed: 118 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -1,81 +1,137 @@
1-
<div dir="rtl" align="right">
1+
# Chain Proxy Builder
2+
3+
یک وب‌اپلیکیشن قدرتمند و مستقل برای ترکیب دو کانفیگ پراکسی به یک کانفیگ واحد **Xray** یا **Sing-box**. این ابزار به‌طور ویژه طراحی شده تا با ترکیب چندین لایه پراکسی، پایداری اتصال را افزایش داده و امکان استفاده از آی‌پی ثابت را فراهم کند.
4+
5+
## 🚀 ویژگی‌ها
6+
7+
- **ترکیب دوگانه کانفیگ**: به‌راحتی یک پراکسی اولیه (مانند Worker/CDN) را با یک پراکسی زنجیره‌ای (Chain Proxy) ترکیب کنید.
8+
- **پشتیبانی از پروتکل‌ها**: پشتیبانی از **VLESS**، **VMess**، **Trojan**، **Shadowsocks**، **SOCKS**، **HTTP** و **SSH**.
9+
- **خروجی دوگانه**: تولید کانفیگ JSON برای هر دو کلاینت **Xray** و **Sing-box**.
10+
- **پشتیبانی از ECH**: استخراج و افزودن خودکار تنظیمات ECH برای اتصالی امن‌تر.
11+
- **پردازش سمت کاربر**: تمام پردازش‌ها درون مرورگر شما انجام می‌شود. هیچ داده‌ای به سروری ارسال نمی‌گردد.
12+
13+
## 📦 فرمت‌های خروجی
14+
15+
<table dir="rtl" width="100%" style="direction: rtl; text-align: right;">
16+
<thead>
17+
<tr>
18+
<th align="right">خروجی</th>
19+
<th align="right">کلاینت</th>
20+
</tr>
21+
</thead>
22+
<tbody>
23+
<tr>
24+
<td><b>Xray JSON</b></td>
25+
<td>قابل استفاده در تمام کلاینت‌های سازگار با Xray&rlm; (مانند v2rayN&rlm;، v2rayNG&rlm;، Nekoray&rlm; و غیره).</td>
26+
</tr>
27+
<tr>
28+
<td><b>Sing-box JSON</b></td>
29+
<td>دارای زیر-تب‌های تخصصی برای کلاینت‌های مختلف (بخش پایین را ببینید).</td>
30+
</tr>
31+
</tbody>
32+
</table>
33+
34+
### 📦 فرمت‌های تخصصی Sing-box
35+
<ul dir="rtl" style="direction: rtl; text-align: right;">
36+
<li><b>Standard</b>: کانفیگ استاندارد هسته Sing-box.</li>
37+
<li><b>Nekoray</b>: بهینه‌سازی شده برای حداکثر سازگاری با <b>Nekoray</b>.</li>
38+
<li><b>Nekobox (Android)</b>: مخصوص اندروید؛ دارای <b>رابط مجازی TUN</b> برای شناسایی صحیح VPN در سیستم‌عامل (نمایش آیکون کلید) و پایداری بیشتر در شبکه موبایل.</li>
39+
</ul>
240

3-
# کلاینت اندروید MasterDnsVPN
41+
## 🔗 شیوه کار خروجی‌ها
442

5-
یک کلاینت اندروید برای اکوسیستم **MasterDnsVPN**.
43+
این ابزار کانفیگی تولید می‌کند که ترافیک شما را به این ترتیب مسیریابی می‌کند:
644

7-
<p align="right">
8-
<b>پروژه اصلی (Upstream)</b>: <a href="https://github.com/masterking32/MasterDnsVPN">MasterDnsVPN</a><br>
9-
<b>توضیح</b>: این ریپو شامل اپ اندروید (کلاینت) است که روی هسته‌ی Go پروژه اصلی ساخته شده است.
45+
<p dir="rtl" align="center" style="direction: rtl;">
46+
<code>شما ⬅️ کانفیگ ۱ (پراکسی اولیه) ⬅️ کانفیگ ۲ (Chain) ⬅️ اینترنت</code>
1047
</p>
1148

12-
---
49+
این ساختار تضمین می‌کند که آی‌پی خروجی و نهایی شما همان آی‌پی <b>کانفیگ ۲ (Chain Proxy&rlm;)</b> باشد، که هویتی ثابت و پایدار برای وب‌سایت‌هایی که از آنها بازدید می‌کنید، فراهم می‌آورد.
1350

14-
## 📥 دانلود و نصب
51+
## 🛠️ نحوه استفاده
1552

16-
<ol>
17-
<li>به بخش <b><a href="https://github.com/YOUR_USERNAME/MasterDnsVPN-Android/releases">Releases</a></b> در همین ریپوزیتوری بروید.</li>
18-
<li>آخرین فایل <b><code>universal</code></b> APK را دانلود کنید (پیشنهادی).</li>
19-
<li>فایل را روی گوشی خود نصب کنید.</li>
53+
<ol dir="rtl" style="direction: rtl; text-align: right;">
54+
<li><b>کانفیگ ۱</b>: لینک پراکسی اول خود را جای‌گذاری کنید (این کانفیگ می‌تواند یک Cloudflare Worker&rlm;، CDN&rlm; یا هر پراکسی مشابهی باشد).</li>
55+
<li><b>کانفیگ ۲</b>: لینک پراکسی دوم که می‌خواهید ترافیک از آن عبور کند، جای‌گذاری نمایید.
56+
<ul>
57+
<li>برای <b>SSH</b>، روی دکمه 🔑 SSH کلیک کنید و مشخصات سرور، پورت، نام کاربری و رمز عبور را وارد نمایید.</li>
58+
</ul>
59+
</li>
60+
<li><b>تنظیمات</b>: در صورت نیاز، سرور DNS&rlm; یا پورت SOCKS&rlm; را تغییر دهید.</li>
61+
<li><b>تولید خروجی</b>: روی "Generate Chained Config" (تولید کانفیگ زنجیره‌ای) کلیک کنید تا JSON&rlm; شما آماده شود.</li>
62+
<li><b>استفاده در کلاینت</b>: کد JSON&rlm; را کپی کرده یا به‌صورت فایل دانلود کنید و در کلاینت دلخواه خود استفاده نمایید.</li>
2063
</ol>
2164

22-
> **نکته:** اگر اندروید اجازه نصب نداد، گزینه‌ی <b>Install unknown apps</b> را برای مرورگر یا فایل‌منیجر خود فعال کنید.
23-
24-
---
25-
26-
## 🚀 شروع سریع (داخل اپ)
27-
28-
برای استفاده، باید یک سرور MasterDnsVPN فعال داشته باشید (دامنه + کلید). داخل اپ، فیلدهای زیر را وارد کنید:
29-
30-
<ul>
31-
<li><b><code>DOMAINS</code></b>: دامنه تونل (مثال: <code>v.example.com</code>)</li>
32-
<li><b><code>ENCRYPTION_KEY</code></b>: کلید مشترک که در سمت سرور تنظیم شده است.</li>
33-
<li><b>Resolverها</b>: یک یا چند DNS resolver (به شکل IP یا IP:PORT)</li>
65+
## 📋 پروتکل‌های پشتیبانی‌شده
66+
67+
<table dir="rtl" width="100%" style="direction: rtl; text-align: right;">
68+
<thead>
69+
<tr>
70+
<th align="right">پروتکل</th>
71+
<th align="right">فرمت لینک</th>
72+
<th align="right">توضیحات</th>
73+
</tr>
74+
</thead>
75+
<tbody>
76+
<tr>
77+
<td><b>VLESS</b></td>
78+
<td dir="ltr" align="left"><code>vless://uuid@server:port?params</code></td>
79+
<td>پشتیبانی کامل</td>
80+
</tr>
81+
<tr>
82+
<td><b>VMess</b></td>
83+
<td dir="ltr" align="left"><code>vmess://base64-json</code></td>
84+
<td>پشتیبانی کامل</td>
85+
</tr>
86+
<tr>
87+
<td><b>Trojan</b></td>
88+
<td dir="ltr" align="left"><code>trojan://password@server:port?params</code></td>
89+
<td>پشتیبانی کامل</td>
90+
</tr>
91+
<tr>
92+
<td><b>Shadowsocks</b></td>
93+
<td dir="ltr" align="left"><code>ss://base64(method:pass)@server:port</code></td>
94+
<td>عدم پشتیبانی از transport&rlm; (مانند ws&rlm;، grpc&rlm; و غیره) و همچنین فاقد پشتیبانی از TLS&rlm;.</td>
95+
</tr>
96+
<tr>
97+
<td><b>SOCKS</b></td>
98+
<td dir="ltr" align="left"><code>socks://user:pass@server:port</code></td>
99+
<td>باید شامل نام کاربری و رمز عبور باشد.</td>
100+
</tr>
101+
<tr>
102+
<td><b>HTTP</b></td>
103+
<td dir="ltr" align="left"><code>http://user:pass@server:port</code></td>
104+
<td>باید شامل نام کاربری و رمز عبور باشد.</td>
105+
</tr>
106+
<tr>
107+
<td><b>SSH</b></td>
108+
<td>دارای ۴ فیلد (سرور، پورت، نام کاربری، رمز عبور)</td>
109+
<td><b>فقط برای Sing-box&rlm;</b> — توسط Xray&rlm; پشتیبانی نمی‌شود.</td>
110+
</tr>
111+
</tbody>
112+
</table>
113+
114+
## ⚠️ نکات مهم
115+
116+
<ul dir="rtl" style="direction: rtl; text-align: right;">
117+
<li>کانفیگ‌های <b>SOCKS</b> و <b>HTTP</b> باید حتماً دارای <b>نام کاربری و رمز عبور</b> باشند.</li>
118+
<li>هسته <b>Xray</b> از کانفیگ‌های <b>raw</b> (بدون هدر TCP&rlm;) پشتیبانی نمی‌کند؛ به‌جای آن باید از TCP&rlm; با هدر http&rlm; استفاده کرد.</li>
119+
<li>کانفیگ‌های <b>Shadowsocks</b> نمی‌توانند هیچ نوع transport&rlm; (مانند WebSocket&rlm;، gRPC&rlm;، HTTPUpgrade&rlm; و غیره) داشته باشند و فاقد قابلیت TLS&rlm; هستند.</li>
120+
<li>پروتکل <b>SSH</b> تنها توسط <b>Sing-box</b> پشتیبانی می‌شود. زمانی که از SSH&rlm; استفاده می‌کنید، تب مربوط به Xray&rlm; به‌صورت خودکار غیرفعال خواهد شد. برای استفاده از آن، لطفاً کلاینت <a href="https://sing-box.sagernet.org/">sing-box&rlm;</a> را به کار ببرید.</li>
34121
</ul>
35122

36-
سپس دکمه اتصال را بزنید تا VPN روشن شود.
37-
38-
---
123+
## 🔧 انتقال‌های (Transports) پشتیبانی‌شده
39124

40-
## 🛠 این اپ چه کاری انجام می‌دهد؟
125+
TCP، TCP (http header)، WebSocket، gRPC، HTTPUpgrade
41126

42-
<ul>
43-
<li>یک سرویس VPN سیستمی در اندروید ایجاد کرده و ترافیک را از تونل MasterDnsVPN عبور می‌دهد.</li>
44-
<li>بسته به تنظیمات، می‌تواند حالت پروکسی (SOCKS/TCP) را برای عبور ترافیک فراهم کند.</li>
45-
</ul>
127+
## 🔒 پروتکل‌های رمزنگاری (TLS) پشتیبانی‌شده
46128

47-
---
129+
TLS، Reality، None
48130

49-
## 🛡 نکات امنیتی
131+
## 🛡️ منابع الهام‌بخش (Credits)
50132

51-
<ul>
52-
<li><b>منبع معتبر:</b> APK را فقط از بخش <b>Releases</b> همین ریپوزیتوری رسمی نصب کنید.</li>
53-
<li><b>محرمانگی:</b> کلید رمزگذاری (Encryption Key) سرور خود را هرگز در اختیار دیگران قرار ندهید.</li>
54-
<li><b>اشتراک‌گذاری:</b> اگر اسکرین‌شاتی از تنظیمات برای عیب‌یابی می‌فرستید، حتماً روی کلید و دامنه‌ها را بپوشانید.</li>
55-
</ul>
133+
این پروژه از منطق و ساختار پروژه متن‌باز [BPB-Worker-Panel](https://github.com/bia-pain-bache/BPB-Worker-Panel) و این [ تنظیمات Sing-box](https://gist.github.com/alireza-delavari/62e56af0d59c92b5b1798f1442f90f61) ایده گرفته است.
56134

57135
---
136+
توسعه‌یافته با ❤️ برای حریم خصوصی شما.
58137

59-
## 🔍 عیب‌یابی
60-
61-
<ul>
62-
<li><b>خطای نصب (App not installed):</b> اگر قبلاً نسخه‌ای با امضای متفاوت نصب کرده‌اید، ابتدا آن را پاک کرده و سپس نسخه جدید را نصب کنید.</li>
63-
<li><b>اتصال برقرار است اما اینترنت نیست:</b> مقدار <code>DOMAINS</code>، لیست resolverها و کانفیگ سمت سرور را مجدداً بررسی کنید.</li>
64-
<li><b>خاموش شدن خودکار VPN:</b> تنظیمات بهینه‌سازی باتری (Battery Optimization) را برای این اپلیکیشن غیرفعال کنید.</li>
65-
</ul>
66-
67-
---
68-
69-
## ⚖️ لایسنس
70-
71-
این پروژه تحت لایسنس **MIT** منتشر شده است. برای اطلاعات بیشتر فایل `LICENSE` را مطالعه کنید.
72-
73-
---
74-
75-
## 🤝 قدردانی
76-
77-
این کلاینت بر پایه پروژه قدرتمند MasterDnsVPN توسعه یافته است:
78-
<br>
79-
<a href="https://github.com/masterking32/MasterDnsVPN">https://github.com/masterking32/MasterDnsVPN</a>
80-
81-
</div>

0 commit comments

Comments
 (0)