mhrv-rs — bypass censorship for free, with your own Google account

A small program that runs on your computer and lets you visit blocked websites for free, using a Google Apps Script you deploy in your own free Google account. Your ISP only sees encrypted traffic to www.google.com — it can't tell what you're really visiting.

🇬🇧 English Quick Start · Full Guide (advanced topics) 🇮🇷 راه‌اندازی سریع فارسی · راهنمای کامل (مباحث پیشرفته)

۱. راهنمای تصویری راه اندازی به زبان فارسی (YouTube)
۲. راهنمای جامع متنی راه اندازی به زبان فارسی با تشکر از Kian Irani

---

What you get

• 🌐 Bypasses DPI / SNI blocking by using Google's edge as a relay
• 💯 Completely free — runs on your own Google account's free tier
• ⚡ One small file (~3 MB), no Python, no Node.js, no dependencies
• 🖥️ Works on Mac, Windows, Linux, Android, OpenWRT routers
• 🦊 Any browser or app that supports HTTP proxy or SOCKS5

How it works (the simple picture)

   you  →  browser  →  mhrv-rs  ──┐
                                  │ ISP only sees:  www.google.com
                                  ▼
                          Google's network
                                  │
                                  ▼
              your free Apps Script  fetches  the real site
                                  │
                                  ▼
                Twitter / ChatGPT / blocked-site of your choice

ISPs can't read inside encrypted HTTPS. They only see the address — www.google.com. The actual page lookup happens inside Google's network, hidden in the encrypted tunnel.

Quick Start

About 5 minutes. You need:

• A free Google account (any Gmail works)
• A computer (Mac, Windows, or Linux)
• Firefox or Chrome

Step 1 — Make the Google Apps Script (one-time)

1. Go to script.google.com, sign in with your Google account
2. Click New project at the top left
3. Delete the default code in the editor
4. Open the file assets/apps_script/Code.gs in this repo, copy all of it, paste into the Apps Script editor (replacing what was there)
5. Find this line near the top:

   const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";
   

   Change CHANGE_ME_TO_A_STRONG_SECRET to a long random string of your own. Keep this string — you'll paste it into the app in Step 3. Treat it like a password.
6. Click 💾 Save (or Ctrl/Cmd+S)
7. Click Deploy (top right) → New deployment
8. Click the gear icon ⚙ next to "Select type" → choose Web app
9. Set:
   • Execute as: Me (your Google account)
   • Who has access: Anyone
10. Click Deploy. Google may ask for permissions — click Authorize access and approve
11. Google shows a Deployment ID (a long random string). Copy it — you'll need it in Step 3.

Tip: if you ever update Code.gs later, don't make a new deployment. Edit the code, then go to Deploy → Manage deployments → ✏️ → Version: New version → Deploy. The Deployment ID stays the same.

Step 2 — Download mhrv-rs

Go to the latest release page and download the file for your computer:

You're on	Download this
Mac with Apple Silicon (M1 / M2 / M3 / M4 chip)	mhrv-rs-macos-arm64-app.zip
Mac with Intel chip	mhrv-rs-macos-amd64-app.zip
Windows	mhrv-rs-windows-amd64.zip
Linux (Ubuntu / Mint / Fedora / Debian / Arch)	mhrv-rs-linux-amd64.tar.gz
Android phone or tablet	mhrv-rs-android-universal-v*.apk
OpenWRT router or Alpine	mhrv-rs-linux-musl-amd64.tar.gz

Mac: not sure if Apple Silicon or Intel? Click → About This Mac. If "Chip" says Apple, get arm64. If Intel, get amd64.

Linux: getting a GLIBC error? Use the linux-musl-amd64 file instead — it works on any Linux without dependencies.

Unzip it.

Step 3 — First run

Double-click the launcher:

| Mac | run.command | | Windows | run.bat | | Linux | ./run.sh (in a terminal) |

The first time, it asks for your computer password. This is to install one small certificate so your browser trusts mhrv-rs. The certificate is generated on your computer and never leaves it — no cloud, no Google, nothing remote can use it.

The mhrv-rs window opens. Fill in:

• Apps Script ID(s) → paste the Deployment ID from Step 1
• Auth key → paste the random string you put in Code.gs
• Leave everything else at the defaults

Click Save config, then Start. The status circle goes green if it works.

Test it: click the Test button. It sends one request through the relay and tells you if it worked.

Step 4 — Tell your browser to use mhrv-rs

Firefox (recommended — easiest)

1. Firefox → ☰ menu → Settings
2. Search "proxy" in the search box
3. Click Settings… under Network Settings
4. Choose Manual proxy configuration
5. HTTP Proxy: 127.0.0.1 Port: 8085
6. ☑ Check "Also use this proxy for HTTPS"
7. Click OK

Chrome / Edge

Install the Proxy SwitchyOmega extension and set proxy to 127.0.0.1:8085.

macOS (whole system)

System Settings → Network → Wi-Fi → Details → Proxies → enable both Web Proxy (HTTP) and Secure Web Proxy (HTTPS), both pointing to 127.0.0.1:8085.

Step 5 — Try it

Open any blocked site in your browser. It should load.

If something doesn't work:

• Click Test in the mhrv-rs window — it pinpoints which step is failing
• Look at the Recent log panel at the bottom of the window
• See Common questions below

---

Common questions

Is this really free? Yes. Google gives every account 20,000 outbound URL fetches per day on the free tier. That's plenty for one person's normal browsing. For a family of 3–4 sharing the same setup, make 2–3 deployments in different Google accounts and add all the IDs.