Provided without warranty: This software is provided "AS IS", without express or implied warranty, including merchantability, fitness for a particular purpose, and non-infringement.
Limitation of liability: The developers and contributors are not responsible for any direct, indirect, incidental, consequent, or other damages resulting from the use of this project or the inability to use it.
User responsibility: Running this project outside controlled test environments may affect networks, accounts, proxies, certificates, or connected systems. You are solely responsible for installation, configuration, and use.
Legal compliance: You are responsible for complying with all local, national, and international laws and regulations before using this software.
Google services compliance: If you use Google Apps Script or other Google services with this project, you are responsible for complying with Google's Terms of Service, acceptable use rules, quotas, and platform policies. Misuse may lead to suspension or termination of your Google account or deployments.
License terms: Use, copying, distribution, and modification of this software are governed by the repository license. Any use outside those terms is prohibited.

How It Works

Client -> Local Proxy -> Google front -> Google Apps Script -> Target website
               |
               +-> shows www.google.com to the network DPI filter

The Go proxy runs locally on your machine and forwards traffic through Google's infrastructure. The network only sees allowed domains like www.google.com while your actual traffic is hidden inside the relay request.

Quick Start

1 - Clone and Build

git clone https://github.com/ThisIsDara/mhr-cfw-go.git
cd mhr-cfw-go

Or download the latest release from GitHub Releases

2 - Run build.bat

Double-click build.bat or run:

.\build.bat

This will build the mhr-cfw-go.exe file.

3 - Configure

Edit config.json with your settings:

{
  "auth_key": "your-secret-password-here",
  "script_id": "YOUR_DEPLOYMENT_ID"
}

4 - Run

Double-click run.bat or run:

.\mhr-cfw-go.exe

The proxy will start on 127.0.0.1:8080. Use FoxyProxy to route browser traffic through it.

5 - Install CA Certificate (for HTTPS interception)

Run with:

.\mhr-cfw-go.exe --install-cert

Command Line Options

Option	Description
`--no-menu`	Run without TUI menu
`--port`	Override proxy port
`--host`	Override listen host
`--socks5-port`	Override SOCKS5 port
`--disable-socks5`	Disable SOCKS5 proxy
`--log-level`	Set log level (DEBUG, INFO, WARN, ERROR)
`--install-cert`	Install CA certificate
`--uninstall-cert`	Remove CA certificate
`--scan`	Scan Google IPs
`--setup`	Run setup wizard
`--version`	Show version

Set Up Google Apps Script Relay

Open Google Apps Script and sign in.
Click New project.
Copy your relay code into the editor.
Deploy as Web App (Execute as: Me, Who has access: Anyone).
Copy the Deployment ID into config.json.

Features

HTTP/HTTPS proxy with CONNECT tunnel
SOCKS5 proxy
Domain fronting via Google Apps Script
MITM proxy with dynamic certificates
HTTP/2 transport
Interactive TUI menu
LAN sharing support

Building from Source

Requirements:

Go 1.22+

go build -ldflags "-s -w" -o mhr-cfw-go.exe ./cmd/mhr-cfw

License

MIT