Enhance README and documentation with Telegram channel and acknowledgments, improve formatting and clarity

This commit is contained in:
Abolfazl
2026-05-09 05:51:48 +03:30
parent 188909ab8b
commit 7739acc97a
5 changed files with 69 additions and 63 deletions
+22 -19
View File
@@ -2,6 +2,10 @@
**زبان:** [English](README.md) | فارسی
**کانال تلگرام 📣:** [https://t.me/masterdnsvpn](https://t.me/masterdnsvpn)
**تشکر ویژه ❤️:** [Abolix](https://github.com/abolix)
MasterHttpRelayVPN یک پراکسی محلی است که ترافیک مرورگر را از مسیر Google Apps Script و Domain Fronting عبور می‌دهد. برای مسیر ساده فقط همین پروژه و یک اکانت رایگان Google کافی است. اگر بعضی سایت‌ها خروجی Google را مسدود کنند، بعدا می‌توانید Exit Node اضافه کنید.
```text
@@ -9,32 +13,31 @@ MasterHttpRelayVPN یک پراکسی محلی است که ترافیک مرور
فیلتر فقط اتصال شبیه Google را می‌بیند
```
## منوی سریع
## منوی سریع 🧭
[شروع سریع](docs/fa/GETTING_STARTED.md) | [Docker](docs/fa/DOCKER.md) | [اشتراک گذاری LAN](docs/fa/LAN_SHARING.md) | [راهنمای Exit Node](docs/exit-node/EXIT_NODE_DEPLOYMENT_FA.md)
[مرجع تنظیمات](docs/fa/CONFIGURATION.md) | [رفع مشکل](docs/fa/TROUBLESHOOTING.md) | [نکات امنیتی](docs/fa/SECURITY.md) | [معماری](docs/fa/ARCHITECTURE.md)
## شروع خیلی سریع
## شروع خیلی سریع
قبل از اجرای پراکسی، باید یک بار رله Google را deploy کنید. فقط یک اکانت Google لازم دارید و این کار حدود دو دقیقه زمان می‌برد.
## ساخت رله Google
## ساخت رله Google ☁️
1. وارد [Google Apps Script](https://script.google.com/) شوید.
2. روی **New project** کلیک کنید.
3. محتوای پیش‌فرض ادیتور را کامل پاک کنید.
4. فایل [apps_script/Code.gs](apps_script/Code.gs) را باز کنید، همه کد آن را کپی کنید، و داخل Apps Script قرار دهید.
5. این خط را پیدا کنید و با یک رمز طولانی و مخصوص خودتان عوض کنید:
- وارد [Google Apps Script](https://script.google.com/) شوید و روی **New project** کلیک کنید.
- محتوای پیش‌فرض ادیتور را کامل پاک کنید.
- فایل [apps_script/Code.gs](apps_script/Code.gs) را باز کنید، همه کد آن را کپی کنید، و داخل Apps Script قرار دهید.
- این خط را پیدا کنید و با یک رمز طولانی و مخصوص خودتان عوض کنید:
```javascript
const AUTH_KEY = "your-secret-password-here";
```
6. از مسیر **Deploy** -> **New deployment** -> **Web app** بروید.
7. گزینه **Execute as** را روی **Me** بگذارید.
8. گزینه **Who has access** را روی **Anyone** بگذارید.
9. روی **Deploy** کلیک کنید، دسترسی‌ها را تایید کنید، و **Deployment ID** را کپی کنید.
- از مسیر **Deploy** -> **New deployment** -> **Web app** بروید.
- گزینه **Execute as** را روی **Me** بگذارید.
- گزینه **Who has access** را روی **Anyone** بگذارید.
- روی **Deploy** کلیک کنید، دسترسی‌ها را تایید کنید، و **Deployment ID** را کپی کنید.
این دو مقدار را برای setup wizard نگه دارید:
@@ -54,10 +57,10 @@ cd MasterHttpRelayVPN
**گزینه B: ZIP**
1. [صفحه GitHub پروژه](https://github.com/masterking32/MasterHttpRelayVPN) را باز کنید.
2. روی **Code** -> **Download ZIP** کلیک کنید.
3. فایل ZIP را extract کنید.
4. داخل پوشه extract شده `MasterHttpRelayVPN` یک terminal باز کنید.
- [صفحه GitHub پروژه](https://github.com/masterking32/MasterHttpRelayVPN) را باز کنید.
- روی **Code** -> **Download ZIP** کلیک کنید.
- فایل ZIP را extract کنید.
- داخل پوشه extract شده `MasterHttpRelayVPN` یک terminal باز کنید.
بعد برنامه را اجرا کنید:
@@ -87,20 +90,20 @@ chmod +x start.sh
برای سایت‌های HTTPS، اگر برنامه نتوانست گواهی را خودکار نصب کند، فایل `ca/ca.crt` را نصب کنید. راهنمای کامل در [شروع سریع](docs/fa/GETTING_STARTED.md) است.
## قدم‌های بعدی رایج
## قدم‌های بعدی رایج 🛠️
- اگر مرورگر خطای certificate نشان می‌دهد، [بخش خطای گواهی](docs/fa/TROUBLESHOOTING.md#خطاهای-certificate) را ببینید.
- اگر خطای `unauthorized` می‌بینید، مقدار `AUTH_KEY` در [apps_script/Code.gs](apps_script/Code.gs) باید دقیقا با `auth_key` در `config.json` یکی باشد.
- اگر سرعت پایین است یا timeout می‌گیرید، دستور `python main.py --scan` را اجرا کنید و [مرجع تنظیمات](docs/fa/CONFIGURATION.md#دستورهای-عیب‌یابی) را ببینید.
- اگر سایت‌هایی مثل ChatGPT یا Turnstile با خروجی Google مشکل دارند، [راهنمای Exit Node](docs/exit-node/EXIT_NODE_DEPLOYMENT_FA.md) را بخوانید.
## پشتیبانی و اطلاع‌رسانی
## پشتیبانی و اطلاع‌رسانی 📣
- کانال Telegram: [https://t.me/masterdnsvpn](https://t.me/masterdnsvpn)
- کلاینت Windows: [MHRWindowsApp](https://github.com/AriPath/MHRWindowsApp)
- منبع فیلتر تبلیغات: [PersianBlocker](https://github.com/MasterKia/PersianBlocker/)
## امنیت
## امنیت 🔒
این پروژه برای آموزش، تست و پژوهش ارائه شده است. مسئولیت رعایت قوانین و شرایط سرویس‌ها با کاربر است. فایل `config.json`، مقدار `auth_key`، پوشه `ca/`، و آدرس Exit Node همراه با PSK معتبر را با کسی به اشتراک نگذارید. قبل از فعال کردن استفاده در شبکه محلی، [نکات امنیتی](docs/fa/SECURITY.md) را بخوانید.