# 如何在 Apple TV 上安装并连接 VilaNet？

从 Apple TV 的 App Store 安装官方 VilaNet 应用，使用你的 VilaVPN 账户登录，选择服务器，并在首次连接时批准 Apple 的 VPN 权限请求。

Apple TV 版 VilaNet 是一款原生 tvOS 应用，包含 **首页**、**服务器** 和 **设置** 部分。这些说明适用于 tvOS 17 或更高版本上的 1.2.8 版（build 2）。发布本页面之前，仍需在实体 Apple TV 上验证商店中的可见性、Siri Remote 焦点顺序以及最终 VPN 连接。

## 开始之前

你需要：

- 一台运行 tvOS 17 或更高版本的 Apple TV；
- 互联网连接；
- 有效的 VilaVPN 订阅；以及
- 你的 VilaVPN 账户电子邮箱地址和密码。

切勿在非官方应用或由意外消息打开的网站中输入 VilaVPN 密码。

## 1. 下载 VilaNet

1. 从 Apple TV 主屏幕打开 **App Store**。
2. 选择 **搜索**，然后搜索 `VilaNet`。
3. 打开 VilaNet 官方列表，确认其名称和品牌与 VilaVPN 一致。
4. 选择 **获取** 或下载图标。
5. 等待安装完成，然后选择 **打开**。

Apple TV App Store 是标准安装来源。如果找不到 VilaNet，请先前往 **设置 > 系统 > 软件更新** 更新 tvOS，然后再次搜索。不要旁加载来源不明的副本。

## 2. 登录

登录屏幕打开时，初始焦点应位于电子邮箱字段。使用 Siri Remote 移动焦点并选择控件。

1. 在 **电子邮箱** 中输入你的 VilaVPN 账户电子邮箱地址。
2. 在 **密码** 中输入你的账户密码。
3. 查看链接中的 EULA 和隐私政策。
4. 如果尚未勾选协议复选框，请选择它。
5. 选择 **登录**。

### 登录成功检查

应用会打开主界面，并且你可以在 **首页**、**服务器** 和 **设置** 之间移动。如果 VilaNet 提示套餐已过期或未激活，请先续订，再尝试连接。

## 3. 选择服务器并连接

1. 打开 **服务器**。
2. 使用 Siri Remote 在服务器列表中移动。
3. 选择你想使用的服务器。
4. VilaNet 会返回连接流程，并自动开始连接所选服务器。
5. 首次连接时，tvOS 会显示添加 VPN 配置的系统请求。查看请求并选择 **允许**。
6. 等待 **首页** 显示已连接状态。

选择服务器即会启动连接；无需在 VilaNet 中粘贴订阅 URL。

## 确认连接成功

首次连接成功时会出现以下所有迹象：

- **首页** 显示 VilaNet 已连接；
- 应用中显示所选服务器；以及
- Apple TV 可以继续通过网络加载内容。

不要将模拟器截图视为 VPN 隧道正常工作的证明。最终的已连接截图和这项成功检查必须在实体硬件上完成验证。

## 断开连接或更改服务器

- 要断开连接，请返回 **首页** 并选择连接控件。
- 要更改服务器，请打开 **服务器** 并选择另一个服务器。VilaNet 会开始连接新选择的服务器。
- 使用 **设置** 查看应用提供的偏好设置和支持信息。

## 如果无法安装、登录或连接

- **搜索中找不到应用：**确认 tvOS 为 17 或更高版本，并且 Apple ID 的 App Store 地区可以访问 VilaNet。
- **遥控器焦点似乎卡住：**按一次 **菜单/返回**，返回该屏幕并再次移动焦点。不要反复提交登录表单。
- **登录失败：**重新输入完整的电子邮箱地址和密码，确认订阅有效，并保留确切的错误消息。
- **VPN 权限被拒绝：**重新连接并批准 tvOS 系统 VPN 请求。没有此权限，VilaNet 无法建立隧道。
- **可以连接但内容无法加载：**断开连接，选择另一个服务器并重新连接。然后继续查看[已连接但无法上网](/zh-cn/troubleshooting/connected-but-no-internet/)。
- **仍然无法连接：**继续查看[无法连接](/zh-cn/troubleshooting/cannot-connect/)。

联系支持团队时，请提供 Apple TV 型号、tvOS 版本、VilaNet 版本以及确切的错误文本。切勿发送你的密码。
