luci-app-easytier快速开始:5分钟在OpenWrt安装部署EasyTier去中心化VPN组网
luci-app-easytier快速开始:5分钟在OpenWrt安装部署EasyTier去中心化VPN组网
luci-app-easytier 是 OpenWrt LuCI 管理插件,用于一键部署 EasyTier——一款简单、安全、去中心化的内网穿透 VPN 组网方案。它提供完整图形化界面:安装程序、配置网络名称与密钥、查看状态与日志全部在网页里完成,几分钟即可把 OpenWrt 路由器变成私有虚拟网络的核心节点。本文面向新手,带你从零完成安装到组网上线。
📦 luci-app-easytier 是什么?
EasyTier 是一个用 Rust 编写的去中心化内网穿透 VPN 方案:节点之间无需自建服务器即可互相发现,在 NAT 后也能直连打通。luci-app-easytier 把它封装成 OpenWrt 插件,在 LuCI 中提供 5 个功能页面:
- 📊 状态:实时流量监控、网卡状态、版本与连接信息
- ⚙️ EasyTier Core:配置网络名称、网络密钥、监听端口等核心参数
- 🌐 自建控制台:配置 easytier-web 控制台
- 📝 日志:查看运行日志,支持级别过滤
- 📤 上传程序:上传 EasyTier 二进制文件或压缩包(支持
.zip/.tar.gz/.tar)
完整特性说明见 README.md。
✅ 兼容性一览表
| 项目 | 支持范围 |
|---|---|
| OpenWrt 版本 | 18.06 / 18.08,19.x ~ 26.x |
| 包格式 | IPK(22.03.x)与 APK(SNAPSHOT) |
| ARM 架构 | aarch64、armv7、arm |
| MIPS 架构 | mips、mipsel |
| x86 架构 | x86_64 |
当前配套的 EasyTier 核心版本号统一由 version.mk 管理(v2.7.0),三个子包共用同一版本。
🚀 快速安装:3 种方式任选
方式一:预编译包一键安装(推荐,约 2 分钟)
- 从项目 Releases 下载对应 CPU 架构的 IPK / APK 安装包
- 上传到路由器
/tmp目录 - 通过 SSH 安装:
# 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 菜单
⚠️ 安装前请确保依赖
kmod-tun和luci-compat已安装(依赖声明见 luci-app-easytier/Makefile):opkg update opkg install kmod-tun
方式二:本地 SDK 编译(适合进阶用户)
- 下载并解压与你路由器匹配的 OpenWrt SDK
- 克隆项目到 SDK 中:
git clone https://gitcode.com/gh_mirrors/lu/luci-app-easytier package/luci-app-easytier
cd openwrt-sdk-*/
# 更新 feeds 并生成 defconfig
./scripts/feeds update -a
./scripts/feeds install -a
make defconfig
# 编译插件
make package/luci-app-easytier/compile V=s
# 查找生成的安装包
find bin/ -name "luci-app-easytier*.ipk"
- 把生成的
.ipk传到路由器,按方式一安装即可
💡 仓库还附带两个辅助包:easytier/Makefile 会打包 EasyTier 核心 + Web 控制台;easytier-noweb/Makefile 只打包核心程序、不含 Web 控制台,适合空间紧张或 MIPS 设备。
方式三:自动在线下载(免上传)
插件的启动脚本 luci-app-easytier/root/etc/init.d/easytier 内置自动下载逻辑:启动时若检测不到 easytier-core,会识别 CPU 架构后自动从官方渠道下载最新版(内置多个加速代理依次重试,逻辑见 download.sh)。若自动下载失败,再切换到 上传程序 页面手动上传二进制。
⚙️ 首次配置:3 步开启 VPN 组网
打开 LuCI 网页,进入 VPN → EasyTier:
1️⃣ 准备 EasyTier 程序
- 自动下载:设备能上网时,首次启动会自动下载对应架构的程序
- 手动上传:在 上传程序 页面选择二进制文件,支持单个文件
easytier-core、easytier-cli、easytier-web-embed,也支持压缩包整包上传
2️⃣ 填写核心参数
在 EasyTier Core 页面填入两个最关键参数:
| 参数 | 说明 | 示例 |
|---|---|---|
| 网络名称 | 标识 VPN 网络,所有节点必须一致 | mynetwork |
| 网络密钥 | 校验节点身份,所有节点必须一致 | mysecret |
其余参数新手可保持默认。默认 UCI 配置文件为 luci-app-easytier/root/etc/config/easytier;如果你习惯配置文件方式启动,可直接编辑 luci-app-easytier/root/etc/easytier/config.toml。
3️⃣ 启用并保存
勾选 启用 开关,点击 保存并应用。插件会自动帮你完成一整套底层工作:
- ✅ 创建
EasyTier虚拟网络接口与防火墙区域(自动 MASQUERADE、MSS 钳制) - ✅ 按你填写的 TCP / UDP / WS / WSS / WG 端口自动放行防火墙规则
- ✅ 以 procd 守护进程方式拉起
easytier-core,崩溃自动重启(1 小时内最多 20 次) - ✅ 可选开启 通断检测:指定的远端 IP 全部 ping 不通时自动重启程序
全部 60 余项可配置参数(监听端口、加密算法、压缩、SOCKS5、KCP/QUIC 代理等)定义在 luci-app-easytier/luasrc/model/cbi/easytier.lua。
🔍 状态与日志查看
状态 页面可一屏看清 EasyTier 版本、CPU/内存占用、虚拟网卡状态与 IP、对等节点连接列表及实时流量,页面模板见 luci-app-easytier/luasrc/model/cbi/easytier_status.lua。
日志 页面支持按级别过滤(Error / Warning / Info / Debug / Trace),日志落盘于路由器 /tmp/easytier.log,并自动做 5MB 滚动裁剪,不会写满内存。
🛠️ 常见问题排查
Q1:安装后 LuCI 看不到 EasyTier 菜单?
清除 LuCI 缓存后重新登录:
rm -rf /tmp/luci-*
Q2:自动下载程序失败?
检查设备是否能访问外网;不行就通过 上传程序 页面手动上传对应架构的二进制或压缩包。
Q3:升级时提示配置文件冲突?
正常现象:旧配置会保留,新配置另存为 /etc/config/easytier-opkg,可忽略。卸载/重装前脚本也会自动备份配置到 /tmp,重启设备前重装不会丢配置(备份逻辑见 luci-app-easytier/Makefile)。
Q4:日志出现 util.pcdata 警告?
sed -i 's/util.pcdata/xml.pcdata/g' /usr/lib/lua/luci/model/cbi/easytier.lua
📝 总结
用 luci-app-easytier 在 OpenWrt 上搭建 EasyTier 去中心化 VPN,只需 3 步:
- 安装预编译 IPK / APK(
opkg install一条命令) - 上传或自动下载 EasyTier 程序
- 填好网络名称与密钥,启用并保存
无需端口映射、无需自建服务器,配合 EasyTier 的其他平台客户端,即可快速组建跨家庭、跨办公室的私有虚拟局域网。开发规范与技术栈细节可参考 DEVELOPMENT.md。