如何在 Linux 上安装并使用 VilaNet？

下载适合您计算机的 AppImage，赋予其可执行权限并登录，然后使用 VilaNet 的一次性为 TUN 模式安装流程，启用完整的系统级 VPN 连接。

VilaNet 2.12.82 软件包、各平台通用的应用标签、架构要求和 AppImage TUN 安装流程，均已根据当前版本和应用源代码完成核对。在发布之前，仍需在干净的 AMD64 和 ARM64 Ubuntu 系统上对桌面提示和真实 VPN 隧道进行最终验证。

开始之前

VilaNet 当前的官方 Linux 版本支持：

• AMD64 / x86_64： Ubuntu 22.04 LTS 或更高版本；以及
• ARM64 / aarch64： Ubuntu 24.04 LTS 或更高版本。

您还需要有效的 VilaVPN 账户，以及执行一次性 TUN 设置所需的管理员权限。

要检查您的架构，请打开终端并运行：

uname -m

• x86_64 表示应下载 AMD64 版本。
• aarch64 或 arm64 表示应下载 ARM64 版本。

1. 下载 AppImage

建议优先使用 AppImage 软件包，因为它不需要传统的软件包安装过程。

• AMD64： 下载适用于 AMD64 的 VilaNet 2.12.82 AppImage
• ARM64： 下载适用于 ARM64 的 VilaNet 2.12.82 AppImage

您也可以通过 VilaVPN 下载页面获取这两个软件包，或在公共 VilaNet 2.12.82 发布页面上进行核对。

请勿运行通过未经请求的消息收到或从非官方下载网站获取的副本。

2. 启动 VilaNet

1. 打开终端。

2. 切换到您的下载目录：

   cd ~/Downloads
   

3. 为下载的 AppImage 添加可执行权限。使用与您的计算机匹配的命令：

   chmod +x VilaNet-for-Linux-AMD64-2.12.82.AppImage
   

   或：

   chmod +x VilaNet-for-Linux-ARM64-2.12.82.AppImage
   

4. 使用匹配的命令启动 VilaNet：

   ./VilaNet-for-Linux-AMD64-2.12.82.AppImage
   

   或：

   ./VilaNet-for-Linux-ARM64-2.12.82.AppImage
   

AppImage 最初可以使用代理模式。如果希望 VilaNet 通过系统级 VPN 接口路由设备的全部流量，请完成下面的一次性 TUN 设置。

3. 登录

1. 打开 VilaNet。
2. 查看链接中的最终用户许可协议和隐私政策。
3. 如果同意复选框尚未选中，请将其选中并查看最少数据收集同意说明。
4. 如果您同意并希望继续，请选择允许。
5. 在电子邮件下输入您的 VilaVPN 账户电子邮件地址。
6. 在密码下输入您的账户密码。
7. 选择登录。

VilaNet 应会打开主屏幕。套餐过期或未激活时，必须先续订才能连接。

4. 安装 TUN 支持

AppImage 从只读的挂载镜像运行，因此 VilaNet 会先将其运行时复制到 ~/.local/share/VilaNet 下的可写目录。然后，它会请求管理员权限，为安装后的运行时授予所需的 Linux 网络能力，并从安装后的副本重新启动。

1. 在 VilaNet 中打开设置。
2. 打开 Linux 设置。
3. 阅读正从 AppImage 运行信息面板，然后选择为 TUN 模式安装。如果本地运行时尚未准备就绪，在连接模式下选择 TUN 模式也会开始相同的安装过程。
4. Ubuntu 请求管理员身份验证时，请确认该请求属于 VilaNet 的 TUN 安装，然后输入您的系统密码。
5. 等待 VilaNet 安装本地运行时并重新启动。在此步骤中，请勿关闭密码提示或启动第二个应用副本。
6. 重新启动后，确认已选择 TUN 模式。安装后的 VilaNet 条目也会添加到您的桌面应用菜单中。

这与您的 VilaVPN 密码不同：管理员提示要求输入 Linux 用户账户的密码。

5. 选择服务器并连接

连接控件与其他 VilaNet 应用相同。

1. 打开服务器节点。
2. 选择自动选择以使用速度最快的可用服务器，除非您需要特定位置。
3. 返回主屏幕。
4. 选择连接。
5. 等待连接中变为已连接。

如果 VilaNet 此时请求管理员权限，请先完成上述 TUN 安装步骤，并允许应用重新启动，然后再连接。

6. 确认连接正常

1. 让 VilaNet 保持打开几秒钟，确认状态仍为已连接。
2. 打开浏览器并加载两个您熟悉的 HTTPS 网站。
3. 返回 VilaNet，确认它仍显示已连接。

同时确认应用状态和网页流量正常，比只使用 IP 检测网站更可靠。完整验证步骤请参阅确认 VilaVPN 正常工作。

如果出现问题

AppImage 无法启动

• 确认下载的版本与 uname -m 显示的架构相符。
• 从终端运行 AppImage，以便保留准确的错误信息。
• 使用 chmod +x 确认已设置可执行位。
• 确认系统符合上述 Ubuntu 版本要求。
• 如果文件不完整，请从官方链接重新下载。

管理员提示未出现

VilaNet 使用图形密码辅助程序执行一次性 TUN 提权。在 Ubuntu 上安装首选辅助程序，然后再次尝试为 TUN 模式安装：

sudo apt update
sudo apt install zenity

如果提权被取消或失败，VilaNet 将无法完成 TUN 设置。您可以暂时继续使用代理模式，或保留错误信息并联系支持团队。

重新启动后 TUN 模式无法工作

• 打开设置 > Linux 设置，确认已选择 TUN 模式。
• 从桌面应用菜单启动 VilaNet，以使用安装后的可写运行时，而不是再次启动原始 AppImage。
• 记录任何提到 CAP_NET_ADMIN、提权、DNS 或 TUN 设备的消息。
• 不要反复使用 sudo 运行整个应用；请保留诊断信息并联系支持团队。

登录或连接失败

• 确认电子邮件地址中没有多余空格，并且订阅仍然有效。
• 确认 VilaNet 断开连接时，普通互联网访问正常。
• 尝试一次自动选择。
• 在更改高级设置或重新安装之前，请记录准确的错误并保留诊断信息。
• 继续查看无法登录或无法连接。

下一步

了解如何选择特定服务器，或在日常使用中保持启用自动选择。