⚡ Master Relay VPN (Windows Client)

🇬🇧 English

📌 About The Project

Master Relay VPN is a modern, open-source Windows desktop application built with C# and WPF. It acts as a graphical user interface (GUI) and automation wrapper for the MasterHttpRelayVPN project.

This tool utilizes Domain Fronting via Google domains and Google Apps Script to bypass DPI and censorship without requiring a VPS, Cloudflare Worker, or any paid servers. Our Windows client eliminates the need to install Python, manually configure JSON files, or run command-line tools by automating the entire lifecycle.

🙏 Credits

The core routing engine, Python scripts, and the App Script logic were originally developed by masterking32. This repository provides the Windows GUI frontend to make their excellent work accessible to everyday users.

✨ Client Features

• Standalone Execution: The Python core is pre-compiled. No Python installation is required.
• Automated Proxy & Certificates: Automatically sets the Windows system proxy and installs the required MITM CA certificate securely in the background.
• Multi-Relay Load Balancing: Manage multiple Google Apps Script Deployment IDs through the UI to distribute traffic and avoid hitting Google's quotas.
• Live Traffic Monitoring: Built-in speedometer for real-time download/upload monitoring.
• Relay Health Check: One-click ping test to ensure your App Script relays are active.
• Code.gs Generator: Automatically generates your custom Google Apps Script code with a secure, randomized AUTH_KEY.

⚙️ How It Works

Browser -> Local Proxy -> Google/CDN -> Your Google Apps Script -> Destination The local proxy sends requests masked as normal Google traffic. Your deployed Apps Script fetches the actual website and returns the data.

🚀 Getting Started

1. Run the application.
2. Click Generate to create a secure AUTH_KEY.
3. Click Export Code.gs and deploy the generated code as a "Web App" on Google Apps Script (Execute as: Me, Access: Anyone).
4. Copy the Deployment ID from Google and add it to the Manage Relays & IDs panel in the app.
5. Click CONNECT.

🇮🇷 فارسی

📌 درباره پروژه

برنامه Master Relay VPN یک کلاینت مدرن ویندوزی (بر پایه WPF) است که به عنوان رابط کاربری و ابزار اتوماسیون برای پروژه متن‌باز MasterHttpRelayVPN توسعه داده شده است.

این ابزار با استفاده از تکنیک Domain Fronting و سرویس رایگان Google Apps Script، ترافیک شما را پشت دامنه‌های معتبر گوگل پنهان می‌کند (بدون نیاز به سرور مجازی یا کلودفلر). کلاینت ویندوزی ما نیاز به نصب پایتون، درگیری با ترمینال و تنظیم دستی فایل‌های کانفیگ را به طور کامل از بین برده و همه‌چیز را با یک کلیک مدیریت می‌کند.

🙏 اعتبار و سازنده اصلی

هسته اصلی پایتون، منطق دور زدن فیلترینگ و اسکریپت‌های گوگل توسط masterking32 توسعه داده شده است. این مخزن (ریپازیتوری) صرفاً یک رابط کاربری گرافیکی برای استفاده راحت‌تر کاربران ویندوز از متود ایشان است.

✨ ویژگی‌های کلاینت ویندوزی

• بدون نیاز به پیش‌نیاز: هسته پایتون کامپایل شده و مستقیماً توسط برنامه اجرا می‌شود.
• تنظیم خودکار: نصب گواهی‌نامه محلی (CA Certificate) و تنظیم پراکسی سیستم ویندوز به صورت کاملاً خودکار در پس‌زمینه انجام می‌شود.
• پشتیبانی از چند رله (Load Balancing): قابلیت افزودن چندین آیدی گوگل اسکریپت برای تقسیم بار ترافیک و جلوگیری از مسدود شدن اکانت‌ها.
• مانیتورینگ زنده: نمایش سرعت آپلود و دانلود و حجم مصرفی به صورت در لحظه.
• تست سلامت: بررسی وضعیت و پینگ رله‌های گوگل تنها با یک کلیک.
• تولید خودکار اسکریپت: ساخت رمزنگاری شده و آماده‌ی فایل Code.gs جهت آپلود در گوگل.

⚙️ نحوه کارکرد

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

🚀 راهنمای استفاده سریع

۱. برنامه را اجرا کنید. ۲. با زدن دکمه ↻ یک رمز قوی (AUTH_KEY) بسازید. ۳. روی دکمه Export Code.gs کلیک کنید. فایل خروجی را در Google Apps Script خود کپی کرده و به عنوان Web App دیپلوی کنید (دسترسی روی Anyone تنظیم شود). ۴. آیدی (Deployment ID) دریافتی از گوگل را کپی کرده و در برنامه، در بخش Manage Relays وارد (Add) کنید. ۵. روی CONNECT کلیک کنید و از اینترنت آزاد لذت ببرید.

🔒 هشدارهای امنیتی

مسئولیت استفاده از این نرم‌افزار بر عهده کاربر است. هرگز پوشه ca (گواهی‌نامه‌ها) یا رمز AUTH_KEY خود را در اختیار دیگران قرار ندهید تا امنیت ترافیک شما حفظ شود.