先确认芯片，不要只看电脑外观
打开苹果菜单中的“关于本机”，查看芯片或处理器。Apple M 系列选 Apple 芯片安装包，Intel 处理器选 Intel 安装包。相似外观的 Mac 也可能采用不同架构，不按外观或购买年份判断。
项目安装文档当前支持 macOS 12 及以上，下载时核对最新发布说明。旧系统先确认能否升级或咨询管理员，不建议新手直接手动替换内核。先排除系统兼容问题，再检查订阅。
通过正式发布页完成安装
从官方安装文档进入 GitHub 发布页，下载对应 macOS 架构的包，按磁盘映像提示放入“应用程序”目录。更新前从菜单栏或应用菜单完全退出旧程序；只关闭窗口可能仍在后台运行。
首次启动出现系统提示时，核对来源、文件完整性和错误内容。不要用全局关闭系统安全机制的命令处理。需要重下时回到项目发布页，确认系统与架构，再按系统提供的单个应用处理方式操作。
- 记录“关于本机”中显示的芯片与 macOS 版本。
- 从项目正式发布页下载对应安装包。
- 退出旧客户端，按安装提示放入应用程序目录。
- 从应用程序目录启动，确认订阅与设置页面能够正常打开。
先完成系统代理下的首次连接
在账户页复制兼容 Clash 或 Mihomo 的订阅，导入并启用。到代理页面选择节点，使用规则模式和系统代理测试浏览器。账户登录页地址不是订阅地址。
刷新目标网页并查看连接页面，核对域名、规则与出口。若使用浏览器代理扩展，检查它是否与系统代理冲突。通过连接记录与网页结果确认是否生效，不只看开关。
- 出现配置卡片后，还要确认它已成为当前配置。
- 节点有延迟数字后，还要验证实际目标网页。
- 浏览器成功后，再测试平时使用的具体应用。
- 每轮测试保留相同目标与节点，减少比较中的变量。
系统代理或服务授权失败时，先保留提示
系统代理未实际生效或服务授权失败时，记录版本、操作时间与完整报错。在当前 macOS 网络服务中核对代理状态，不删除公司代理或管理策略；受管理设备请管理员确认。
菜单栏仍有客户端时，后台可能尚未退出。先只运行一个客户端，开关一次并复测，再决定是否调整登录项或服务。避免同时启动多份应用或另一款网络工具。
打开 TUN 前，记录原有网络设置
TUN 涉及虚拟接口、路由与 DNS。官方 macOS FAQ 说明，开启时可能调整系统 DNS。先记录当前网络服务是自动获取还是手动 DNS，必要时保存设置截图。不用一个固定 DNS 地址判断所有版本。
关闭 TUN 或退出后域名无法解析时，核对 DNS 是否恢复，并检查最新发布说明中的修复。按开启前的记录恢复；企业内网可能依赖专用 DNS，不随意改成公共地址。保留开启前、开启后、关闭后三个状态。
常见问题
Apple M 芯片应该下载哪个版本？
选择发布页中 Apple 芯片对应的 macOS 安装包。Intel 版本面向 Intel Mac，先用“关于本机”确认，再下载。
窗口关掉了，为什么菜单栏还在？
关闭窗口可能只是隐藏界面，程序仍在后台运行。安装更新或确认完全退出时，应使用应用或菜单栏中的退出操作。
TUN 关闭后网页打不开，是否只能重装？
先核对当前网络服务的代理与 DNS 是否恢复，再检查版本已知问题和日志。根据先前记录恢复原设置，通常比盲目重装更能定位原因。
参考资料
资料核对：2026-10-09。