在受支持的 OpenWrt 或 iStoreOS 上，安装与路由器匹配的两个软件包，然后在 LuCI 打开网络 > VilaNet，用 VilaVPN 账户登录并连接。不要导入订阅链接。先备份，并先看清软件包管理器和 CPU 架构，再下载。
路由器还不是受支持的 OpenWrt，或你不确定该不该刷机时，先看该用 OpenWrt 版还是 Merlin 版。改路由器会影响局域网里的所有设备。
1. 备份并读出架构
- 在 LuCI 打开系统 > 备份/升级，生成配置备份，存到路由器以外的地方。
- 记下路由器型号、OpenWrt 版本、CPU 架构，以及用的是
opkg还是apk。 - 确认你能从局域网打开 LuCI 或 SSH。需要已设置的 root 密码、LuCI 和 SSH 的管理员权限，以及一个有效的 VilaVPN 账户。
SSH 里可以这样查看：
cat /etc/openwrt_release
command -v opkg || command -v apk
opkg print-architecture 2>/dev/null || apk --print-archopkg print-architecture 可能有多行。核心包用优先级数字最高的那一个具体架构，忽略 all 和 noarch。不要只凭路由器的商品名猜测。
2. 按系统选两个包
| 路由器 | 下载什么 | 怎么装 |
|---|---|---|
| iStoreOS | 当前发布里的 .run 安装程序 | iStore > 手动安装 |
使用 opkg 的 OpenWrt 24.x | 与架构匹配的核心 IPK，以及标记为 all 的 LuCI IPK | opkg install |
使用 apk 的 OpenWrt 25.x | 与架构匹配的核心 APK，以及标记为 noarch 的 LuCI APK | apk add |
核心包目前提供的架构有：x86_64、aarch64_cortex-a53、aarch64_generic、arm_cortex-a7_neon-vfpv4、mipsel_24kc、arm_arm926ej-s。从官方发布页下载当前文件，文件名以页面上的为准，不要自拟版本号。GitHub 较慢时，用 openwrt.vilavpn.com 上的架构选择和镜像选择生成下载命令。旧的 vilanet-test-*.tar.gz 手动复制方法已经停用。
OpenWrt 25 的包是本地发布文件，不是路由器软件源里的包，所以安装时要加 --allow-untrusted。复制或安装之前，先用发布页上的 SHA-256 核对。macOS 用 shasum -a 256，Linux 或路由器上用 sha256sum。有任何一个值对不上，就不要安装。这里不抄校验表，以发布页当前值为准。
3. 安装
iStoreOS：打开 iStoreOS 网页，进入iStore > 手动安装，上传 .run 文件，离开页面前看完安装结果，然后打开网络 > VilaNet。
OpenWrt 24.x：把两个 IPK 复制到路由器的 /tmp。全新系统要先更新软件包列表，否则 opkg 找不到 VilaNet 依赖的内核模块。
opkg update
opkg install /tmp/<核心包>.ipk /tmp/<LuCI包>.ipk
/etc/init.d/vilanet enableOpenWrt 25.x：同样先复制到 /tmp，再安装。安装程序会从 /tmp 删掉 LuCI 包。要再执行一次，需重新复制那个文件。
apk add --allow-untrusted --force-non-repository \
/tmp/<核心包>.apk /tmp/<LuCI包>.apk
/etc/init.d/vilanet enable4. 登录并连接
- 安装后刷新 LuCI。
- 打开网络 > VilaNet。
- 在概览输入 VilaVPN 账户的电子邮件地址和密码。
- 选择登录。官方路由器软件用账户登录，不需要订阅链接，也不需要激活订阅。
- 在同一页的快速操作里，第一次连接把服务器留在自动 - 所有服务器，或改选一台服务器。服务器选项卡里每台服务器旁也有连接。
- 选择连接。
怎样算安装成功
先看路由器：
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet再用一台连着这台路由器的设备打开一个普通 HTTPS 网站。回到网络 > VilaNet > 概览，确认 VPN 服务 仍是 running，连接状态 仍是 connected。只看到“已连接”不够，路由器状态和局域网设备的访问都要成功。
仍然不行？
没有 VilaNet 菜单时：强制刷新 LuCI 页面，用 SSH 执行 /etc/init.d/rpcd restart，再打开网络 > VilaNet，并确认核心包和 LuCI 包都已安装。
启动后又停止时，先保留上面几条命令的输出，不要马上重装。联系支持时提供路由器型号、OpenWrt 版本、软件包管理器，以及遮盖过的输出。不要发送密码或原始订阅数据。
显示已连接但局域网设备上不了网，看OpenWrt 显示已连接，但局域网设备上不了网。要改路由模式之前，先看三种路由模式和恢复与回滚。逐步图解在 openwrt.vilavpn.com 和安装文档。