一个基于 Jetpack Compose 的 Android 客户端，封装 EasyTier（Rust + Tokio 实现的去中心化 VPN）核心，提供原生的配置管理、网络编排与两种 TUN 接入模式。
✨ Decentralized mesh VPN, reborn as a first-class Android citizen.
- 📱 纯 Compose UI — Material 3 + 自适应布局（手机 NavigationBar / 平板 NavigationRail）
- 🔌 双 TUN 模式 —
VPN_SERVICE（免 root，系统 VPN 授权）与ROOT_TUN（root 进程 + 真实easytier0接口） - 🛡️ JNI 门面架构 — 应用层不直接接触原生符号，统一通过
core.EasyTierJni访问 - 💾 DataStore 持久化 — 多 profile 管理 + 选中态，含损坏数据自动恢复
- 🎛️ 全配置项表单 — 覆盖 EasyTier Core 全部字段的分区编辑器（General / Network & Peers / Routing / IPv6 / Port Forwards / VPN Portal / Secure Mode / STUN & Whitelists / Flags — General / P2P / KCP / QUIC），生成结构化 TOML 并经原生
parseConfig校验 - 🌐 Magic DNS — 两种 TUN 模式均支持 EasyTier 内置 DNS（
100.100.100.101）；ROOT_TUN 额外通过 root shell 切换系统 DNS - 👥 Peers 屏幕 — 列出运行时 peer，展示虚拟 IP / 延迟 / 隧道协议 / 丢包率 / NAT 类型 / cost（直连/中继）
- 🌍 Global overrides — 全局共享的 TUN 设备名 /
no_tun/ SOCKS5（端口与监听地址） - 🏷️ Hostname 自动补全 — profile 留空时取 Android 设备名（与 EasyTier Core
get_hostname行为一致） - ⚡ 协程编排 —
SupervisorJob + Mutex串行化运行时状态机，避免竞态
| Dashboard | Profiles |
 |
 |
| Peers | Settings |
 |
 |
| 项 | 值 |
|---|---|
| Android minSdk | 24（Android 7.0） |
| Android targetSdk | 36 |
| Android compileSdk | 37 |
| ABI | arm64-v8a / armeabi-v7a / x86_64 |
| Gradle | 9.5.0 |
| AGP | 9.3.1 |
| JDK | 21（Daemon）/ 11（source/target compat） |
| NDK | 30.0.16138531 / CMake 4.1.2（仅用于编译 root_tun_jni） |
Root TUN 模式需要设备已 root 并授予应用 root 权限。
app/src/main/java/cc/ptoe/easytier/compose/
├── MainActivity.kt # 单 Activity，手动注入
├── core/ # JNI 门面 + 运行时编排器 + 配置生成
│ ├── EasyTierJni.kt
│ ├── EasyTierRuntimeCoordinator.kt
│ └── ProfileConfig.kt
├── data/ # 模型 + DataStore 持久化
│ ├── EasyTierModels.kt # EasyTierProfile / GlobalSettings / RuntimePeer ...
│ └── ProfileRepository.kt # ProfileRepository + GlobalSettingsRepository
├── transport/ # TUN 抽象 + 两种实现
│ ├── RuntimeTransport.kt
│ ├── vpn/ # VpnService 实现（免 root）
│ └── root/ # libsu RootService 实现（root）
└── ui/ # Compose UI + ViewModel + Theme
├── EasyTierApp.kt # Dashboard / Profiles / Peers / Settings / Editor
├── EasyTierViewModel.kt
└── theme/
| 维度 | VPN_SERVICE | ROOT_TUN |
|---|---|---|
| 实现 | VpnService.Builder |
/dev/net/tun + netlink |
| 权限 | 系统 VPN 授权弹窗 | root（libsu RootService IPC） |
| 前台服务 | specialUse |
否（root 进程内运行） |
| Magic DNS | 支持（100.100.100.101） |
支持（root 进程内运行 + settings put global dns1 切换系统 DNS） |
| 设备名 | Android VPN（虚拟） | easytier0（真实接口） |
详见 AGENTS.md 中的"两种 TUN 模式"章节。
git clone --recurse-submodules <repo-url>
cd EasyTierCompose
# 若已克隆但未拉取 submodule
git submodule update --init --recursive# Debug 构建 + 安装到已连接设备
./gradlew :app:installDebug
# Release APK
./gradlew :app:assembleRelease首次构建时，Gradle 会通过 foojay-resolver 自动下载 JDK 21 用于 Daemon。
./gradlew :app:testDebugUnitTest测试覆盖 TomlConfigBuilder（结构化 TOML、port forward / VPN portal / secure mode / 全 flags 字段、rootTunSpec）、ProfileValidator（CIDR / MTU / peers / proxy networks / port forwards / VPN portal / SOCKS5 端口 / bps 限制等校验）与 GlobalSettings 覆盖，通过 NativeConfigParser 桩绕过真实 JNI。
本项目包含两个原生库，来源与构建方式不同：
| 库 | 来源 | 构建方式 |
|---|---|---|
libroot_tun_jni.so |
app/src/main/cpp/root_tun_jni.cpp |
Gradle externalNativeBuild（CMake）自动编译 |
libeasytier_android_jni.so |
EasyTier-Core/easytier-contrib/easytier-android-jni/ |
预构建，已置于 app/src/main/jniLibs/<abi>/ |
如需重新构建 libeasytier_android_jni.so（需要 Rust + Android NDK）：
cd EasyTier-Core/easytier-contrib/easytier-android-jni
./build.sh
# 将 target/android/<abi>/libeasytier_android_jni.so 拷贝到
# app/src/main/jniLibs/<abi>/不要将 libeasytier_android_jni.so 纳入 Gradle 构建。
AndroidManifest.xml 声明以下权限：
INTERNET— 网络通信FOREGROUND_SERVICE+FOREGROUND_SERVICE_SPECIAL_USE— VPN 前台服务POST_NOTIFICATIONS— VPN 状态通知BIND_VPN_SERVICE（服务级）— 仅系统可绑定EasyTierVpnService
VPN 前台服务的 PROPERTY_SPECIAL_USE_FGS_SUBTYPE 标注为 EasyTier virtual network transport。
- JNI 调用：只使用
cc.ptoe.easytier.compose.core.EasyTierJni，禁止直接调用com.easytier.jni.EasyTierJNI - 不自动连接：
MainActivity.onResume()有意留空，连接必须由用户显式触发 - 运行中不可编辑/删除/切换模式：profile 处于
STARTING/RUNNING状态时，编辑、删除、切换 TUN 模式均被拒绝；Reset 会先停止运行时再清空 - GlobalSettings：TUN 设备名 /
no_tun/ SOCKS5 选项独立持久化，所有 profile 共享；ProfileValidator.validate与TomlConfigBuilder.build均需显式传入 - Hostname 自动补全：profile 留空时协调器从 Android 设备名补全（与 EasyTier Core
get_hostname一致） - netlink 路由：TUN 远端网络路由必须使用
RT_SCOPE_UNIVERSE，否则对任意 CIDR 返回EINVAL - IPv4 解析：EasyTier 序列化的
addr是u32::from_be_bytes的 big-endian 整数，需按大端拆解
完整开发约定见 AGENTS.md。
- Kotlin 2.2.10 + Coroutines 1.10.2 + Serialization 1.9.0
- Jetpack Compose BOM 2026.02.01 + Material 3 + Material Icons Extended
- AndroidX Activity Compose 1.13.0 / Lifecycle 2.11.0 / DataStore 1.2.1 / Core KTX 1.19.0
- libsu 6.0.0（root IPC + RootService）
- CMake 3.22.1 + C++20（root TUN JNI）
本项目基于 GNU General Public License v3 发布。
EasyTier Compose
Copyright (C) 2026 EasyTier Compose Contributors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
封装的 EasyTier 核心（EasyTier-Core/ submodule，来自 https://github.com/ECSDevs/EasyTier）采用 LGPLv3。重新分发或修改该 submodule 内的代码须遵循 LGPLv3 条款。