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.
5.1 KiB
MasterHttpRelayVPN
زبان: English | فارسی
MasterHttpRelayVPN یک پراکسی محلی است که ترافیک مرورگر را از مسیر Google Apps Script و Domain Fronting عبور میدهد. برای مسیر ساده فقط همین پروژه و یک اکانت رایگان Google کافی است. اگر بعضی سایتها خروجی Google را مسدود کنند، بعدا میتوانید Exit Node اضافه کنید.
مرورگر -> پراکسی محلی -> مسیر Google -> رله Apps Script شما -> سایت مقصد
فیلتر فقط اتصال شبیه Google را میبیند
مسیر موردنیازتان را انتخاب کنید
| میخواهید... | اینجا را بخوانید |
|---|---|
| برای اولین بار راهاندازی کنید | شروع سریع |
| با Docker اجرا کنید | راهنمای Docker |
| پراکسی را در شبکه محلی به اشتراک بگذارید | اشتراکگذاری LAN |
| برای سایتهای حساس Exit Node بگذارید | راهنمای Exit Node |
| همه تنظیمات را بفهمید | مرجع تنظیمات |
| مشکلی را رفع کنید | رفع مشکل |
| نکات امنیتی را ببینید | نکات امنیتی |
| معماری و فایلها را بشناسید | معماری |
شروع خیلی سریع
قبل از اجرای پراکسی، رله Google را از فایل apps_script/Code.gs در Google Apps Script deploy کنید و این دو مقدار را آماده داشته باشید:
Deployment IDاز Google Apps ScriptAUTH_KEY، یک رمز طولانی که باید دقیقا باauth_keyدر کانفیگ محلی یکی باشد
پروژه را با Git یا ZIP دریافت کنید، سپس لانچر یککلیکی را اجرا کنید.
گزینه A: Git
git clone https://github.com/masterking32/MasterHttpRelayVPN.git
cd MasterHttpRelayVPN
گزینه B: ZIP
- صفحه GitHub پروژه را باز کنید.
- روی Code -> Download ZIP کلیک کنید.
- فایل ZIP را extract کنید.
- داخل پوشه extract شده
MasterHttpRelayVPNیک terminal باز کنید.
بعد برنامه را اجرا کنید:
Windows
start.bat
Linux / macOS
chmod +x start.sh
./start.sh
لانچر virtualenv میسازد، وابستگیها را نصب میکند، اگر config.json وجود نداشته باشد setup wizard را باز میکند، و سپس پراکسی را اجرا میکند.
بعد از اجرا، مرورگر را روی این پراکسی تنظیم کنید:
| گزینه | مقدار |
|---|---|
| نوع پراکسی | HTTP |
| آدرس | 127.0.0.1 |
| پورت | 8085 |
| پورت SOCKS5، اختیاری | 1080 |
برای سایتهای HTTPS، اگر برنامه نتوانست گواهی را خودکار نصب کند، فایل ca/ca.crt را نصب کنید. راهنمای کامل در شروع سریع است.
قدمهای بعدی رایج
- اگر مرورگر خطای certificate نشان میدهد، بخش خطای گواهی را ببینید.
- اگر خطای
unauthorizedمیبینید، مقدارAUTH_KEYدر apps_script/Code.gs باید دقیقا باauth_keyدرconfig.jsonیکی باشد. - اگر سرعت پایین است یا timeout میگیرید، دستور
python main.py --scanرا اجرا کنید و مرجع تنظیمات را ببینید. - اگر سایتهایی مثل ChatGPT یا Turnstile با خروجی Google مشکل دارند، راهنمای Exit Node را بخوانید.
پشتیبانی و اطلاعرسانی
- کانال Telegram: https://t.me/masterdnsvpn
- کلاینت Windows: MHRWindowsApp
- منبع فیلتر تبلیغات: PersianBlocker
امنیت
این پروژه برای آموزش، تست و پژوهش ارائه شده است. مسئولیت رعایت قوانین و شرایط سرویسها با کاربر است. فایل config.json، مقدار auth_key، پوشه ca/، و آدرس Exit Node همراه با PSK معتبر را با کسی به اشتراک نگذارید. قبل از فعال کردن استفاده در شبکه محلی، نکات امنیتی را بخوانید.
License
MIT