Skip to content
jackh0006Public

About

GRV - secure Android client for MasterHttpRelayVPN (Classic, Rust, CFW). TUN + proxy, per-app routing, SNI/IP labs, live logs.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

GRV

GRV banner

One client. Three relay engines. Zero noise.

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.

CI License: MIT Android 7+ arm64 Rust engine Version


Why you need GRV

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.

What it does

πŸš€ 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.

Three engines, one protocol β€” and why that is correct

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.


Quick install

  1. Download GRV-1.0.6-arm64-v8a.apk from Releases.
  2. Open it on the phone, allow Install unknown apps.
  3. Deploy a relay (2 minutes) β€” see docs/INSTALL.md.
  4. Paste the Deployment ID + AUTH_KEY in GRV.
  5. Install the MITM certificate (one tap).
  6. Tap Connect.

Full beginner walkthrough: docs/INSTALL.md. Build instructions: docs/BUILD.md. How it works: docs/ARCHITECTURE.md.

Verified release

Package : com.jackh0006.grv
Version : 1.0.6
ABI     : arm64-v8a
SHA-256 : af01b29a5a4a815d2432efc5f67739a7da8cfb2497a43fee5715ca8d8e5c0973
sha256sum -c GRV-1.0.6-arm64-v8a.apk.sha256

What's new in 1.0.5

  • 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.

What's new in 1.0.4

  • 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.

What's new in 1.0.3

  • 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).

What's new in 1.0.2

  • 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.

Requirements

  • 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).

Security at a glance

  • 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.

Everyday use

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.


Build from source

git clone https://github.com/jackh0006/GRV.git
cd GRV/android
export ANDROID_NDK_HOME=$HOME/Android/Sdk/ndk/26.3.11579264
./gradlew assembleDebug

Release 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.


Donate

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.


Credits & license

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.

About

GRV - secure Android client for MasterHttpRelayVPN (Classic, Rust, CFW). TUN + proxy, per-app routing, SNI/IP labs, live logs.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages