luci-app-easytier快速开始:5分钟在OpenWrt安装部署EasyTier去中心化VPN组网

原创2026-10-27 14:43:241,644 阅读

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 分钟)

  1. 从项目 Releases 下载对应 CPU 架构的 IPK / APK 安装包
  2. 上传到路由器 /tmp 目录
  3. 通过 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
  1. 刷新或重新登录 LuCI 网页,侧边栏即可看到 VPN → EasyTier 菜单

⚠️ 安装前请确保依赖 kmod-tun 和 luci-compat 已安装(依赖声明见 luci-app-easytier/Makefile):

opkg update
opkg install kmod-tun

方式二:本地 SDK 编译(适合进阶用户)

  1. 下载并解压与你路由器匹配的 OpenWrt SDK
  2. 克隆项目到 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"
  1. 把生成的 .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 步:

  1. 安装预编译 IPK / APK(opkg install 一条命令)
  2. 上传或自动下载 EasyTier 程序
  3. 填好网络名称与密钥,启用并保存

无需端口映射、无需自建服务器,配合 EasyTier 的其他平台客户端,即可快速组建跨家庭、跨办公室的私有虚拟局域网。开发规范与技术栈细节可参考 DEVELOPMENT.md。

登录后查看全文
luci-app-easytier