MCPcopy
hub / github.com/masterking32/MasterHttpRelayVPN

github.com/masterking32/MasterHttpRelayVPN @main sqlite

repository ↗ · DeepWiki ↗
342 symbols 1,230 edges 30 files 165 documented · 48%
README

MasterHttpRelayVPN

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

کانال تلگرام 📣: https://t.me/masterdnsvpn

تشکر ویژه ❤️: Abolix

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

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

منوی سریع 🧭

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

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

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

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

ساخت رله Google ☁️

  • وارد Google Apps Script شوید و روی New project کلیک کنید.
  • محتوای پیش‌فرض ادیتور را کامل پاک کنید.
  • فایل apps_script/Code.gs را باز کنید، همه کد آن را کپی کنید، و داخل Apps Script قرار دهید.
  • این خط را پیدا کنید و با یک رمز طولانی و مخصوص خودتان عوض کنید:

    javascript const AUTH_KEY = "your-secret-password-here";

  • از مسیر Deploy -> New deployment -> Web app بروید.

  • گزینه Execute as را روی Me بگذارید.
  • گزینه Who has access را روی Anyone بگذارید.
  • روی 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

  • صفحه 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 را بخوانید.

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

امنیت 🔒

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

سلب مسئولیت قانونی ⚠️

MasterHttpRelayVPN فقط برای آموزش، تست و پژوهش ارائه شده است.

  • محدودیت مسئولیت: توسعه‌دهنده‌ها و مشارکت‌کننده‌ها در قبال هرگونه خسارت مستقیم، غیرمستقیم، اتفاقی، تبعی، یا هر نوع خسارت دیگر ناشی از استفاده یا عدم امکان استفاده از این پروژه مسئول نیستند.
  • مسئولیت کاربر: اجرای این پروژه خارج از محیط کنترل‌شده ممکن است روی شبکه، اکانت‌ها، پراکسی‌ها، گواهی‌ها، یا سیستم‌های متصل اثر بگذارد. مسئولیت کامل نصب، پیکربندی، و استفاده با خود کاربر است.
  • رعایت قوانین: قبل از استفاده از این نرم‌افزار، رعایت همه قوانین و مقررات محلی، ملی، و بین‌المللی بر عهده کاربر است.
  • رعایت قوانین Google: اگر از Google Apps Script یا دیگر سرویس‌های Google استفاده می‌کنید، رعایت Terms of Service، قوانین استفاده، سهمیه‌ها (quota)، و سیاست‌های پلتفرم Google بر عهده شماست. استفاده نادرست ممکن است باعث تعلیق یا مسدود شدن اکانت یا deployment شود.
  • هشدار TLS/CA: در حالت Apps Script، ترافیک HTTPS به‌صورت محلی decrypt و دوباره encrypt می‌شود. برای جلوگیری از خطاهای امنیتی مرورگر، باید گواهی CA تولیدشده را نصب کنید.
  • هشدار LAN: وقتی LAN sharing فعال است، دستگاه‌های شبکه محلی می‌توانند از پراکسی شما استفاده کنند. این قابلیت را فقط روی شبکه‌های قابل اعتماد فعال کنید و در صورت نیاز لایه‌های امنیتی اضافه بگذارید.

License

MIT

Core symbols most depended-on inside this repo

get
called by 148
src/proxy/proxy_support.py
_run
called by 33
src/core/cert_installer.py
_spawn
called by 21
src/relay/domain_fronter.py
close
called by 19
src/relay/h2_transport.py
close
called by 13
src/relay/domain_fronter.py
dim
called by 12
setup.py
_send_json
called by 11
apps_script/vps_exit_node.py
header_value
called by 10
src/proxy/proxy_support.py

Shape

Method 194
Function 128
Class 20

Languages

Python98%
TypeScript2%

Modules by API surface

src/relay/domain_fronter.py99 symbols
src/proxy/proxy_server.py41 symbols
scripts/benchmark_transport.py20 symbols
src/relay/h2_transport.py19 symbols
src/core/cert_installer.py18 symbols
src/proxy/proxy_support.py15 symbols
setup.py15 symbols
src/core/logging_utils.py14 symbols
src/relay/relay_response.py13 symbols
apps_script/vps_exit_node.py11 symbols
src/relay/fronting_support.py10 symbols
tests/test_proxy_support.py8 symbols

Dependencies from manifests, versioned

brotli1.1.0 · 1×
certifi2024.1.0 · 1×
cryptography41.0.0 · 1×
h24.1.0 · 1×
zstandard0.22.0 · 1×

For agents

$ claude mcp add MasterHttpRelayVPN \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact