English | 简体中文
OpenWrt LuCI界面，用于管理 EasyTier - 一个简单、安全、去中心化的内网穿透VPN组网方案。
- 🎨 现代化UI设计，支持亮色/暗色主题自动切换
- 📱 完美适配移动端和桌面端
- 🌍 完整的中文/英文国际化支持
- 📊 实时流量监控和网卡状态显示
- 🔄 实时显示性能占用和版本信息
- 📦 支持压缩包和二进制文件上传
- 🔧 灵活的配置管理和备份恢复
- ✅ OpenWrt 18.06 / 18.08
- ✅ OpenWrt 19.x ~ 26.x
- ✅ 支持 IPK (22.03.x) 和 APK (SNAPSHOT) 包格式
- ARM: aarch64, armv7, arm
- MIPS: mips, mipsel
- x86: x86_64
- 从 Releases 下载对应架构的安装包
- 上传到OpenWrt的
/tmp目录 - 安装：
# IPK包 (OpenWrt 22.03.x)
opkg install /tmp/luci-app-easytier_*.ipk
# APK包 (OpenWrt SNAPSHOT)
apk add --allow-untrusted /tmp/luci-app-easytier_*.apk- 刷新浏览器或重新登录LuCI界面
- 在 VPN → EasyTier 中上传EasyTier二进制程序
- Fork本项目
- 修改
.github/workflows/build.yml中的架构列表（可选） - 进入 Actions 页面，手动触发
Build-OpenWrt-EasyTier工作流 - 填写版本号（如
v1.0.0）和发布说明 - 等待编译完成，在 Releases 中下载
# 1. 下载OpenWrt SDK
wget https://downloads.openwrt.org/releases/22.03.7/targets/rockchip/armv8/openwrt-sdk-22.03.7-rockchip-armv8_gcc-11.2.0_musl.Linux-x86_64.tar.xz
tar -xJf openwrt-sdk-*.tar.xz
cd openwrt-sdk-*/
# 2. 克隆项目
git clone https://github.com/EasyTier/luci-app-easytier.git package/luci-app-easytier
# 3. 更新feeds并配置
./scripts/feeds update -a
./scripts/feeds install -a
make defconfig
# 4. 编译
make package/luci-app-easytier/compile V=s
# 5. 查找生成的ipk
find bin/ -name "luci-app-easytier*.ipk"kmod-tun- TUN/TAP内核模块（必需）luci-compat- LuCI兼容层
安装前请确保已安装 kmod-tun：
opkg update
opkg install kmod-tun- 安装插件后，进入 VPN → EasyTier
- 在 上传程序 页面上传EasyTier二进制文件或直接安装包含核心的ipk/apk包（easytier.ipk easytier.apk）
- 支持单个文件：
easytier-core,easytier-cli,easytier-web-embed - 支持压缩包：
.zip,.tar.gz,.tar
- 支持单个文件：
- 在 EasyTier Core 页面配置网络参数
- 启用并保存配置
支持两种配置方式：
- 命令行参数：通过LuCI界面配置各项参数
- 配置文件：使用
/etc/easytier/config.toml配置文件
- 状态 - 查看运行状态、版本信息、连接信息和实时流量
- EasyTier Core - 配置核心参数（网络名称、密钥、节点等）
- 自建控制台 - 配置easytier-web控制台
- 日志 - 查看运行日志，支持级别过滤
- 上传程序 - 上传和管理EasyTier二进制文件
- 后端: Lua 5.1 (LuCI旧架构)
- 前端: HTML + CSS + ES5 JavaScript
- 渲染: 服务器端渲染 (SSR)
- 国际化: LuCI原生i18n (.po文件)
- ✅ 必须兼容 OpenWrt 18.06 ~ 26.x
- ✅ 使用 LuCI Lua1 架构（同时兼容Lua2）
- ❌ 禁止使用 LuCI JS框架 (view.js/form.js/rpc.js)
- ❌ 禁止使用 ES6+ 语法 (let/const/箭头函数/fetch)
// ✅ 允许
var xhr = new XMLHttpRequest();
function handleClick() { }
document.getElementById('id');
// ❌ 禁止
const data = await fetch('/api');
let result = () => {};
import module from 'module';-- ✅ 使用 Lua1 API
local http = require "luci.http"
local uci = require "luci.model.uci".cursor()
http.write_json({success = true})
-- ❌ 禁止 Lua2 特有语法
-- 不使用新版 LuCI JS API-- Lua中
local translate = i18n.translate
translate("Text to translate")
-- HTM模板中
<%:Text to translate%>
-- JavaScript中（由Lua注入）
var msg = '<%=translate("Text")%>';luci-app-easytier/
├── luasrc/
│ ├── controller/
│ │ └── easytier.lua # 路由和API控制器
│ ├── model/cbi/
│ │ ├── easytier.lua # 配置页面
│ │ └── easytier_status.lua # 状态页面
│ └── view/easytier/
│ ├── easytier_status.htm # 状态页面模板
│ ├── easytier_log.htm # 日志页面
│ ├── easytier_upload.htm # 上传页面
│ └── ...
├── root/
│ ├── etc/
│ │ ├── config/easytier # UCI配置文件
│ │ ├── init.d/easytier # 启动脚本
│ │ └── easytier/ # 配置目录
│ └── usr/share/easytier/
│ └── download.sh # 下载脚本
├── po/
│ ├── zh_Hans/easytier.po # 简体中文翻译
│ └── templates/easytier.pot # 翻译模板
└── Makefile # OpenWrt包定义
-- API路径格式
entry({"admin", "vpn", "easytier", "api_name"}, call("function_name")).leaf = true
-- 返回JSON格式
function api_name()
luci.http.prepare_content("application/json")
luci.http.write_json({
success = true,
data = {},
message = "Success"
})
end- Fork项目并创建分支
- 确保代码符合开发规范
- 测试在 OpenWrt 18.06 和最新版本上的兼容性
- 提交Pull Request
详细开发规范请参考 开发指南
# 清除LuCI缓存
rm -rf /tmp/luci-*
# 重新登录LuCI界面sed -i 's/util.pcdata/xml.pcdata/g' /usr/lib/lua/luci/model/cbi/easytier.lua升级时如果提示配置文件冲突，旧配置会保留，新配置保存为 /etc/config/easytier-opkg，可以忽略此报错。
本项目采用 Apache License 2.0 许可证。
欢迎提交 Issue 和 Pull Request！