EasyTier for Magisk/KernelSU/APatch

在 Android 设备上以系统级 TUN 模式运行 EasyTier VPN 组网。

版本说明

• 模块版本：独立维护，用于表示本仓库自身的功能与修复更新
• EasyTier Core 版本：表示当前打包附带的 easytier-core / easytier-cli 上游版本，由仓库根目录的 CORE_VERSION 文件维护

例如，一个版本可以表示为：

• Module: v1.1.2
• Bundled EasyTier Core: v2.6.4

和官方实现的区别

官方项目已经提供了 easytier-magisk 与 easytier-web-dashboard。本仓库并不是对官方实现的替代，而是一个更偏向 Android 设备本地运维体验的实现：

• 提供内置 WebUI，可直接在 KernelSU/APatch Manager 里查看状态、Peer、日志并编辑本机配置
• 提供统一的本地命令行入口：easytier {start|stop|restart|status|enable|disable}
• 支持开机自启开关，且状态会同时显示在 WebUI 和命令行中
• 明确面向 Magisk、KernelSU、APatch 三种框架

相对地，官方实现更偏向原生脚本方案与官方 Dashboard 生态，例如热点/USB 共享转发、启动参数模式，以及独立的 Web Dashboard。

功能

• 可配置的开机自动启动（首次安装需先配置）
• 命令行管理（start/stop/restart/status/enable/disable）
• KernelSU/APatch WebUI 管理界面
  • 查看运行状态与节点信息
  • Peer 列表实时查看
  • 开机自启动开关
  • 在线编辑配置文件，支持保存并重启
  • 错误日志查看
• 兼容 Magisk、KernelSU、APatch 三大框架
• 重刷模块不会覆盖已有配置

安装

1. 从 EasyTier Releases 下载 easytier-linux-aarch64 包
2. 将 easytier-core 和 easytier-cli 放入模块根目录
3. 打包为 zip，在 Magisk/KSU/APatch Manager 中刷入
4. 编辑配置文件 /data/adb/easytier/config/config.toml（填入你的服务器地址和网络信息）
5. 手动运行 easytier start 或重启设备

⚠ 首次安装不会自动启动服务，需要先编辑好配置。默认启用“开机自动启动”，你也可以在 WebUI 中随时关闭。

KernelSU 未安装 meta-overlayfs/元模块时，系统 PATH 里可能没有 easytier 命令；模块 WebUI 和开机启动会自动使用 /data/adb/easytier/easytier fallback。需要手动执行命令时，可使用完整路径 /data/adb/easytier/easytier start。

仓库已提供 GitHub Actions，可用于自动校验脚本、打包模块，以及手动创建 Release。

管理

easytier start    # 启动
easytier stop     # 停止
easytier restart  # 重启
easytier status   # 查看运行状态和开机自启状态
easytier enable   # 开启开机自启
easytier disable  # 关闭开机自启

KernelSU/APatch 用户可在 Manager 中打开模块 WebUI 进行管理和配置编辑。

KernelSU 用户在模块列表中可直接看到运行状态和 IP 信息。

配置

配置文件位于 /data/adb/easytier/config/config.toml，示例：

instance_name = "android"
dhcp = false
ipv4 = "10.144.144.10"
listeners = []

[network_identity]
network_name = "mynet"
network_secret = "mysecret"

[[peer]]
uri = "tcp://YOUR_SERVER_IP:11010"

[flags]
default_protocol = "udp"
enable_encryption = true
mtu = 1300

兼容性

• Magisk ≥ v20.4
• KernelSU ≥ 0.6.7
• APatch
• Android ≥ 9 (API 28)
• arm64 设备

KernelSU 用户不强制要求安装 meta-overlayfs/元模块；安装后模块会同时在 /data/adb/easytier/ 放置一份运行入口，用于无系统 overlay 环境下的 WebUI 和开机启动。