mirror of https://github.com/therealaleph/MasterHttpRelayVPN-RUST.git synced 2026-05-18 06:24:35 +03:00

Files

T

Shin (Former Aleph) 91015b0594 v1.0.0: multi-arch Android APK + GitHub Actions release job + install docs (#30 )

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>

2026-04-23 02:56:39 +03:00

4.2 KiB

Raw Blame History

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 اصلی مراجعه کنید.

4.2 KiB Raw Blame History