# 如何在 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 设置所需的管理员权限。

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

```bash
uname -m
```

- `x86_64` 表示应下载 **AMD64** 版本。
- `aarch64` 或 `arm64` 表示应下载 **ARM64** 版本。

## 1. 下载 AppImage

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

- **AMD64：** [下载适用于 AMD64 的 VilaNet 2.12.82 AppImage](https://github.com/vilavpn/vilanet/releases/download/v2.12.82/VilaNet-for-Linux-AMD64-2.12.82.AppImage)
- **ARM64：** [下载适用于 ARM64 的 VilaNet 2.12.82 AppImage](https://github.com/vilavpn/vilanet/releases/download/v2.12.82/VilaNet-for-Linux-ARM64-2.12.82.AppImage)

您也可以通过 [VilaVPN 下载页面](https://vilavpn.com/index.php?rp=/download)获取这两个软件包，或在[公共 VilaNet 2.12.82 发布页面](https://github.com/vilavpn/vilanet/releases/tag/v2.12.82)上进行核对。

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

## 2. 启动 VilaNet

1. 打开终端。
2. 切换到您的下载目录：

   ```bash
   cd ~/Downloads
   ```

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

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

   或：

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

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

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

   或：

   ```bash
   ./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 正常工作](/zh-cn/start-here/confirm-vilavpn-is-working/)。

## 如果出现问题

### AppImage 无法启动

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

### 管理员提示未出现

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

```bash
sudo apt update
sudo apt install zenity
```

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

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

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

### 登录或连接失败

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

## 下一步

了解[如何选择特定服务器](/zh-cn/common-tasks/choose-a-server/)，或在日常使用中保持启用**自动选择**。