A secure, complete Android client for the MasterHttpRelayVPN family β TUN VPN, proxy-only mode, per-app routing, SNI & IP labs, live logs and a beautiful UI.
Google Apps Script relays are the cheapest, most resilient way to get past SNI filtering: your ISP only sees an encrypted connection to Google. But every project in this family ships as a desktop script, leaving Android users with a pile of terminal commands, Python, and no VPN.
GRV turns that whole stack into one APK.
- No Python, no Termux, no root.
- One tap for full-device VPN, or proxy-only for v2rayNG and friends.
- Your relay, your Google account, your AUTH_KEY β nothing shared.
- The password/tunnel key never leaves the device.
| π Three relay engines | Classic (masterking32), Rust (mhrv-rs), CFW (mhr-cfw + Cloudflare Worker). Pick yours; the app shows the exact deployment steps. |
| π Encrypted transport | TLS to Google's edge, MITM CA generated on-device, HTTPS re-encrypted inside the relay. |
| π± TUN + proxy | Full-device VPN or local HTTP :8080 / SOCKS5 :1081 for v2rayNG, browsers, per-app proxy. |
| π§© Per-app routing | ALL / ONLY / EXCEPT with a searchable app picker. |
| π― SNI tester | Real TLS handshakes against the Google edge, per-hostname latency. |
| π IP lab | Three real TCP pings per IP, loss %, min/avg/max, full TLS+SNI result, auto-discovery with DNS + DoH, custom IPs. |
| π Live logs | Colour-coded, auto-scrolling ring buffer straight from the Rust engine. |
| π Real stats | Relay calls, cache hits, HTTP/2 health, daily quota estimate. |
| πΆ Live traffic | Real download/upload totals and per-second speed while connected. |
| π¨ Light & dark | Modern white UI with a one-tap system / light / dark toggle. |
| πͺΆ Light | ~20 MB, no analytics, no accounts, no trackers. |
All three projects implement the same Apps Script request envelope
(k, u, h, m, b, and the batch form q). They differ in the deployed
Code.gs and optional Cloudflare Worker, not in the client protocol.
GRV therefore ships one hardened engine with three deployment presets:
| Preset | Deploy this | Best for |
|---|---|---|
| Classic | masterking32/MasterHttpRelayVPN β apps_script/Code.gs |
existing deployments |
| Rust β | therealaleph/MasterHttpRelayVPN-RUST β assets/apps_script/Code.gs |
HTTP/2, batching, cache |
| CFW | denuitt1/mhr-cfw β GAS Code.gs + Cloudflare Worker |
Cloudflare exit IPs |
You paste exactly two values into GRV: the Deployment ID / URL and the AUTH_KEY / tunnel key.
- Download
GRV-1.0.6-arm64-v8a.apkfrom Releases. - Open it on the phone, allow Install unknown apps.
- Deploy a relay (2 minutes) β see docs/INSTALL.md.
- Paste the Deployment ID + AUTH_KEY in GRV.
- Install the MITM certificate (one tap).
- Tap Connect.
Full beginner walkthrough: docs/INSTALL.md. Build instructions: docs/BUILD.md. How it works: docs/ARCHITECTURE.md.
Package : com.jackh0006.grv
Version : 1.0.6
ABI : arm64-v8a
SHA-256 : af01b29a5a4a815d2432efc5f67739a7da8cfb2497a43fee5715ca8d8e5c0973
sha256sum -c GRV-1.0.6-arm64-v8a.apk.sha256- Android/Huawei connectivity probes now answer 204 locally, so the VPN is marked as having internet and apps stop staying on "connecting".
- Relay methods are lowercased, fixing "Invalid argument: method" from Apps Script.
- Includes the 1.0.4 stale-tun2proxy teardown fix.
- Fixed the real-device bug where a second Connect left the old tun2proxy alive, so TUN showed connected but passed no traffic.
- Stale TUN/tun2proxy/proxy is now fully stopped before every new session.
- Restored the mhrv client for your three Apps Script deployments.
- SNI tester and the full IP lab are back.
- Real TUN (tun2proxy β SOCKS5) and a separate proxy-only service.
- Installs over 2.0.0 (versionCode 5).
- Separate proxy service β GRV's proxy now coexists with v2rayNG and any other VPN.
- Real traffic counters (GRV's own UID) in the app and in the notification.
- Mix engine, deployment Detect and after-connect health advice.
- New light four-colour icon.
- Disconnect path no longer calls the crashing
Tun2proxy.stop(); overlay removed. - Crash log saved to
Android/data/com.jackh0006.grv/files/last_crash.txt.
- Android 7.0 (API 24) or newer, arm64-v8a device (Huawei Y9 2019, Kirin 710 and newer are perfect).
- A free Google account to deploy the relay.
- A screen lock for the first CA install (Android requirement).
- Local listeners bind 127.0.0.1 only by default.
- No telemetry, no accounts, no remote code.
- The relay sees the destination hosts β use HTTPS; this is censorship bypass, not anonymity.
- The on-device CA can be removed at any time from Android settings.
- Full model: SECURITY.md.
| Action | How |
|---|---|
| Full-device VPN | Connection mode β VPN (TUN) |
| Use with v2rayNG | Connection mode β Proxy only β 127.0.0.1:8080 (HTTP) or 127.0.0.1:1081 (SOCKS5) |
| Only some apps | App splitting β Only |
| Exclude banking apps | App splitting β Except |
| Faster edge | IP lab β Auto-detect β Test all β Use |
| Test fronting | SNI pool + tester |
| Debug | Live logs |
Huawei / EMUI: set Battery β App launch β GRV β Manage manually and enable all switches, otherwise EMUI may kill the VPN.
git clone https://github.com/jackh0006/GRV.git
cd GRV/android
export ANDROID_NDK_HOME=$HOME/Android/Sdk/ndk/26.3.11579264
./gradlew assembleDebugRelease builds use android/keystore.properties + a local keystore. Without
them the release variant falls back to the debug key, so the project builds for
everyone. Full details: docs/BUILD.md.
GRV is free, MIT-licensed and always will be. Donations pay for servers and keep it maintained.
| Asset | Network | Address |
|---|---|---|
| Bitcoin | BTC | bc1q8t0fn2yrsy4lh3m0pz34uj27t8vxjeavkjym83 |
| Dogecoin | DOGE | D6ZdMQ7mHGGmuH9prpZ2zjpnG5Q3WVRDtC |
| Ethereum | ETH | 0xdad428900a4359be8f76b3062df34211582e09eb |
| USDT | ERC-20 | 0xdad428900a4359be8f76b3062df34211582e09eb |
| BNB | BEP-20 | 0xdad428900a4359be8f76b3062df34211582e09eb |
| USDT | BEP-20 | 0xdad428900a4359be8f76b3062df34211582e09eb |
| TRON | TRX | TMpb6RNTuGNM1eTakm9kjds1mRTPYYJesf |
| USDT | TRC-20 | TMpb6RNTuGNM1eTakm9kjds1mRTPYYJesf |
| Solana | SOL | BDCCrRez1yD1RpkAtiqKKDk3BfxPD8P7nkL26jCYrzgL |
| USDT | SPL | BDCCrRez1yD1RpkAtiqKKDk3BfxPD8P7nkL26jCYrzgL |
| USDC | SPL | BDCCrRez1yD1RpkAtiqKKDk3BfxPD8P7nkL26jCYrzgL |
| XRP | XRP Ledger | rNUAhaATFLvosdu9m9M95bupRBtZ8eqpj9 |
| Toncoin | TON | UQCu6-3yGyQ5dzvcCxr2gobuvx5ddbS9EC690qtey92P5_wX |
| Litecoin | LTC | ltc1q2gs89cfy3mumr7gu9w0zl9rllf80q67m5rmma8 |
Only send the matching asset on the matching network.
Built by jackh0006 Β· jackh109867@gmail.com.
GRV stands on the MIT-licensed mhrv-rs engine by therealaleph. Relay protocol compatible with MasterHttpRelayVPN by masterking32 and mhr-cfw by denuitt1. See NOTICE.
MIT Β© 2026 jackh0006 β LICENSE.
Not affiliated with Google, Android, Cloudflare or the upstream projects.
