VilaVPN 帮助中心
购买套餐
1.0.18核对日期 2026-11-07

在 Koolshare Merlin 上安装并连接 VilaNet

运行在 Asuswrt-Merlin 中的真实 VilaNet 控制面板
由项目界面测试工具渲染的 VilaNet 1.0.16 Merlin 控制面板:真实页面代码、模拟路由器,为登录前的全新安装状态。

本指南适用于面向 Koolshare rogsoft Broadcom HND 软件包中心固件发布的 VilaNet 公开软件包,涵盖从下载软件包到连接路由器局域网设备的完整过程。

更喜欢丰富多彩的图文呈现? 请打开VilaNet Merlin 指南查看其图解和页面布局。如果该站点的 CLI 示例与本页不同,请以本页已验证的软件包和 Web 界面步骤为准。

实体路由器验证仍待完成。 我们已检查 VilaNet 1.0.18 的软件包、安装程序约定、Web 界面标签和公开版本,但这套完整流程尚未通过实体 HND 路由器证据门槛。在完成该验证之前,请保留路由器备份和当前软件包的副本。

开始前的准备

你需要:

  • 运行 Koolshare Merlin 或 Koolshare official-mod 固件,并带有软件中心(rogsoft)的路由器。
  • 属于受支持 Broadcom HND 软件包系列的路由器。
  • 路由器管理员访问权限。
  • 具有有效服务的 VilaVPN 账户。
  • 连接到该路由器的电脑或手机。

此软件包不支持不带 Koolshare 软件中心的通用 Asuswrt-Merlin、原厂 ASUSWRT、旧版 arm380 或 arm384、QCA、MIPS、MIPSEL 或其他 Merlin 软件包系列。如果无法同时确认支持 Koolshare rogsoft 和 HND,请勿上传该软件包。

首先备份路由器

  1. 打开路由器管理页面。
  2. 使用固件的备份或保存设置功能下载当前路由器配置备份。
  3. 将备份存放在路由器以外的位置。
  4. 记下如何在 VilaNet 未运行时访问路由器管理页面。

没有可用备份时请勿继续。如果已有旧版 VilaNet 服务,安装路由器软件包会暂时将其停止;任何路由器级网络更改都可能影响局域网中的所有设备。

1. 下载当前软件包

下载以下文件,不要解压:

{% embed url="https://github.com/vilavpn/vilanet-merlin/releases/download/v1.0.18/vilanet-rogsoft-hnd-1.0.18.tar.gz" %}

版本页面:VilaNet for Asuswrt-Merlin v1.0.18

预期文件名:

vilanet-rogsoft-hnd-1.0.18.tar.gz

预期 SHA-256:

51f1f099fb254c43d8b121f908dec4bd53245ce058f5ea628d92683cef859ad0

你也可以下载已发布的 SHA-256 文件。如果设备有校验和工具,请在上传前将下载的压缩包与上述值进行比较。不要安装经过重命名、解压或校验和不匹配的文件。

2. 通过 Koolshare 软件中心安装

不同 Koolshare 版本的措辞略有差异,但安全的安装方式都是通过软件中心离线上传软件包。

  1. 保持连接到路由器的局域网。
  2. 打开路由器管理页面。常见地址是 http://router.asus.com 或路由器的局域网 IP 地址。
  3. 以路由器管理员身份登录。
  4. 打开软件中心(Software Center)。
  5. 打开其中的离线安装或手动上传软件包区域。
  6. 选择 vilanet-rogsoft-hnd-1.0.18.tar.gz。不要预先解压该压缩包。
  7. 选择软件中心中用于上传并安装的操作。
  8. 等待安装完成。当软件中心报告正在安装时,请勿刷新、重启或关闭页面。
  9. 返回软件中心,确认 VilaNet 显示为已安装模块。

如果缺少必需的 Koolshare 软件包中心标记,或路由器不在公开 HND 版本矩阵内,安装程序会有意拒绝运行。如果安装被拒绝,不要尝试绕过检查,也不要按照通用 Merlin 说明安装该压缩包。

3. 打开 VilaNet 并登录

  1. 在软件中心中选择 VilaNet。
  2. 确认 VilaNet 页面已打开,并显示以下选项卡:Overview(概览)、Account(账户)、Servers(服务器)、Settings(设置)、Diagnostics(诊断)和 Maintenance(维护)。VilaNet 页面为英文界面,本指南按界面原文标注按钮和选项卡名称。
  3. 打开 Account。
  4. 输入 VilaVPN 账户的电子邮件地址和密码。
  5. 选择 Login。
  6. 等待账户状态确认登录成功。在速度较慢的路由器上,登录可能会在后台继续进行;仍在处理时请勿反复按 Login。

密码字段供登录操作使用,不是路由器管理员密码。绝不要在屏幕截图或支持消息中放入真实密码。

4. 保持自动软件包和服务器节点选择

首次连接时,请使用自动选项,并保持路由设置不变。

  1. 打开 Servers。
  2. 如果目录尚未加载,选择 Refresh Catalogue。
  3. 在 Package 下选择 Auto package。
  4. 在 Servers 下选择 Auto server。
  5. 首次成功连接前,不要更改 Settings 或当前路由模式。

自动选择允许 VilaNet 为账户选择可用的服务软件包和服务器节点。验证首次连接后,如有需要,可以返回 Servers 并选择特定位置。

5. 连接

  1. 打开 Overview。
  2. 选择 Connect。
  3. 等待页面报告服务正在运行,并且连接状态为 Connected。
  4. 首次连接启动期间,不要更改路由模式。

如果 Connect 处于禁用状态,请返回 Account 并确认登录状态,然后返回 Servers 并选择 Refresh Catalogue。

6. 验证局域网设备正在使用该连接

不要把按下按钮本身视为证明。请同时验证路由器状态和路由器下游设备。

在 VilaNet Overview 页面中确认:

  • Backend 显示 Ready。
  • Account 显示 Logged in。
  • Service 显示 Running,Running 详情显示 Yes。
  • Connection 显示 Connected,Connected 详情显示 Yes。
  • Last Error 下没有出现新错误。

然后使用连接到同一路由器局域网的手机或电脑:

  1. 关闭该设备上的移动数据或其他 VPN,确保测试通过路由器连接进行。
  2. 打开新的浏览器窗口。
  3. 确认普通网站可以加载。
  4. 使用信誉良好的 IP 检查服务查看设备的公网 IP。
  5. 与连接前看到的公网 IP 进行比较。公网 IP 发生变化,并且路由器状态为已连接,是最低限度的成功证据。

如果只有路由器页面显示已连接,但局域网流量无法工作,应将连接视为未验证,并按照下方恢复步骤操作。

如果安装或连接失败

安装后没有显示 VilaNet

  1. 返回软件中心,确认是否报告 VilaNet 已安装。
  2. 强制刷新路由器管理页面,或退出后重新登录。
  3. 确认路由器确实使用 Koolshare rogsoft Broadcom HND 固件。
  4. 确认上传的文件名和 SHA-256 与本指南一致。
  5. 如果仍然没有该模块,请停止操作。不要使用通用 Shell 安装程序,也不要禁用平台检查。

登录无法完成

  1. 等待正在进行的登录完成后再重试。
  2. 确认路由器的日期、时间和 NTP 设置正确;时钟严重错误会破坏安全连接。
  3. 重新输入一次账户电子邮件地址和密码。
  4. 如果安装了旧版本,请使用当前的 1.0.18 压缩包升级。自 1.0.10 起的版本已修复速度较慢的路由器上登录请求可能显示为 Failed to fetch 或 ERR_EMPTY_RESPONSE 的问题。

路由器报告已连接,但局域网设备无法浏览网页

  1. 在 Overview 中选择 Disconnect。
  2. 确认局域网设备的普通互联网访问恢复。
  3. 将路由模式保留为原始默认值;不要把切换模式作为首次恢复尝试。
  4. 打开 Diagnostics 并记录可见错误,但不要泄露账户详情、公网 IP、服务器标识符或凭据。
  5. 返回 Servers,刷新目录,然后使用 Auto package 和 Auto server 重试一次。
  6. 如果再次失败,请让 VilaNet 保持断开状态,并向支持团队提供应用版本、路由器型号、固件名称和经过脱敏的错误说明。

安全重置、卸载和恢复

重置 VilaNet 设置

当错误的 VilaNet 设置阻碍正常重试时使用此方法:

  1. 在 Overview 中选择 Disconnect。
  2. 打开 Maintenance。
  3. 选择 Reset VilaNet Data 并确认警告。
  4. 返回 Account 并确认账户状态。
  5. 重复上述自动选择软件包/服务器节点和连接步骤。

重置会停止 VilaNet 服务,并清除 VilaNet 连接和路由设置。它不能代替安装前创建的路由器配置备份。

无需手动删除文件即可卸载

  1. 在 Overview 中选择 Disconnect。
  2. 返回 Koolshare 软件中心。
  3. 找到 VilaNet,然后使用软件中心的卸载操作。
  4. 等待卸载完成后再重启或刷新。
  5. 确认普通局域网互联网访问正常。

正常的软件包卸载旨在移除 VilaNet 程序文件,同时保留其账户和设置,以便日后重新安装。如果准备出售、退回或赠送路由器,请先在 Account 选项卡中使用 Logout,然后使用 Reset VilaNet Data,最后才卸载 VilaNet。转让所有权前,请按照路由器制造商的说明恢复或将路由器重置为出厂设置。

重新安装当前软件包

如果 VilaNet 文件似乎已损坏,但路由器和软件中心仍可正常工作:

  1. 断开连接,并通过软件中心卸载 VilaNet。
  2. 仅在软件中心或路由器固件要求时重启。
  3. 再次验证已保存的 1.0.18 压缩包校验和。
  4. 使用同一个已签名的公开软件包重复离线安装步骤。
  5. 登录,保持 Auto package、Auto server 和初始路由默认值,然后重新连接并重复局域网验证。

如果卸载或恢复影响普通路由器互联网访问,请停止更改,并使用固件自身的恢复流程还原路由器配置备份。

发布仍需补充的证据

本页面文本已准备好接受审核,但证据尚未达到发布要求。在移除实体设备验证提示前,VilaVPN 必须在受支持的 HND 路由器上采集并验证以下内容:

  • 通过软件中心离线上传并成功安装。
  • 已安装模块中显示版本 1.0.18。
  • 使用虚构数据或完全脱敏证据登录账户。
  • 选择 Auto package 和 Auto server。
  • 不更改默认路由模式即可首次连接。
  • 已连接状态,加上真实局域网往返通信/公网 IP 验证。
  • 断开连接、重置、卸载和完全恢复。

这个页面对您有帮助吗?