VilaVPN 帮助中心
购买套餐
1.0.44核对日期 2026-10-25

如何在 OpenWrt 上安装 VilaNet?

安装与路由器匹配的两个软件包,然后在 LuCI 中打开 网络 > VilaNet,登录并连接。请先备份路由器,并在下载任何文件前确认其软件包管理器和 CPU 架构。

需要完整图文参考? 请打开内容更丰富的 VilaNet OpenWrt 指南,查看不同软件包的安装步骤、架构选择、截图和高级故障排除。本页继续作为多语言安全入门指南。

{% hint style="warning" %} 更改路由器可能会中断网络中所有设备的连接。开始前,请保留路由器配置副本,并确保可以通过本地网络访问 LuCI 或 SSH。 {% endhint %}

所需条件

  • 受支持的 OpenWrt 或 iStoreOS 路由器
  • 使用 opkg 的 OpenWrt 24.x,或使用 apk 的 OpenWrt 25.x
  • 已设置路由器 root 密码
  • LuCI 和 SSH 管理员访问权限
  • 有效的 VilaVPN 账户
  • 当前的 VilaNet OpenWrt 版本

本指南目前验证过的公开版本是 v1.0.44。

备份路由器

在 LuCI 中打开 系统 > 备份/升级,然后创建配置备份。将压缩包存放在路由器以外的位置。

还请记录:

  • 路由器型号
  • OpenWrt 版本
  • CPU 架构
  • 路由器使用 opkg 还是 apk

在 SSH 会话中,以下命令会显示相关详细信息:

cat /etc/openwrt_release
command -v opkg || command -v apk
opkg print-architecture 2>/dev/null || apk --print-arch

opkg print-architecture 可能返回多行。请使用优先级数字最高的具体架构;核心软件包应忽略 all 和 noarch。例如,当 aarch64_cortex-a53 的优先级更高时,应选择它而不是 all。

选择安装方式

路由器 文件 安装方式
iStoreOS vilanet-istore-install_1.0.44.run iStore > 手动安装
OpenWrt 24.x vilanet-core_1.0.44_<arch>.ipk 和 luci-app-vilanet_1.0.44_all.ipk opkg install
OpenWrt 25.x vilanet-core_1.0.44_<arch>.apk 和 luci-app-vilanet_1.0.44_noarch.apk apk add

将 <arch> 替换为路由器报告的架构。不要只根据路由器的营销名称来猜测。

验证 OpenWrt 25 下载文件

OpenWrt 25 软件包使用 --allow-untrusted 安装,因为它们是本地发布文件,而不是来自路由器所配置的软件源。将文件复制到路由器或安装之前,务必验证其 SHA-256 值。

文件 v1.0.44 的预期 SHA-256
vilanet-core_1.0.44_aarch64_cortex-a53.apk a8844e65752052b762222d08692fce373a152883e09167e1748673a532c9347f
vilanet-core_1.0.44_aarch64_generic.apk 42b19eed836589393dea4873dfa5cce3a19e1eb282b55b77f73f08b409b9aa5e
vilanet-core_1.0.44_arm_arm926ej-s.apk e277c184d1e6a4af7628ba0a9e57fdf3eba90ee24b0820102191ecc73b4eeab7
vilanet-core_1.0.44_arm_cortex-a7_neon-vfpv4.apk 974b4c34b897abba938d0094582872b62893b7f9eddda97724f254073b97d622
vilanet-core_1.0.44_mipsel_24kc.apk 16a37e175dbcb43e01fe9753140ca385b870f1576298f62c860f61180b66e27c
vilanet-core_1.0.44_x86_64.apk 4fba942067e9538cac72f99c35789242460afbc3f4e274601d8e8e5a74f01f71
luci-app-vilanet_1.0.44_noarch.apk cb2e1fa3cda1e99d1f025bda15534b8572f1173bef5054dd071f48489818509f

在 macOS 上运行 shasum -a 256 <filename>。在 Linux 或路由器上运行 sha256sum <filename>。如果任何一个值不同,请勿安装这些文件。

在 iStoreOS 上安装

  1. 从当前版本下载 vilanet-istore-install_1.0.44.run。
  2. 打开 iStoreOS Web 界面。
  3. 前往 iStore > 手动安装。
  4. 上传 .run 安装程序。
  5. 离开页面前检查安装结果。
  6. 打开 网络 > VilaNet。

在 OpenWrt 24.x 上安装

下载匹配的核心 IPK 和不依赖架构的 LuCI IPK。将它们复制到路由器:

scp -O vilanet-core_1.0.44_<arch>.ipk root@<router>:/tmp/
scp -O luci-app-vilanet_1.0.44_all.ipk root@<router>:/tmp/

通过 SSH 安装两个软件包:

请先刷新软件包列表。在全新的路由器上,必须先运行 opkg update,opkg 才能找到 VilaNet 依赖的内核模块。

opkg update
opkg install /tmp/vilanet-core_1.0.44_<arch>.ipk \
  /tmp/luci-app-vilanet_1.0.44_all.ipk
/etc/init.d/vilanet enable
vilanet version

在 OpenWrt 25.x 上安装

下载匹配的核心 APK 和 noarch LuCI APK。将它们复制到路由器:

scp -O vilanet-core_1.0.44_<arch>.apk root@<router>:/tmp/
scp -O luci-app-vilanet_1.0.44_noarch.apk root@<router>:/tmp/

通过 SSH 安装两个软件包:

apk add --allow-untrusted --force-non-repository \
  /tmp/vilanet-core_1.0.44_<arch>.apk \
  /tmp/luci-app-vilanet_1.0.44_noarch.apk
/etc/init.d/vilanet enable
vilanet version

安装程序会从 /tmp 删除 LuCI 软件包文件。如需再次运行该命令,请先重新复制该文件到路由器。

登录并连接

  1. 安装后刷新 LuCI。
  2. 打开 网络 > VilaNet。
  3. 在概览中输入 VilaVPN 账户的电子邮件地址和密码。
  4. 选择登录。
  5. 在同一页面的快速操作下,首次连接时将服务器保留为自动 - 所有服务器,或选择特定服务器。服务器选项卡中的每台服务器旁也有连接按钮。
  6. 选择连接。

在真实 OpenWrt LuCI 界面中使用虚构示例地址的 VilaNet 登录表单

这张真实的 LuCI 截图使用保留的示例地址 you@example.com,密码字段为空。为了让登录控件在手机上清晰可读,宽幅路由器页面经过裁剪;没有重建任何界面元素。

实体路由器屏幕截图和局域网流量检查仍是发布证据门槛;仅显示“已连接”绝不能证明隧道可用。

确认工作正常

先检查路由器:

vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet

然后使用连接到路由器的设备:

  1. 打开一个普通 HTTPS 网站。
  2. 返回网络 > VilaNet > 概览。
  3. 确认 VPN 服务 仍显示 running,连接状态 仍显示 connected。

仅显示“已连接”还不够。路由器状态和局域网设备的流量都必须正常。

如果没有 VilaNet 菜单

  1. 强制刷新 LuCI 页面。
  2. 通过 SSH 运行 /etc/init.d/rpcd restart。
  3. 重新打开 LuCI 并检查网络 > VilaNet。
  4. 确认核心软件包和 LuCI 软件包都已安装。

如果 VilaNet 启动后又停止

重新安装前保留证据:

vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet

联系支持时,请提供路由器型号、OpenWrt 版本、软件包管理器和经过脱敏的输出。不要发送密码或原始订阅数据。

不受支持的旧安装程序

旧的 vilanet-test-*.tar.gz 手动复制方法已经停用。请使用官方版本中当前的 IPK、APK 或 iStoreOS 安装程序。

后续步骤

更改路由模式、升级软件包或移除 VilaNet 前,请阅读恢复与回滚。

这个页面对您有帮助吗?