MasterHttpRelayVPN is a Python-based local proxy application that enables users to route browser traffic through Google Apps Script using domain fronting and MITM TLS interception techniques. The project provides a method to bypass network restrictions and censorship by leveraging Google's infrastructure as a relay point, allowing traffic to be tunneled through Google Apps Script deployments with HTTP/1 and HTTP/2 multiplexing support and DPI evasion capabilities.
The core architecture relies on deploying a relay script to Google Apps Script, which requires only a free Google account and approximately two minutes of setup time. Users deploy the provided Code.gs file to Google Apps Script, configure an authentication key, and obtain a deployment ID. The local proxy then communicates with this Google relay, which forwards traffic to destination servers. For sites that specifically block Google IP addresses, such as ChatGPT or Turnstile, users can optionally configure an exit node through Cloudflare Workers or a VPS to mask the Google origin.
The project includes comprehensive documentation covering multiple aspects of deployment and usage. Getting Started guides walk users through the initial setup process, while separate documentation addresses exit node deployment, LAN sharing capabilities for extending the proxy to other devices on a local network, configuration options, security considerations, troubleshooting procedures, Docker containerization, and system architecture details. The README explicitly notes that YouTube safe search and live streaming bypass functionality are now working by default, eliminating the need for separate YouTube relay configurations or external exit nodes for those services.
Setup is designed for accessibility with a one-click launcher available for both Windows and Linux/macOS systems. The launcher automatically creates a virtual environment, installs dependencies, runs a setup wizard if configuration is missing, and starts the proxy service. Once running, users configure their browser to use the local proxy at 127.0.0.1 on port 8085 for HTTP traffic or port 1080 for SOCKS5 connections. The project also supports Telegram integration, allowing users to configure the proxy directly through Telegram's proxy settings.
The repository is actively maintained with support channels including a Telegram channel and group for user communication and updates. The project includes donation options across multiple blockchain networks including TON, EVM-compatible networks, and TRON. Security documentation emphasizes that users must not share configuration files, authentication keys, certificate authority files, or exit node URLs together, and users are responsible for complying with applicable laws and Google's Terms of Service when deploying and using the proxy. The project is licensed under MIT and explicitly disclaims developer liability for damages resulting from its use.