这份 macOS 新手完整指南按实际操作顺序说明：安装客户端、授予系统权限、导入订阅，再验证流量是否经过选定线路。Mac 上的“已连接”只是客户端状态，不等于所有应用都已接入。首次配置应先让浏览器正常访问，再处理分流和其他应用。
安装前：确认客户端来源与芯片类型
先打开苹果菜单中的“关于本机”，查看 Mac 使用 Apple 芯片还是 Intel 处理器。下载页面若分别提供不同架构的安装文件，应选择匹配版本；通用版本则按页面说明使用。不要仅凭文件名中有“Mac”就判断兼容，也要确认客户端要求的 macOS 版本。
VPN54 的 macOS 客户端可在用户面板的客户端入口获取，登录后查看当前下载说明。安装文件、订阅链接和套餐是不同内容：安装文件用于运行程序，订阅用于加载线路配置，套餐决定可使用的服务资源。不要把订阅链接当作安装包下载地址。
- 从用户面板进入下载说明，核对适用系统与架构。
- 若下载的是磁盘映像，打开后按提示将应用拖入“应用程序”；若是安装器，则按其步骤完成安装。
- 从“应用程序”启动客户端，避免长期从挂载的安装映像运行。
- 首次打开时核对应用名称与系统提示，再按客户端说明继续。
系统权限：区分代理、网络扩展与辅助服务
不同客户端的接入方式不同，出现的权限请求也不同。有的主要修改系统代理，有的使用网络扩展，有的通过特权辅助服务建立虚拟网卡。并不是每款客户端都必须依次获得这些权限；应以实际启用的功能为准，不能照着其他软件的截图机械操作。
| 接入方式 | 主要作用 | 需要注意 |
|---|---|---|
| 系统代理 | 让遵循系统代理设置的应用通过本地代理转发请求 | 部分应用不读取系统代理，不能据此判断整机流量都已接入 |
| 网络扩展 | 通过 macOS 提供的网络扩展机制接入网络处理 | 可能要求允许扩展或添加 VPN 配置，授权后仍需检查客户端状态 |
| 虚拟网卡模式 | 将符合路由条件的流量交给客户端处理 | 可能依赖网络扩展或辅助服务，并不等于自动代理所有目标 |
请求添加 VPN 配置时，先确认提示来自刚安装的客户端，再决定是否允许。网络扩展的管理位置会随 macOS 版本变化，可在“系统设置”中搜索“扩展”或“VPN”；部分版本也会在“隐私与安全性”中显示待处理提示。不要只按旧教程里的固定路径寻找按钮。
若客户端明确要求安装辅助服务，系统可能要求管理员授权。这是本机授权，不是服务账户登录。普通代理接入通常不需要屏幕录制、辅助功能或完全磁盘访问权限；遇到这类请求，应先阅读具体功能说明。设备若由学校或单位管理，相关设置可能受管理策略限制，不应尝试绕过。
导入订阅：从链接加载线路配置
订阅链接通常指向一份可更新的客户端配置，其中可能包含线路、认证信息和规则。它不是用来在浏览器里长期打开的普通网页。复制后，应粘贴到客户端的“添加订阅”“从链接导入”或含义相同的入口，而不是手动填入某条节点的服务器地址栏。
- 登录 VPN54 用户面板，按页面说明找到适用于当前客户端的订阅入口。
- 复制完整链接，避免遗漏末尾字符，或混入空格、换行和说明文字。
- 在客户端新增订阅，填写便于识别的本地名称，保存并执行更新。
- 确认线路列表已经加载，然后选择可用线路或相应策略组。
- 启用系统代理或客户端要求的接入模式，再进行访问验证。
导入成功不代表所有配置都能被当前客户端识别。Shadowsocks、VMess、Trojan、VLESS、Hysteria2 与 TUIC 是不同协议，客户端支持范围和配置格式并不相同。本文不代表当前订阅必然包含这些协议。若提示不支持协议或字段，应核对下载说明与订阅格式，不要随意删除认证参数来消除报错。
首次连接：先用规则模式，再验证实际路径
客户端里的“系统代理”和“规则模式”不是同一个开关。前者决定应用请求怎样进入客户端，后者决定进入后选择代理还是直连。规则模式通常按域名、地址或其他条件分流；全局代理模式则通常把进入客户端的请求交给指定代理，但仍不能保证未进入客户端的应用流量也被处理。
首次使用优先采用服务提供的规则配置，保持 DNS 与规则配套，不急着叠加自定义规则。先打开常用国内站点，再访问需要通过国际线路连接的目标站点。若出现异常，查看客户端连接记录，确认请求是否进入客户端，以及命中了直连规则还是代理策略。
- ✅ 在IP 查询页比较接入前后的出口信息，核对是否符合当前策略。
- ✅ 同时查看客户端连接记录，确认目标请求命中的线路；单个查询网页不能证明所有应用都使用同一路径。
- ✅ 分别检查浏览器与实际工作应用。浏览器成功，而其他应用失败时，先检查后者是否遵循系统代理。
- ✅ 断开连接后再检查常用网站，确认客户端能正确恢复系统代理与网络状态。
若某个应用不遵循系统代理，可先查看应用自己的代理选项；确有整机接入需求时，再按客户端文档配置虚拟网卡模式。不要同时运行多个修改系统代理或路由的工具，否则很难判断是哪套规则在生效。
DNS 与线路：排查连接之外的问题
DNS 将域名转换为网络地址。代理已连接，并不自动说明 DNS 查询也走了预期路径。客户端可能使用本地解析、远程解析或映射式解析；浏览器还可能启用自己的加密 DNS。几套设置混用时，容易出现解析结果与分流目标不一致的情况。
检查 DNS 时，应结合客户端 DNS 日志、规则设置和可信的检测工具判断。检测页面显示的解析服务地区不一定就是物理出口位置；结果也不能单独证明隐私泄漏。更有意义的问题是：本应交给指定解析器的查询，是否意外发给了本地网络的解析器。排查时先恢复客户端建议配置，再逐项调整浏览器或系统中的自定义 DNS。
线路类型与权限问题也要分开。IEPL 专线描述的是线路传输组织方式，中转通常通过中间入口转发，直连通常由本地网络直接连接目标服务节点；这些标签本身不保证某个站点始终可用，也不等于端到端的全部路径都一样。客户端无法启动或订阅无法解析时，换专线并不能解决本机配置错误。
连接已建立但目标站点表现不稳定时，可在当前订阅内切换线路，观察同一目标是否恢复，再结合连接记录定位。节点列表可参阅线路页面，具体可选项目以客户端为准。不要把一次访问结果推导为长期速度或流媒体可用性承诺。
常见故障：按现象缩小排查范围
找不到允许扩展的按钮
先确认当前客户端是否真的使用网络扩展，以及是否已触发安装流程。没有对应请求时，系统不会凭空出现允许按钮。退出后重新打开客户端，按说明再次启用相关模式，再到系统设置中检查。若设备受组织管理，应联系管理员确认策略，而不是反复重装。
订阅更新失败，线路列表为空
确认基础网络能访问用户面板，再检查链接是否完整、是否选择了匹配客户端的格式，以及面板中的套餐状态。若日志显示证书或时间相关错误，应检查系统日期与时间。不要通过关闭证书校验绕过问题，也不要把完整订阅链接粘贴进求助截图。
客户端显示连接，但浏览器打不开网页
依次检查系统代理是否启用、是否选中了线路、规则是否将目标交给预期策略，以及日志是否出现解析失败。若所有网站都异常，先关闭其他网络工具，再重新连接。若只有某个站点异常，重点看该目标的规则、解析与线路结果，不要直接重置整台 Mac 的网络设置。
退出客户端后无法正常联网
可能是系统仍保留指向本地客户端的代理设置，而对应程序已经退出。可先重新打开客户端，正常关闭接入功能，再退出。仍未恢复时，在当前网络服务的代理设置中核对遗留项目；如有手动配置或单位网络要求，先记录原值，只处理能确认由本次安装产生的设置。
配置结论：先确认安装来源与架构，再完成客户端实际需要的授权，随后导入匹配格式的订阅。用出口查询和连接记录交叉验证，最后才调整分流、虚拟网卡与 DNS。按这个顺序处理，能把安装、权限、配置和线路问题分开，避免在多个设置之间反复试错。
仍无法定位时，可通过用户面板工单提交 macOS 版本、客户端名称、报错文本与已经尝试的操作。日志和截图应先移除账户凭据、订阅链接及其他个人内容。更多通用说明可查看帮助中心。