A transparent networking control plane for rooted Android.
MagicNet manages subscriptions, app/domain/Wi-Fi/hotspot routing, DNS, selectors and Tailscale through a multilingual web console and CLI. It supports explicit tun|ebpf modes, defaults to TUN, and packages a sing-box-compatible runtime for Android root/arm64 with Magisk, KernelSU or APatch.
| Goal | Entry point |
|---|---|
| Install and use MagicNet | Releases and v1.8.5 installation notes |
| Build the maintained implementation | Source repository and build guide |
| Rebuild from requirements | Product recipe and acceptance |
| Publish a version | Release guide |
| Layer | Current state |
|---|---|
| Published Android package | v1.8.5 / 10613 |
| Recipe | 0.3.18 |
| Fixed implementation commit | 351b7d7189c057ba88c4da89092e5bc4124989d0 |
| Fixed sing-box core | d850ff0ff68e11a71aa8207627e0a826cb52808f / 1.15.0-alpha.13 |
The recipe defines required behavior; the pinned source provides the maintained implementation; Releases provide installable artifacts. Verification records source tests, package checks and Android emulator results separately. Physical-device acceptance, real subscription connectivity and sustained mobile performance remain open; see performance and Issue tracking.
git clone --recurse-submodules https://github.com/LIghtJUNction/MagicNet.git
cd MagicNet
git submodule update --init --recursive generated/magicnet-android
cd generated/magicnet-android
kam build -j 2Follow the build guide for the pinned Rust, Go, Node, Java and Android toolchains. The complete local package is generated/magicnet-android/dist/MagicNet.zip relative to the primary repository.
Install Git and the Recipkg CLI, then render the complete requirements for an implementation agent:
set -eu
recipkg check recipes/magicnet
recipe_tmp="$(mktemp -d)"
trap 'rm -rf "$recipe_tmp"' EXIT
recipkg pack recipes/magicnet -o "$recipe_tmp/magicnet.recipe.tar.gz"
recipkg check "$recipe_tmp/magicnet.recipe.tar.gz"
recipkg build "$recipe_tmp/magicnet.recipe.tar.gz" --lang zh-CNrecipkg build renders a prompt. The agent must implement the product and execute ACCEPTANCE.md. Independent reconstruction starts with an empty implementation directory and the complete Markdown dependency closure; its permitted external assets are defined in the recipe. Keep .env, subscriptions, credentials and private device data outside source, archives and prompts.
The eight packages cover the product, control plane, network runtime, packet engine, routing policy, web console, module delivery and shared quality requirements. DEPENDENCIES.md maps their responsibilities.
Update affected recipes, interfaces and acceptance cases with behavior changes. Verify and push source changes before updating the primary repository's gitlink. Build and release MagicNet supports build, verify and publish, version bumping and exact versions; releasing.md owns the inputs and recovery procedure.
Local checks:
python3 scripts/check-recipes.py
python3 scripts/test-release.py
python3 scripts/test-release-plan.py
python3 scripts/test-check-recipes.pySOURCE_AUDIT.md records inspected source; PROVENANCE.md retains attribution and historical anchors, including the v1.8.0 import. MagicNet uses the MIT License; third-party components retain their own licenses.