# 如何在 macOS 上安装和使用 VilaNet？

从 Mac App Store 或官方通用 DMG 安装 VilaNet，使用你的 VilaVPN 账户登录并选择 **自动选择**。App Store 版本使用 TUN 模式并会请求 macOS VPN 批准；DMG 版本默认以代理模式启动，除非切换到 TUN 模式，否则不会请求批准。

VilaNet 2.12.82 下载文件、通用应用标签以及 macOS 12 最低版本要求已经根据当前版本和应用源代码完成检查。发布之前，仍需在干净的 Intel Mac 和 Apple 芯片 Mac 上最终验证安装程序、权限提示和真实 VPN 隧道。

## 开始之前

你需要：

- macOS 12 Monterey 或更高版本；
- 一台 Intel Mac 或 Apple 芯片 Mac；
- 有效的 VilaVPN 账户；以及
- 在 Mac 上安装应用和批准 VPN 更改的权限。

## 1. 下载 VilaNet

选择一个官方来源：

- **Mac App Store：**[从 Apple 获取 VilaNet](https://apps.apple.com/app/vilanet/id6446468411)。这是最简单的安装方式，并支持 App Store 更新。
- **通用 DMG：**[下载适用于 macOS 的 VilaNet 2.12.82](https://github.com/vilavpn/vilanet/releases/download/v2.12.82/VilaNet-for-macOS-2.12.82.dmg)。同一个文件同时支持 Intel Mac 和 Apple 芯片 Mac。

你也可以通过 [VilaVPN 下载页面](https://vilavpn.com/index.php?rp=/download)获取当前下载内容，或在[公开的 VilaNet 2.12.82 发布页面](https://github.com/vilavpn/vilanet/releases/tag/v2.12.82)查看相关文件。

不要安装通过陌生消息或非官方下载网站收到的副本。

## 2. 安装应用

### Mac App Store

1. 在 VilaNet App Store 页面选择 **获取** 或下载按钮。
2. 如果系统要求，请完成 Apple 的确认。
3. 安装完成后，选择 **打开**。

### 通用 DMG

1. 从 **下载** 文件夹打开 `VilaNet-for-macOS-2.12.82.dmg`。
2. 在安装程序窗口中，将 **VilaNet** 拖到 **应用程序**。
3. 推出 VilaNet 磁盘映像。
4. 打开 **应用程序**，然后打开 **VilaNet**。
5. 如果 macOS 询问是否打开从互联网下载的应用，仅当应用名称和下载来源与本指南一致时才确认。

## 3. 登录

1. 打开 VilaNet。
2. 查看链接中的 EULA 和隐私政策。
3. 如果尚未勾选同意复选框，请选择它并查看最少数据使用同意说明。
4. 如果你同意并希望继续，请选择 **允许**。
5. 在 **电子邮箱** 下输入你的 VilaVPN 账户电子邮箱地址。
6. 在 **密码** 下输入你的账户密码。
7. 选择 **登录**。

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

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

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

![VilaNet 自动选择位置，以及紧凑 macOS 窗口中的“连接”控件](/assets/vilanet/vilanet-connect-controls-ja-macos-2.12.52.png)

这是在 macOS 26.3.1 上截取的真实 VilaNet 2.12.52 画面，截图前已将窗口调整为 600 x 700。应用界面语言为日语：`自動選択` 表示 **自动选择**，`接続` 表示 **连接**。文字指南仍以当前 2.12.82 版本为准；截图版本差异已记录在图片登记表中，并获准使用。

1. 打开 **服务器节点**。
2. 除非你需要特定位置，否则选择 **自动选择**，以使用当前最快的可用服务器。
3. 返回主屏幕。
4. 选择 **连接**。
5. 如果你通过 DMG 安装并仍使用其默认的 **代理模式**，系统不会显示 VPN 或系统扩展提示。请继续执行第 8 步。
6. 在 TUN 模式下，查看 macOS 中指明 VilaNet 并要求添加 VPN 配置或启用其 VPN 组件的任何提示，然后批准它。
7. 如果 macOS 打开系统设置，请在与你的版本对应的位置批准 VilaNet 系统扩展：
   - macOS 13 至 15：**系统设置 > 隐私与安全性**；
   - macOS 26 或更高版本：**系统设置 > 通用 > 登录项与扩展**；或
   - macOS 12：**系统偏好设置 > 安全性与隐私 > 通用**。
8. 如有必要，返回 VilaNet 并再次选择 **连接**。
9. 等待 **连接中** 变为 **已连接**。

### 选择代理模式或 TUN 模式

直接下载的 DMG 版本可以使用 **代理模式** 进行 HTTP/SOCKS 代理，也可以使用 **TUN 模式** 建立系统级 VPN 隧道。打开 **设置**，查看 **连接模式**，然后选择你的配置所需的模式。TUN 模式可能会触发上文所述的 macOS 批准流程。

![VilaNet macOS 连接设置，其中包含 TUN 模式和代理模式](/assets/vilanet/vilanet-connection-settings-ja-macos-2.12.52.png)

在这张日语截图中，`TUNモード` 表示 **TUN 模式**，`プロキシモード` 表示 **代理模式**。这是从真实设置屏幕中截取的隐私安全区域；账户、套餐、公网 IP 和本地代理详细信息均不在图片中。

不要批准指向无关应用的系统或管理员提示。

## 5. 确认连接正常工作

1. 保持 VilaNet 打开几秒钟，确认状态仍为 **已连接**。
2. 打开浏览器，访问两个你熟悉的 HTTPS 网站。
3. 返回 VilaNet，确认仍显示 **已连接**。

应用状态与正常的网页流量相结合，比单独使用 IP 检测网站更可靠。完整验证步骤请参阅[确认 VilaVPN 正常工作](/zh-cn/start-here/confirm-vilavpn-is-working/)。

## 如果出现问题

### 应用无法安装或打开

- 确认 Mac 运行的是 macOS 12 或更高版本。
- 删除未完成的安装程序，然后通过上方的官方链接重新下载。
- 对于 DMG，请确认 VilaNet 已复制到 **应用程序** 后再打开。
- 如果 macOS 报告意外的开发者或安全警告，请不要绕过它。保留确切的消息并联系支持团队。

### VPN 权限被拒绝

- 打开第 7 步中列出的系统扩展批准位置，检查是否有待批准的 VilaNet 项目。
- 仅批准 VilaNet 组件，然后返回应用并再次选择 **连接**。
- 如果没有可批准的项目，请在重新安装前保留错误消息。

### 登录或连接失败

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

## 后续步骤

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