MasterHttpRelayVPN

Language: English | Persian / فارسی

Telegram Channel 📣: https://t.me/masterdnsvpn

Special Thanks ❤️: Abolix

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.

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

Getting Started | Docker | LAN Sharing | Exit Node

Configuration | Troubleshooting | Security | Architecture

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 ☁️

Open Google Apps Script and sign in.
Click New project.
Delete the default editor content.
Open apps_script/Code.gs, copy everything, and paste it into Apps Script.
Find this line and replace it with your own long secret:
```
const AUTH_KEY = "your-secret-password-here";
```
Click Deploy -> New deployment -> Web app.
Set Execute as to Me.
Set Who has access to Anyone.
Click Deploy, approve the permission screen, and copy the Deployment ID.

Keep these two values ready for the setup wizard:

Deployment ID from Google Apps Script
AUTH_KEY, a long secret that must match auth_key in your local config

If you want screenshots and more detail, use Getting Started.

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

Option A: Git

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

Option B: ZIP

Open the GitHub repository.
Click Code -> Download ZIP.
Extract the ZIP file.
Open a terminal inside the extracted MasterHttpRelayVPN folder.

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, optional	`1080`

For HTTPS sites, install the generated certificate from ca/ca.crt if the app cannot install it automatically. The full setup is in Getting Started.

Common Next Steps 🛠️

If the browser shows certificate warnings, open Troubleshooting.
If you see unauthorized, make sure AUTH_KEY in apps_script/Code.gs exactly matches auth_key in config.json.
If browsing is slow or connections time out, run python main.py --scan and see Configuration Reference.
If ChatGPT, Turnstile, or similar sites block the Google exit IP, use Exit Node Guide.

Support And Updates 📣

Telegram channel: https://t.me/masterdnsvpn
Windows client: MHRWindowsApp
Ad blocker filter source: PersianBlocker

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

4.8 KiB Raw Blame History