MasterHttpRelayVPN README

The project's README from github.com/masterking32/MasterHttpRelayVPN. As one markdown file: README.md.

MasterHttpRelayVPN

GitHub Ask DeepWiki oosmetrics oosmetrics

Youtube safe search and live streaming are now Bypassed & Working by default. so you don't need youtube_via_relay or Cloudflare / VPS exit_node for it.

Language: English | Persian / فارسی

نسخه فارسی با AI ایجاد شده. ترجیحا از نسخه انگلیسی استفاده کنید.

Telegram Channel 📣: https://t.me/MasterDnsVPN | @MasterDnsVPN

Telegram Group 📣: https://t.me/MasterDnsVPNGroup | @MasterDnsVPNGroup

❤️ Special Thanks to Abolix for making this project possible and maintaining it.

MasterHttpRelayVPN is a local proxy that routes browser traffic through a Google Apps Script relay using domain fronting. The simple path needs only this project and a free Google account. For sites that block Google egress, you can optionally add an exit node later.

We mainly use MITM (Man in the Middle) and Domain Fronting techniques.

Browser -> Local proxy -> Google front -> Your Apps Script relay -> Target site
                         network filter sees a Google-facing connection

Quick Menu 🧭

Click the links below for guides on common topics.

Getting Started : How to set up the proxy and deploy the Google relay.

Exit Node : Connect to Cloudflare Workers or a VPS for destinations to fix ChatGPT, Turnstile, and similar sites blocking Google IPs.

LAN Sharing : Share the proxy with other devices on your local network. (Android, iOS, other computers)

Configuration : Reference for all config options, plus diagnostic commands.

Security : Important notes on safely using and sharing the proxy.

Troubleshooting : Common issues and how to resolve them.

Docker : Instructions for running the proxy in a Docker container.

Architecture : Overview of the system design and components.

Fast Start ⚡

Before running the local proxy, deploy the Google relay once. You only need a Google account and about two minutes.

Deploy The Google Relay ☁️

  1. Open Google Apps Script and sign in.

  2. Click New project.

  3. Delete the default editor content.

  4. Open apps_script/Code.gs, copy everything, and paste it into Apps Script.

  5. Find this line and replace it with your own long secret:

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

  6. Click Deploy -> New deployment -> Web app.

  7. Set Execute as to Me.

  8. Set Who has access to Anyone.

  9. Click Deploy, approve the permission screen, and copy the Deployment ID.

Keep these two values ready for the setup wizard:

If you want more detail, use Getting Started.

Download the project with either Git or ZIP, then run the one-click launcher.

Option A: ZIP

Click to Download

Option B: Git

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

Then start the app:

Windows

start.bat

Linux / macOS

chmod +x start.sh
./start.sh

The launcher creates a virtual environment, installs dependencies, opens the setup wizard if config.json is missing, and starts the proxy.

After it starts, configure your browser to use:

Field Value
Proxy type HTTP
Address 127.0.0.1
Port 8085
SOCKS5 port 1080

After starting, CA will be installed automatically.

You can use telegram as : https://t.me/socks?server=127.0.0.1&port=1080 or if you are using PC client, you can add HTTP proxy with manually.

Common Next Steps 🛠️

Support And Updates 📣

Donate 🍩

If you find this project helpful, you can support it with a donation:

Safety 🔒

This project is provided for educational, testing, and research use. You are responsible for following applicable laws and service terms. Never share config.json, auth_key, ca/, or an exit-node URL together with a valid PSK. Read Security Notes before sharing the proxy with other devices.

License

MIT

MasterHttpRelayVPN (masterking32/MasterHttpRelayVPN)

Searching Database…

3.9K ·GitHub
MasterHttpRelayVPN
Что это такое?MasterHttpRelayVPN — это локальный прокси, который направляет трафик браузера через релей Google Apps Script с использованием domain fronting и MITM-перехвата TLS, созданный для обхода DPI и цензуры.
Это отдельное приложение или то, что запускается как фоновый процесс?Это локальный прокси-сервер на Python, который вы запускаете на своей машине; он открывает HTTP-прокси и порт SOCKS5, на которые вы направляете браузер или приложения.
Как это запустить?Разверните включённый релей Google Apps Script (скопируйте appsscript/Code.gs в новый проект Apps Script, задайте свой AUTHKEY и разверните как веб-приложение), затем скачайте этот репозиторий и запустите лаунчер в один клик для Windows или Linux/macOS, который создаст виртуальное окружение и запустит прокси.
Нужен ли аккаунт Google или сервер для использования?Нужен лишь бесплатный аккаунт Google, чтобы развернуть релей Apps Script; VPS для базовой настройки не требуется, хотя при желании можно добавить exit-узел на Cloudflare Workers или VPS для сайтов, блокирующих IP Google.
Работает ли это с любым сайтом, например ChatGPT?Некоторые сайты, вроде ChatGPT или использующих Turnstile, могут блокировать exit-IP Google и требовать настройки опционального exit-узла (Cloudflare Workers или VPS) для нормальной работы.
Можно ли расшарить прокси на телефон или другие устройства в моей сети?Да, есть гайд по LAN Sharing для подключения других устройств в локальной сети, включая Android и iOS, а также инструкции по Docker для контейнерного развёртывания.
Безопасно ли делиться своим конфигом с другими?Нет — README прямо предупреждает никогда не передавать свой config.json, authkey, папку с сертификатом CA или URL exit-узла вместе с валидным PSK, так как это открывает ваш прокси для злоупотреблений.
Зачем ему устанавливать сертификат CA?Он выполняет MITM-перехват TLS для инспекции и передачи HTTPS-трафика, поэтому после запуска автоматически устанавливает центр сертификации (CA) на вашу машину, чтобы браузер доверял перехваченным соединениям.
Для чего здесь используется domain fronting?Domain fronting маскирует реальное назначение трафика, направляя его через доверенный домен Google (Apps Script), из-за чего цензорам труднее блокировать или обнаруживать его по имени хоста назначения.
Обходит ли он также ограничения YouTube?Да, в README сказано, что безопасный поиск YouTube и прямые трансляции обходятся и работают по умолчанию, без отдельного релея или exit-узла для этого.
What are similar projects?mhr-cfw, MasterHttpRelayVPN-RUST, mtproto.zig, CFNext, gost, hysteria, Xray-core, brook
Which topics is it in?dpi, sni, dns-over-https, relay, mitm, socks5, tunnel, reverse-proxy, tls, censorship-circumvention, google, vpn
Creator
masterking32
Size
0.4 MB
Stars
3.9K
Updated
CommitJun 09
Age
5mo
Commits · 90 Days