如何在 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。这是最简单的安装方式，并支持 App Store 更新。
• 通用 DMG：下载适用于 macOS 的 VilaNet 2.12.82。同一个文件同时支持 Intel Mac 和 Apple 芯片 Mac。

你也可以通过 VilaVPN 下载页面获取当前下载内容，或在公开的 VilaNet 2.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. 在 电子邮箱 中输入你的 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. 选择服务器并连接

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

这是在 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. 等待 连接中 变为 已连接。

第 6 步中 macOS 的 VPN 批准提示大致是下面这个样子：

示意图：实际提示文字可能因系统版本而异。 这张图是手绘示意图，不是截图，仅用于说明会出现哪一类提示。请只批准名称为 VilaNet 的提示。

第 7 步的系统扩展批准出现在系统设置中，不是这个对话框；本指南暂不提供该步骤的示意图。

选择代理模式或 TUN 模式

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

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

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

连接流程录像与分步截图

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

5. 确认连接正常工作

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

应用状态与正常的网页流量相结合，比单独使用 IP 检测网站更可靠。完整验证步骤请参阅确认 VilaVPN 正常工作。

如果出现问题

应用无法安装或打开

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

VPN 权限被拒绝

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

登录或连接失败

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

后续步骤

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