Shin (Former Aleph)
91015b0594
Version bump reflects the scope — a unified Rust core that now ships
for desktop (Linux/macOS/Windows) AND Android from the same crate.
Android changes:
- build.gradle.kts: ABI filters expanded to arm64-v8a + armeabi-v7a
+ x86_64 + x86. cargoBuild{Debug,Release} pass all four ABIs to
cargo-ndk in a single invocation. normalizeTun2proxySo() walks every
ABI dir now (was arm64-only).
- Release buildType signs with the debug keystore — no Play Store
target, so signature identity doesn't matter, installability does.
Gradle auto-provisions ~/.android/debug.keystore if absent, so CI
runners inherit this without extra setup.
- versionName 1.0.0, versionCode 100 (room to bump monotonically).
CI:
- release.yml gets a dedicated `android:` job that sets up JDK 17,
Android SDK/NDK 26, all four rust-android targets, installs
cargo-ndk, runs assembleRelease, and uploads a single universal APK
named `mhrv-rs-android-universal-v<version>.apk` into the same
`dist/` collected by the release job downstream.
- `release:` job now gates on `needs: [build, android]` so tagging
v1.0.0 triggers both build matrices before cutting the GitHub
release.
Docs:
- docs/android.md — full 10-step install walk-through: APK sideload,
Apps Script deployment (with "Advanced → Go to (unsafe) → Allow"
reality check), config paste, SNI reachability test, MITM CA
install with OEM-specific nav paths (Pixel / Samsung / Xiaomi),
Start, troubleshooting common failure modes. Also documents the
known limitations — Cloudflare Turnstile loops (inherent to the
Apps Script egress IP pool), UDP/QUIC not tunnelled, IPv6 leaks,
Apps Script daily quota — so users know what to expect before
trying it on a site that won't work.
- releases/README.md — APK row added to the English and Persian
tables, version bumped everywhere to v1.0.0.
- Top-level README — Android listed under Platforms with a link
to docs/android.md.
Release artifact:
- releases/mhrv-rs-android-universal-v1.0.0.apk — 38 MB universal
APK built locally from this tree. Installs + launches on API 24+.
The CI job will regenerate it on tag push; this is the copy
committed for users who can't reach GitHub Releases.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Prebuilt Binaries
This folder contains the prebuilt binaries from the latest release, committed directly to the repository for users who cannot reach the GitHub Releases page.
Current version: v1.0.0
| File | Platform | Contents |
|---|---|---|
mhrv-rs-android-universal-v1.0.0.apk |
Android 7.0+ (all ABIs) | Universal APK — arm64-v8a, armeabi-v7a, x86_64, x86 in one file |
mhrv-rs-linux-amd64.tar.gz |
Linux x86_64 | mhrv-rs, mhrv-rs-ui, run.sh |
mhrv-rs-linux-arm64.tar.gz |
Linux aarch64 | mhrv-rs, run.sh (CLI only) |
mhrv-rs-raspbian-armhf.tar.gz |
Raspberry Pi / ARMv7 hardfloat | mhrv-rs, run.sh (CLI only) |
mhrv-rs-macos-amd64.tar.gz |
macOS Intel | mhrv-rs, mhrv-rs-ui, run.sh, run.command |
mhrv-rs-macos-amd64-app.zip |
macOS Intel | mhrv-rs.app bundle (double-click from Finder) |
mhrv-rs-macos-arm64.tar.gz |
macOS Apple Silicon | mhrv-rs, mhrv-rs-ui, run.sh, run.command |
mhrv-rs-macos-arm64-app.zip |
macOS Apple Silicon | mhrv-rs.app bundle (double-click from Finder) |
mhrv-rs-windows-amd64.zip |
Windows x86_64 | mhrv-rs.exe, mhrv-rs-ui.exe, run.bat |
mhrv-rs-linux-musl-amd64.tar.gz |
OpenWRT / Alpine x86_64 | static mhrv-rs + mhrv-rs.init (procd) |
mhrv-rs-linux-musl-arm64.tar.gz |
OpenWRT / Alpine aarch64 | static mhrv-rs + mhrv-rs.init (procd) |
Download via git clone
git clone https://github.com/therealaleph/MasterHttpRelayVPN-RUST.git
cd MasterHttpRelayVPN-RUST/releases
Download via ZIP
Go to github.com/therealaleph/MasterHttpRelayVPN-RUST, click the green Code button, then Download ZIP. Extract it — the archives are in the releases/ folder.
After download
Linux / macOS
tar xzf mhrv-rs-macos-arm64.tar.gz
cd mhrv-rs-macos-arm64 # or wherever the archive extracted to
./run.sh # or ./run.command on macOS (double-click in Finder)
Windows
Extract mhrv-rs-windows-amd64.zip, then double-click run.bat inside the extracted folder (accept the UAC prompt so the MITM CA can be installed).
Android
Copy mhrv-rs-android-universal-v1.0.0.apk to your phone, tap it from the Files app, and allow "Install unknown apps" for whichever app is opening the APK (Files, Chrome, etc.). See the Android guide for the full walk-through of the first-run steps (Apps Script deployment, MITM CA install, VPN permission, SNI tester).
See the main README for desktop setup (Apps Script deployment, config, browser proxy settings).
فایلهای اجرایی
این پوشه شامل فایلهای آخرین نسخه است و مستقیماً در ریپو قرار گرفته برای کاربرانی که به صفحهٔ GitHub Releases دسترسی ندارند.
نسخهٔ فعلی: v1.0.0
دانلود از طریق ZIP
به github.com/therealaleph/MasterHttpRelayVPN-RUST بروید، روی دکمهٔ سبز Code کلیک و Download ZIP را بزنید. پس از extract، آرشیوها در پوشهٔ releases/ هستند.
بعد از دانلود
لینوکس / مک:
tar xzf mhrv-rs-macos-arm64.tar.gz
cd mhrv-rs-macos-arm64
./run.sh # در مک میتوانید روی run.command هم از Finder دو بار کلیک کنید
ویندوز: فایل mhrv-rs-windows-amd64.zip را extract کنید و داخل پوشه روی run.bat دو بار کلیک کنید (UAC را قبول کنید تا گواهی MITM نصب شود).
اندروید: فایل mhrv-rs-android-universal-v1.0.0.apk را روی گوشی کپی کنید، از Files app روی آن tap کنید و اجازهٔ "نصب برنامههای ناشناس" را بدهید. راهنمای کامل شروع به کار (دیپلوی Apps Script، نصب CA، اجازهٔ VPN، تستر SNI) در راهنمای اندروید هست.
برای راهاندازی کامل دسکتاپ (دیپلوی Apps Script، config، تنظیم proxy مرورگر) به README اصلی مراجعه کنید.