如何恢复或回滚 VilaNet 路由器安装？

请先不要重置路由器或重新刷写固件。首先恢复普通互联网访问，保留一份简要诊断记录，并确定问题来自 VilaNet 服务、其软件包还是路由器固件。

{% hint style="warning" %} 请勿将重新刷写固件作为第一个故障排除步骤。固件操作失败或固件不兼容可能导致路由器无法访问。固件恢复因型号而异，不在本指南的范围内。 {% endhint %}

首先恢复互联网访问

如果路由器下游的设备无法访问互联网，请通过 SSH 停止 VilaNet：

/etc/init.d/vilanet stop
/etc/init.d/vilanet status

在连接到路由器的设备上测试普通 HTTPS 网站。如果互联网访问恢复，请让 VilaNet 保持停止状态，同时收集证据。

如果无法通过网络访问路由器，请按照路由器制造商针对该准确型号提供的本地恢复说明操作。不要使用通用固件镜像。

记录当前状态

重新安装任何内容前运行以下命令：

cat /etc/openwrt_release
command -v opkg || command -v apk
vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet

在本地保存输出。发送给支持团队前请先检查，并移除电子邮件地址、订阅数据、服务器标识符、IP 地址或令牌。绝不要发送密码。

还请记录：

• 路由器制造商和准确型号
• 是否仍能通过 LuCI 和 SSH 访问路由器
• 故障发生前刚刚执行的操作
• 停止 VilaNet 后普通互联网访问是否恢复
• 已安装的 VilaNet 软件包文件名

备份 VilaNet 配置

通过系统 > 备份/升级创建普通 OpenWrt 配置备份，并将其存放在路由器以外的位置。

请将备份视为敏感信息。它可能包含账户或网络配置。不要将完整压缩包附在支持工单中。

选择破坏性最小的恢复方法

修复缺失的 LuCI 菜单

/etc/init.d/rpcd restart

强制刷新浏览器，然后重新打开网络 > VilaNet。如果仍然没有，请检查已安装的软件包：

opkg list-installed 2>/dev/null | grep vilanet
apk list --installed 2>/dev/null | grep vilanet

修复当前版本

同版本修复与首次安装并不是同一种操作。请准确匹配架构，并且只使用在 OpenWrt 上安装 VilaNet中的当前 v1.0.33 版本资源。

对于使用 opkg 的 OpenWrt 24，将两个匹配的 IPK 文件复制到 /tmp，然后运行：

opkg install --force-reinstall \
  /tmp/vilanet-core_1.0.33_<arch>.ipk \
  /tmp/luci-app-vilanet_1.0.33_all.ipk
/etc/init.d/vilanet restart

对于使用 apk 的 OpenWrt 25，同版本修复时不要重复使用全新安装所用的 apk add 命令。apk-tools v3 使用 apk fix --reinstall，而准确的本地文件恢复流程还必须保留版本完整性检查。在该端到端命令发布并经过路由器验证之前，请让 VilaNet 保持停止状态，并使用上述脱敏证据联系支持团队。

对于 iStoreOS，不要假定再次上传当前的同一个 .run 安装程序就能修复同版本安装。v1.0.33 安装程序使用常规软件包安装流程，可能会跳过同版本文件。在支持修复的安装程序流程发布并在 iStoreOS 上得到验证之前，请让 VilaNet 保持停止状态，并使用上述脱敏证据联系支持团队。

重新安装并不能证明恢复成功。安装后，请确认以下三个条件全部满足：

1. /etc/init.d/vilanet status 报告服务正在运行。
2. vilanet status --json 报告预期的连接状态。
3. 路由器下游的设备可以加载普通 HTTPS 网站。

关于降级

旧版软件包可能使用不同的配置架构或凭据格式。不要仅仅因为有旧版资源，就在客户路由器上降级。只有在 VilaVPN 支持团队确认了准确的版本组合、路由器架构和回滚流程后，才可使用旧版本。

仅在必要时移除 VilaNet

移除软件包会更改路由器，并可能移除 Web 界面，同时留下需要单独处理的敏感配置。如果目标是完全卸载，请向支持团队索取该版本专用的移除流程。临时恢复时，停止服务更加安全。

应向支持团队发送什么

请发送：

• 准确的路由器型号和 OpenWrt 版本
• VilaNet 版本
• 软件包管理器和架构
• 脱敏后的状态和 VilaNet 日志行
• 停止服务后互联网访问是否恢复
• 对最后一个正常状态和第一个故障状态的简短说明

请勿发送路由器备份、账户密码、原始订阅数据或未经检查的诊断压缩包。