如何在 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. 在 电子邮箱 中输入您的 VilaVPN 账户电子邮箱地址。
3. 在 密码 中输入您的账户密码。密码始终显示为圆点，右侧的眼睛图标可切换是否显示。
4. 勾选 我已阅读并同意 复选框；它下方就是 用户许可协议(EULA) 和 隐私协议 链接， 建议先查看。勾选后会立即弹出数据同意对话框 允许发送最少数据以提供 VPN 服务吗?。
5. 查看说明。如果您同意并希望继续，请选择蓝色的 允许。
6. 选择白色的 登录 按钮。

记住我 默认已勾选。

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

登录流程录像与分步截图

登录界面在 Windows、macOS、Linux、Android 和 iOS 上是同一套界面。下面的录像与截图取自 VilaNet v2.14.6（内核 1.13.14-cc9ce62ff）的简体中文界面。

本段的录像与截图取自带有 FIXTURE 标记的官方演示会话：账号 tutorial-user@example.com、节点、延迟、流量和 IP 全部为示例数据，密码在录像中也只显示为圆点，录制过程中不连接任何真实服务器。界面文字与操作步骤与您自己安装的 VilaNet 一致。

登录页长什么样。 顶部是 登录 / 注册 两个标签；中间是 电子邮箱 和 密码 两个输入框； 下面一行是默认已勾选的 记住我 和右侧的 忘记密码?；再往下是 我已阅读并同意 复选框， 以及 用户许可协议(EULA) 和 隐私协议 两个链接；最下方是白色的 登录 按钮，页面底部是 天鹅标志和 诊断 入口。

勾选协议时弹出的数据同意对话框。 标题是 允许发送最少数据以提供 VPN 服务吗?，正文列出会 发送的内容（账号凭据、设备型号和系统版本、仅 VPN 错误、崩溃日志），也明确列出不会记录或发送的 内容（浏览历史、DNS 查询、VPN 连接后的 IP 地址、流量内容）。底部是蓝色的 允许 和红色描边的 不允许；录像中选择的是 允许。

这个对话框由勾选协议复选框触发，不是登录失败。选择 允许 后它会关闭，回到已填好的登录表单， 此时协议复选框已经打勾，可以点击 登录。

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 安装步骤，并允许应用重新启动，然后再连接。

连接流程录像与分步截图

登录之后的连接流程，在 Windows、macOS、Linux、Android 和 iOS 上是同一套界面。下面的录像与截图取自 VilaNet v2.14.6（内核 1.13.14-cc9ce62ff）的简体中文界面。

本段的录像与截图取自带有 FIXTURE 标记的官方演示会话：账号、节点、延迟、流量和 IP 全部为示例数据（例如 IP地址: 203.0.113.1），录制过程中不连接任何真实服务器。界面文字与操作步骤与你自己安装的 VilaNet 一致；连接是否真正建立，请以你自己设备上显示的状态为准。

1. 打开主页。 中间显示当前状态 已断开连接、连接模式按钮 TUN模式 和 IP地址；下方是 PAC模式／全局模式 切换、当前服务器卡片和蓝色的 连接 按钮。

   

2. 点击当前服务器卡片（示例中是 Demo Tokyo，第二行显示延迟 Tcp: 32 ms），进入 服务器节点 页。 页面顶部是当前套餐（示例中为 Vila Demo）和 切换套餐。

3. 展开你要用的分组。 自动选择 (3) 默认展开，包含 最快 以及按国家的自动选择项；按协议分的分组 （例如 AnyTLS (2)）默认是收起的，点击分组标题即可展开。展开后节点按国家分小标题排列， 每个节点显示名称和延迟。

   

4. 点选一个节点（示例中是 Demo Singapore，Tcp: 45 ms）。点选后页面会自动退回主页，无需手动返回。

5. 回到主页确认选择。 服务器卡片已经变成 Demo Singapore，但状态仍然是 已断开连接—— 选择节点不等于已连接。

   

6. 点击「连接」。 状态先变成橙色的 连接中，随后变成蓝色的 已连接；同时顶部图标变蓝， 按钮变成红色的「断开」。

   

7. 断开连接。 点击红色的 断开，经过橙色的 断开连接中，状态回到 已断开连接， 按钮变回蓝色的 连接。

如何确认真的连上了

只看主页中间的状态区，它有三个同时变化的信号：

⚠️ 不要用服务器卡片的颜色来判断是否已连接。 当前选中的服务器卡片一直是蓝色高亮的——未连接时也是蓝色。上面「已断开连接」和「已连接」 两张截图就是同一张 Demo Singapore 蓝色卡片的对照：卡片完全一样，变的只有状态文字、图标颜色和按钮。

另外，服务器节点列表里没有「已连接」标记。列表中的蓝色高亮同样只表示「当前选中」， 节点第二行显示的是延迟（例如 Tcp: 45 ms），不是连接状态。要确认连接状态，请回到主页。

两个过渡状态（橙色的 连接中 与 断开连接中）都只有一秒左右，来不及看清属于正常。

在服务器节点页看不到节点，是因为按协议分的分组默认收起，点击分组标题展开即可，这不是故障。 选完节点不会自动连接——回到主页后仍需点击 连接。

窄窗口布局

VilaNet 会根据窗口宽度自动切换布局：宽窗口是左侧常驻侧边栏（主页、服务器、设置、账单、支持工单、公告、检查更新）， 把窗口拉窄后改为左上角的 ☰ 抽屉菜单，菜单项相同，操作步骤完全一致。手机端始终是窄布局。 退出登录 在宽布局的左侧栏底部、窄布局的 ☰ 抽屉底部；点击后会弹出确认框 提示 / 您确定要退出吗?， 选择 确定 即退出到登录页。

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 断开连接时，普通互联网访问正常。
• 尝试一次自动选择。
• 在更改高级设置或重新安装之前，请记录准确的错误并保留诊断信息。
• 继续查看无法登录或无法连接。

下一步

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