mirror of
https://github.com/therealaleph/MasterHttpRelayVPN-RUST.git
synced 2026-05-18 07:44:47 +03:00
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>
79 lines
4.2 KiB
Markdown
79 lines
4.2 KiB
Markdown
# 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](https://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
|
|
|
|
```sh
|
|
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](../docs/android.md) for the full walk-through of the first-run steps (Apps Script deployment, MITM CA install, VPN permission, SNI tester).
|
|
|
|
See the [main README](../README.md) for desktop setup (Apps Script deployment, config, browser proxy settings).
|
|
|
|
---
|
|
|
|
## فایلهای اجرایی
|
|
|
|
این پوشه شامل فایلهای آخرین نسخه است و مستقیماً در ریپو قرار گرفته برای کاربرانی که به صفحهٔ GitHub Releases دسترسی ندارند.
|
|
|
|
نسخهٔ فعلی: **v1.0.0**
|
|
|
|
### دانلود از طریق ZIP
|
|
|
|
به [github.com/therealaleph/MasterHttpRelayVPN-RUST](https://github.com/therealaleph/MasterHttpRelayVPN-RUST) بروید، روی دکمهٔ سبز **Code** کلیک و **Download ZIP** را بزنید. پس از extract، آرشیوها در پوشهٔ `releases/` هستند.
|
|
|
|
### بعد از دانلود
|
|
|
|
**لینوکس / مک:**
|
|
|
|
```sh
|
|
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) در [راهنمای اندروید](../docs/android.md) هست.
|
|
|
|
برای راهاندازی کامل دسکتاپ (دیپلوی Apps Script، config، تنظیم proxy مرورگر) به [README اصلی](../README.md) مراجعه کنید.
|