mirror of
https://github.com/masterking32/MasterHttpRelayVPN.git
synced 2026-05-17 21:24:37 +03:00
Abolfazl
70bbcf217f
- Introduced ARCHITECTURE.md to outline the system architecture and flow. - Created CONFIGURATION.md detailing configuration options and their meanings. - Added DOCKER.md for Docker setup instructions and usage. - Developed GETTING_STARTED.md to guide users through initial setup and usage. - Included LAN_SHARING.md to explain how to enable LAN sharing for the proxy. - Established SECURITY.md to highlight security practices and responsibilities. - Compiled TROUBLESHOOTING.md to assist users in resolving common issues. - Translated documentation into Persian, including ARCHITECTURE.md and CONFIGURATION.md.
96 lines
5.1 KiB
Markdown
96 lines
5.1 KiB
Markdown
# MasterHttpRelayVPN
|
|
|
|
**زبان:** [English](README.md) | فارسی
|
|
|
|
MasterHttpRelayVPN یک پراکسی محلی است که ترافیک مرورگر را از مسیر Google Apps Script و Domain Fronting عبور میدهد. برای مسیر ساده فقط همین پروژه و یک اکانت رایگان Google کافی است. اگر بعضی سایتها خروجی Google را مسدود کنند، بعدا میتوانید Exit Node اضافه کنید.
|
|
|
|
```text
|
|
مرورگر -> پراکسی محلی -> مسیر Google -> رله Apps Script شما -> سایت مقصد
|
|
فیلتر فقط اتصال شبیه Google را میبیند
|
|
```
|
|
|
|
## مسیر موردنیازتان را انتخاب کنید
|
|
|
|
| میخواهید... | اینجا را بخوانید |
|
|
|-------------|------------------|
|
|
| برای اولین بار راهاندازی کنید | [شروع سریع](docs/fa/GETTING_STARTED.md) |
|
|
| با Docker اجرا کنید | [راهنمای Docker](docs/fa/DOCKER.md) |
|
|
| پراکسی را در شبکه محلی به اشتراک بگذارید | [اشتراکگذاری LAN](docs/fa/LAN_SHARING.md) |
|
|
| برای سایتهای حساس Exit Node بگذارید | [راهنمای 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 را از فایل [apps_script/Code.gs](apps_script/Code.gs) در Google Apps Script deploy کنید و این دو مقدار را آماده داشته باشید:
|
|
|
|
- `Deployment ID` از Google Apps Script
|
|
- `AUTH_KEY`، یک رمز طولانی که باید دقیقا با `auth_key` در کانفیگ محلی یکی باشد
|
|
|
|
پروژه را با Git یا ZIP دریافت کنید، سپس لانچر یککلیکی را اجرا کنید.
|
|
|
|
**گزینه A: Git**
|
|
|
|
```bash
|
|
git clone https://github.com/masterking32/MasterHttpRelayVPN.git
|
|
cd MasterHttpRelayVPN
|
|
```
|
|
|
|
**گزینه B: ZIP**
|
|
|
|
1. [صفحه GitHub پروژه](https://github.com/masterking32/MasterHttpRelayVPN) را باز کنید.
|
|
2. روی **Code** -> **Download ZIP** کلیک کنید.
|
|
3. فایل ZIP را extract کنید.
|
|
4. داخل پوشه extract شده `MasterHttpRelayVPN` یک terminal باز کنید.
|
|
|
|
بعد برنامه را اجرا کنید:
|
|
|
|
**Windows**
|
|
|
|
```cmd
|
|
start.bat
|
|
```
|
|
|
|
**Linux / macOS**
|
|
|
|
```bash
|
|
chmod +x start.sh
|
|
./start.sh
|
|
```
|
|
|
|
لانچر virtualenv میسازد، وابستگیها را نصب میکند، اگر `config.json` وجود نداشته باشد setup wizard را باز میکند، و سپس پراکسی را اجرا میکند.
|
|
|
|
بعد از اجرا، مرورگر را روی این پراکسی تنظیم کنید:
|
|
|
|
| گزینه | مقدار |
|
|
|-------|-------|
|
|
| نوع پراکسی | HTTP |
|
|
| آدرس | `127.0.0.1` |
|
|
| پورت | `8085` |
|
|
| پورت SOCKS5، اختیاری | `1080` |
|
|
|
|
برای سایتهای 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) را بخوانید.
|
|
|
|
## License
|
|
|
|
MIT
|