Files
MasterHttpRelayVPN/README_FA.md
T

5.6 KiB

MasterHttpRelayVPN

زبان: English | فارسی

MasterHttpRelayVPN یک پراکسی محلی است که ترافیک مرورگر را از مسیر Google Apps Script و Domain Fronting عبور می‌دهد. برای مسیر ساده فقط همین پروژه و یک اکانت رایگان Google کافی است. اگر بعضی سایت‌ها خروجی Google را مسدود کنند، بعدا می‌توانید Exit Node اضافه کنید.

مرورگر -> پراکسی محلی -> مسیر Google -> رله Apps Script شما -> سایت مقصد
                         فیلتر فقط اتصال شبیه Google را می‌بیند

منوی سریع

شروع سریع | Docker | اشتراک گذاری LAN | راهنمای Exit Node

مرجع تنظیمات | رفع مشکل | نکات امنیتی | معماری

شروع خیلی سریع

قبل از اجرای پراکسی، باید یک بار رله Google را deploy کنید. فقط یک اکانت Google لازم دارید و این کار حدود دو دقیقه زمان می‌برد.

ساخت رله Google

  1. وارد Google Apps Script شوید.

  2. روی New project کلیک کنید.

  3. محتوای پیش‌فرض ادیتور را کامل پاک کنید.

  4. فایل apps_script/Code.gs را باز کنید، همه کد آن را کپی کنید، و داخل Apps Script قرار دهید.

  5. این خط را پیدا کنید و با یک رمز طولانی و مخصوص خودتان عوض کنید:

    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 را کپی کنید.

این دو مقدار را برای setup wizard نگه دارید:

  • Deployment ID از Google Apps Script
  • AUTH_KEY، یک رمز طولانی که باید دقیقا با auth_key در کانفیگ محلی یکی باشد

اگر توضیح کامل‌تر می‌خواهید، شروع سریع را ببینید.

پروژه را با Git یا ZIP دریافت کنید، سپس لانچر یک‌کلیکی را اجرا کنید.

گزینه A: Git

git clone https://github.com/masterking32/MasterHttpRelayVPN.git
cd MasterHttpRelayVPN

گزینه B: ZIP

  1. صفحه GitHub پروژه را باز کنید.
  2. روی Code -> Download ZIP کلیک کنید.
  3. فایل ZIP را extract کنید.
  4. داخل پوشه 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 را بخوانید.

پشتیبانی و اطلاع‌رسانی

امنیت

این پروژه برای آموزش، تست و پژوهش ارائه شده است. مسئولیت رعایت قوانین و شرایط سرویس‌ها با کاربر است. فایل config.json، مقدار auth_key، پوشه ca/، و آدرس Exit Node همراه با PSK معتبر را با کسی به اشتراک نگذارید. قبل از فعال کردن استفاده در شبکه محلی، نکات امنیتی را بخوانید.

License

MIT