确认 Mac 芯片类型
macOS 客户端已适配 Apple Silicon 与 Intel 两种芯片架构。虽然从 v3.0 开始客户端已提供通用二进制（Universal Binary），同一安装包可同时运行在两种芯片上，但了解自己的芯片类型仍然有助于判断安装后的运行表现。
查看方法：点击屏幕左上角的苹果图标 → 选择「关于本机」，在弹出的窗口中找到「芯片」或「处理器」一栏：
| 芯片栏显示 | 芯片类型 | 客户端版本 |
|---|---|---|
| Apple M1 / M2 / M3 / M4 | Apple Silicon | 原生运行，性能更优 |
| Intel Core i5 / i7 / i9 | Intel | 原生运行，兼容性良好 |
两种芯片使用同一个 .dmg 安装包，无需分别下载。
下载 macOS 客户端
访问官网 下载中心 的 macOS 区块，点击「下载 macOS 客户端」按钮，等待 .dmg 安装包下载完成。当前版本 v3.4.0，文件大小约 92 MB。
下载完成后，建议核对文件大小与页面标注是否一致。如偏差超过 5%，说明文件可能未完整下载，建议删除后重新获取。
打开 DMG 安装包
在「下载」文件夹或浏览器下载列表中双击 .dmg 文件。macOS 会挂载该磁盘映像，并在 Finder 中弹出一个新窗口。
窗口内通常包含两个图标：
- 绿茶 VPN 应用图标：客户端主体。
- Applications 文件夹快捷方式：指向系统的应用程序目录。
如果双击 .dmg 后弹出「无法打开，因为它来自身份不明的开发者」提示，说明 macOS 的安全策略阻止了未知来源的文件。此时可以在「系统设置」→「隐私与安全性」→「安全性」中找到被阻止的提示，点击「仍要打开」，然后输入管理员密码确认。该操作仅需执行一次。
将客户端拖入 Applications
在 DMG 窗口中，将绿茶 VPN 图标拖到 Applications 文件夹上，然后松开鼠标。macOS 会自动完成拷贝，进度通常为 1-2 秒。
拷贝完成后，可以右键点击 DMG 挂载的磁盘图标，选择「推出」，将安装包卸载。
接下来从「启动台」或「应用程序」文件夹中找到绿茶 VPN，双击启动。
允许网络扩展
首次启动绿茶 VPN 时，macOS 会弹出提示请求安装网络扩展。这是建立 VPN 隧道所必需的权限，处理步骤如下：
- 在首次启动的提示中点击「打开系统设置」。
- 在「系统设置」中依次进入：通用 → 登录项与扩展 → 网络扩展。
- 在列表中找到绿茶 VPN，将右侧的开关打开。
- 部分系统版本会弹出「允许来自开发者的系统扩展」提示，需再次点击「允许」并输入管理员密码。
授权完成后，完全退出客户端（⌘ + Q），再重新启动一次，网络扩展即可生效。
首次打开并连接 VPN
网络扩展授权完成后，重新启动客户端，使用邮箱或手机号登录账号。登录成功后，在节点列表中选择一个延迟在 100ms 以内的节点，点击首页的连接按钮。
绿茶 VPN 使用自研网络协议与 AES-256-GCM 加密算法。根据我们的实测，macOS 端首次连接平均耗时 3-5 秒，后续连接通常 1-2 秒内完成。连接成功后，菜单栏会出现绿茶 VPN 图标，客户端的连接状态面板会显示当前节点、连接时长与实时延迟。
如何确认安装成功？
可以从以下三个方面确认安装与连接状态：
方法一：检查菜单栏图标
连接成功后，macOS 顶部菜单栏右侧会出现绿茶 VPN 图标。点击图标可快速查看当前连接状态、切换节点或断开连接。
方法二：查看客户端状态面板
打开客户端主界面，首页会以绿色状态标识显示「已连接」，并显示当前节点名称、所属地区与本次会话连接时长。
方法三：访问常用网站
打开 Safari 或 Chrome 访问常用网站，如能正常加载且响应流畅，说明 VPN 已生效。若网站加载异常，可切换节点重试。
macOS 安装常见问题
双击 DMG 时提示「来自身份不明的开发者」怎么办？
这是 macOS Gatekeeper 的默认保护机制。打开「系统设置」→「隐私与安全性」，在「安全性」一栏找到被阻止的提示，点击「仍要打开」并输入管理员密码。该操作只需执行一次，之后同一应用的启动不会再被拦截。
系统设置中找不到绿茶 VPN 的网络扩展怎么办？
首先确认客户端已至少启动过一次，且系统版本为 macOS 10.15 及以上。如果在「登录项与扩展」中看不到绿茶 VPN 条目，可尝试：完全退出客户端 → 重新启动 → 再次查看。如仍看不到，可卸载客户端后重新安装一次，触发新的授权请求。
网络扩展已授权，但仍然无法连接怎么办？
授权完成后需要完全退出客户端（⌘ + Q）并重新启动，网络扩展才会生效。如果重启后仍无法连接，可在系统设置中移除绿茶 VPN 的网络扩展条目，然后重新授权。详细排查步骤可查看 VPN 连接失败排查方法。
Apple Silicon 与 Intel 芯片需要下载不同版本吗？
不需要。从 v3.0 开始，绿茶 VPN macOS 客户端使用通用二进制（Universal Binary），同一个 .dmg 安装包可同时运行在 Apple Silicon 与 Intel 芯片上。系统会自动选择对应的架构运行，无需手动选择版本。
如何卸载 macOS 客户端？
打开「访达」→「应用程序」，找到绿茶 VPN，将其拖入废纸篓。在弹出的提示中输入管理员密码完成卸载。卸载后，如需彻底清除用户配置文件，可在「访达」中按 ⌘ + Shift + G，输入 ~/Library/Application Support/lvcha-vpn，将对应目录移入废纸篓。最后建议重启电脑以完成网络扩展的清理。
结论
macOS 客户端的安装流程可以概括为四步：确认芯片类型 → 下载并拖入 Applications → 授权网络扩展 → 登录并连接。安装过程中最常见的卡点是网络扩展授权，完成授权后需完全退出并重启客户端才能生效。如果后续使用中遇到连接问题，可查阅 VPN 连接失败排查方法 或前往 帮助中心 查找对应教程。