MasterHttpRelayVPN is a free, open-source tool designed to help users bypass internet censorship and network restrictions by disguising their web traffic as legitimate Google traffic. The core innovation of this project is its use of Google Apps Script as a relay, allowing users to tunnel HTTP and SOCKS5 proxy traffic through Google’s infrastructure without the need for a VPS or dedicated server. This approach leverages domain fronting, making the traffic appear as if it is destined for trusted domains like google.com, which are typically allowed by firewalls and network filters.
The repository provides a comprehensive solution for proxying web traffic, including support for MITM (Man-In-The-Middle) TLS interception, HTTP/1 and HTTP/2 multiplexing, and DPI (Deep Packet Inspection) evasion. The MITM TLS interception feature enables the proxy to decrypt and re-encrypt HTTPS traffic, which is essential for accessing secure websites through the relay. To facilitate this, the tool generates a CA certificate that users must install in their browsers or operating systems, ensuring seamless HTTPS browsing without security warnings.
Setup is straightforward and cross-platform, with scripts and instructions for Windows, Linux, and macOS. Users clone the repository, install dependencies, and run a configuration wizard that prompts for their Google Apps Script Deployment ID and generates a strong password. The Google Apps Script relay is deployed by copying a provided script (Code.gs) into a new Apps Script project, setting a secret password, and deploying it as a web app. The proxy configuration is then completed by entering the Deployment ID and password into a config file.
For advanced use cases, MasterHttpRelayVPN supports chaining an exit node, which can be deployed on platforms like Cloudflare Workers, Deno Deploy, or a personal VPS. This is particularly useful for accessing websites that block traffic from Google datacenter IPs. The exit node configuration is flexible, allowing users to specify which domains should be routed through the exit node and to switch providers easily.
The proxy listens on localhost by default, but LAN sharing can be enabled to allow other devices on the local network to use the proxy. Docker support is included for users who prefer containerized deployment, with clear instructions for building and running the proxy in a Docker environment.
MasterHttpRelayVPN offers granular configuration options, including host-based policies for blocking, direct tunneling, and DNS overrides. It supports load balancing by allowing multiple Apps Script deployments, improving speed and reliability. Optional dependencies enhance functionality, such as HTTP/2 multiplexing and advanced compression support.
The project is provided for educational and research purposes, with a strong emphasis on user responsibility and legal compliance. Users are cautioned to adhere to Google’s terms of service and to manage their secrets securely. The repository includes detailed documentation for setup, configuration, certificate management, and troubleshooting, making it accessible to both novice and advanced users.
In summary, MasterHttpRelayVPN is a robust, flexible tool for circumventing network restrictions by leveraging Google’s infrastructure, offering advanced proxy features, easy deployment, and extensive customization options without requiring paid hosting or servers.
