English | 简体中文
一个 Android Mihomo GUI 客户端,使用 Mihomo、CMFA Mihomo wrapper 和 hev-socks5-tunnel 实现。
- VPN Service、TPROXY(ROOT)、TUN(ROOT) 和 TUN2SOCKS(ROOT) 运行模式
- 支持通过二维码、本地文件、URL 订阅添加配置
- 支持 JavaScript 覆写脚本,用于进阶配置修改
- 通过 Magisk
service.d脚本支持 ROOT 模式开机自启 - MIUIX Compose UI
- 无需 root 权限。
- 使用 Android
VpnService。 - 通过 CMFA bridge 模块在应用进程中运行 Mihomo。
- 适合常规 Android 应用级 VPN 使用场景。
- 需要 root 权限。
- 通过 libsu 直接运行本地 Mihomo 可执行文件。
- 使用 iptables 和策略路由处理透明代理流量。
- 使用已配置的透明代理端口作为 Mihomo 入站。
- 需要 root 权限。
- 通过 libsu 直接运行本地 Mihomo 可执行文件。
- 使用 Mihomo 的 TUN listener 创建固定 TUN 设备
asterisk0。 - 不启用 Mihomo
auto-route,而是使用应用托管的 iptables 和策略路由规则。 - 默认使用 gVisor TUN 栈以优先保证兼容性,用户可以在设置中切换到其他 Mihomo TUN 栈。
- 需要 root 权限。
- 通过 libsu 直接运行本地 Mihomo 可执行文件。
- 使用
hev-socks5-tunnel创建固定 TUN 设备asterisk0。 - 使用 Mihomo 的本地 SOCKS5 入站作为隧道目标。
- 与 TPROXY 共享大部分 ROOT 路由和应用代理行为,但流量会通过 TUN 设备转发,而不是通过 Mihomo 的 TPROXY 入站。
- 运行时文件存储在应用私有的
files/clash目录中,通常为/data/user/0/org.asterisk.zcc.ameta/files/clash。 - 内置 Mihomo 可执行文件会从 native libraries 还原,也可以手动替换为
mihomo可执行文件。 - 自定义资源文件可以手动添加、替换,或通过配置的 URL 更新。
构建前初始化 submodule:
git submodule update --init --recursive使用 Android Studio 打开项目根目录,或通过 Gradle wrapper 构建:
.\gradlew.bat assembleDebugmacOS 或 Linux:
./gradlew assembleDebug构建过程会:
- 使用 Android SDK 和 NDK
- 准备内置 Mihomo 和
hev-socks5-tunnelnative 运行时文件 - 在 CMFA JNI 构建前将 Mihomo submodule checkout 到
ProjectConfig.MIHOMO_CORE_VERSION - 构建 vendored CMFA Go core
- 构建 native
setuidgidhelper - 产出
arm64-v8a、armeabi-v7a、x86、x86_64四个 ABI split APK,以及一个 universal APK
如果 Gradle 找不到 Android NDK,请在 local.properties 中设置 ndk.dir,设置 ANDROID_NDK_HOME,或在 Android SDK 下安装 NDK。
对于 WSA,可以使用以下命令授予 VPN 权限:
appops set org.asterisk.zcc.ameta ACTIVATE_VPN allow


