易组网 / EasyTier-EUI

目录

• 简介
• 快速开始
• 功能简介
• UI界面说明
• Android 版本说明
• 技术栈
• 其他链接
• 贡献
• 支持项目
• 开源协议

简介

简化使用EasyTier的一种UI界面，快速组网（关闭后不影响组网运行）

飞牛版本基于CGI模式实现，不查看组网情况下，仅运行EasyTier核心服务，尽量减少内存使用

快速开始

直接运行

1. 前往 Releases 页面，下载对应平台的安装包
2. 运行程序包 EasyTier-EUI
3. 在「配置」页面添加组网配置，新手推荐快速模式配置，填入网络名和密钥即可
4. 其它设备加入虚拟网络：在「应用」菜单，根据设备系统架构选择对应安装包，根据页面说明，加入组网
5. 在「节点」页面查看组网状态，完成！

Docker 部署

使用 docker-compose.yml 一键启动：

# 一键下载配置并启动
wget https://raw.githubusercontent.com/710850609/EasyTier-EUI/main/docker-compose.yml && docker compose up -d --pull always

配置文件和数据将保存在当前目录下的 config 和 logs 目录中。

Docker 镜像支持多架构：

架构	镜像标签
amd64 / aarch64 / riscv64	latest（正式版）
amd64 / aarch64 / riscv64	edge（预发版）
amd64 / aarch64 / riscv64	dev（开发版）

访问地址：http://<宿主机IP>:15666

功能简介

• 支持多平台

平台	架构	备注
FnOS / FygoOS	x86_64, aarch64	正常版 (以 root 权限运行) 用户版本 (为适配官方上架要求，非 root 应用)
Windows	x86_64	Windows10及其以上版本
Linux	x86_64, aarch64, armv7, riscv64	支持有图形界面 (GUI) 和无图形界面 (Headless) 支持 glibc >= 2.28 支持 musl Linux 已验证支持最低版本：Ubuntu 20.04 / Debian 10 / UOS 20；
MacOS	Intel, arm64	未验证
Android	arm64-v8a, armeabi-v7a	Android 8.0+ (API 26+) 基于 WebView + Chaquopy(Python) + FFI 实现 通过 Android VPN Service 创建 TUN 虚拟网卡
Docker	x86_64, aarch64, riscv64	支持 latest（正式版）/ edge（预发版）/ dev（开发版）标签

• 快速组网，仅填入网络名和密钥即可快速启动
• 支持多种新增配置方式：快速模式、自定义模式、扫码添加、剪贴板导入
• 支持配置二维码分享与扫码加入，方便设备间快速同步
• 提供其它设备组网应用（官方、其它常见第三方）下载连接、组网说明，快速组网
• 支持多配置、配置改名、配置删除
• 支持设置开机自启
• 支持EasyTier常见设置项
• 提供可选初始节点（数据来自网络社区）
• 支持基于本地网络环境，进行初始节点检测：可用性、延迟、可中转
• 支持查看节点中继路径、子网路由/代理协议
• 支持查看 EasyTier 详细日志
• 实验性功能：STUN 监听地址，支持端口转发
• UI自适应大、小屏幕，支持暗黑/亮色模式、毛玻璃效果开关
• 支持多语言（中文/英文）
• 内置 Github 加速下载，支持多代理节点自动测速择优，解决某些网络下载失败问题
• Linux版本启动时，会尝试打开本地浏览器访问页面。如果本地没用浏览器或是无图形界面，会在命令窗口中显示访问地址和二维码，可通过同个局域网其它设备访问（比如手机扫码访问）。

UI界面说明

节点

• 查看各个节点的组网状态：延迟、穿透方式、NAT类型、连接协议等
• 支持查看节点中继路径
• 支持查看节点子网路由和代理协议（KCP/QUIC 等）
• 主机名列悬浮显示对应服务节点的 URI
• 支持按需设置显示列信息、显示普通节点、服务节点、代理/协议
• 支持设置数据刷新速度
• 支持查看 EasyTier 运行日志

配置

• 支持多种新增模式：快速模式（仅填网络名和密钥）、自定义模式、扫描二维码添加、从剪贴板导入
• 支持界面可视化配置EasyTier常见配置项。对于冷门配置，可通过界面编辑文件的形式进行手动编辑配置内容
• 支持多个配置，配置改名、删除
• 支持设置开机自启
• 支持分享网络：生成二维码或复制到剪贴板，将当前配置分享给其它设备
• 支持服务节点检测，包括：可用性、延迟、可中转
• 支持子网代理（含网段映射）、UDP广播中继、连接代理、自定义路由、端口转发、出口节点、socks5 代理
• 支持自定义魔法 DNS 顶级域名
• 支持本机检测初始节点连通

应用

• 支持EasyTier其它平台、架构的组网应用下载，包括：Windows、Linux、MacOS、FnOS、Android、IOS、HarmonyOS，方便下载安装，为快速组网作准备。
• 易组网, easytier-manager-pro2种应用下载时，会内置当前设备组网配置，以方便快速组网
• Docker 页面提供使用说明

STUN

• 支持 STUN 监听地址配置（参考亮一光大佬实现），提供 NAT 穿透辅助
• 支持端口转发，解决应用端口冲突问题
• FnOS / FygoOS / Docker 版本支持开机运行
• 安卓版本暂不支持，其它版本仅支持随应用启动

日志

• 查看 EasyTier 运行日志，方便排查问题

设置

• 支持设置界面主题，包括：暗黑模式、亮色模式、毛玻璃效果开关
• 支持多语言切换（中文/英文）
• 支持EasyTier查看各个版本的更新内容、GitHub下载量、安装指定内核版本。无须访问GitHub，即可查看最新和历史版本信息。
• 支持易组网稳定版、预发版查看更新内容、自更新
• 支持设置自定义可选初始节点
• 支持 GitHub 辅助下载，方便前端设备下载 GitHub 资源
• 支持自定义服务 IP 和端口
• 支持清理日志和缓存
• 安卓版本支持启动恢复开关（打开应用时自动恢复上一次未手动关闭的组网）
• 支持开发者选项

界面

大屏界面

节点管理	配置管理

配置管理	应用下载

设置

小屏界面

节点管理	节点管理	配置管理

配置管理	配置管理

应用下载	设置

Android 版本说明

实现原理

Android 版本与桌面版采用不同的技术方案，但共享同一套 Python 后端和 Vue 前端代码：

层级	桌面版	Android 版
UI 框架	pywebview	Android WebView
Python 嵌入	系统 Python	Chaquopy 17.0.0 (Python 3.12)
EasyTier 核心	子进程调用 CLI	FFI 直接调用 libeasytier_ffi.so
虚拟网卡	系统 TUN 设备	Android VPN Service
前端	Vue 3 + Varlet UI	同桌面版（复用）

权限说明

• VPN 权限：首次启动组网时，系统会弹出 VPN 连接授权对话框，需点击「允许」才能创建虚拟网卡
• 通知权限（Android 13+）：用于显示组网运行状态通知，告知用户 VPN 正在运行。支持自适应中/英文显示，显示 VPN 运行时长
• 存储权限：用于保存配置文件、日志等数据

使用注意事项

1. VPN 独占：Android 系统仅允许同时运行一个 VPN 服务。若启动了其他 VPN 应用（如加速器、广告拦截器等），易组网 VPN 会被系统断开，并收到通知提示
2. 前台服务：组网运行期间会在通知栏显示「易组网」常驻通知，这是 Android 系统对 VPN 服务的强制要求，无法关闭
3. 后台运行：建议在系统设置中将易组网加入电池优化白名单，避免后台被系统限制
4. 网络切换：切换 Wi-Fi 或移动数据时，VPN 会自动重连，无需手动操作
5. 设备架构：支持 arm64-v8a 和 armeabi-v7a 架构，支持大多数现代 Android 设备（64 位和 32 位 ARM）
6. 启动恢复：支持打开应用时自动恢复上一次未手动关闭的组网（默认开启），可在「设置」页面关闭
7. IPv6 与 魔法DNS：VPN 支持 IPv6 和 魔法DNS，MTU 默认 1300（参考官方 Android 固定值）
8. 内核版本选择：支持在设置中选择 EasyTier 内核版本
9. 多配置：受限于 Android 系统，不支持多配置同时运行

安装方式

前往 Releases 页面，下载 EasyTier-EUI-*.apk 安装包，直接安装即可。

技术栈

层级	桌面版技术	Android 版技术
桌面框架	pywebview	Android WebView
前端	Vue 3 + Varlet UI	同桌面版（复用）
后端	Python3	Python 3.12 (Chaquopy)
组网内核	EasyTier	EasyTier FFI (libeasytier_ffi.so)
原生层	-	Kotlin 2.0.0 + Android VPN Service

其他链接

• EasyTier 源码
• EasyTier 文档
• Varlet 文档

贡献

欢迎提交 Issue 和 Pull Request！

• 🐛 提交 Bug 反馈
• ✨ 提出功能建议

支持项目

如果这个项目对你有帮助，欢迎 Star ⭐ 或是 赞赏 支持！

开源协议

本项目基于 GPL-3.0 License 开源。