macOS 客户端入门：安装、导入与连接检查

我该用哪个客户端？

先看机场在用户面板里给了你什么，不用先弄懂协议。

按机场给的东西选

机场客户端和通用客户端差在哪

两类客户端最大的差别，是换机场时要不要换软件。

• 不要用同名客户端搜索结果、群文件或别人转发的安装包都不可靠。有的机场官方就用网盘分发，例如瞬云的蓝奏云链接，也要从用户面板进入下载。
• 想改用通用客户端先问客服是否提供订阅链接、是什么格式，再决定。

收录机场在 Mac 上怎么用

多家机场给自己的 macOS 客户端，登录即用；能不能换成 Clash 等通用客户端，要看面板有没有给订阅。

• 登录即用，没有订阅链接二猫云的 macOS 客户端是 zip 压缩包，帮助中心写明登录账号即可使用，不需要导入订阅。
• zip 客户端，用账号密码登录闪电鼠、神行加速、云界线、大佬云的帮助中心写明用官网账号密码登录。官方没有公开第三方订阅格式，需要用 Clash 等客户端的，购买前先问客服。
• 暂不支持第三方客户端灵猫网络的客户端是 zip 压缩包，标注支持 macOS 10.15 及以上。官方公告写明暂时关闭了原有订阅链接，近期不支持 Clash 等第三方客户端。
• 官方客户端加一键导入瞬云的客户端下载链接（蓝奏云网盘）在用户面板里，面板也设有 Clash Verge、FlClash、sing-box、Hiddify 等一键导入按钮。速网云的 2.4.2 版客户端分 Intel 芯片和 Apple 芯片两个 zip 包，面板另有 Clash（Mihomo）与 sing-box 一键导入，也可以用下文的通用客户端。
• 没有自有客户端鲲鹏加速只提供订阅，面板在 macOS 一栏开启了 FlClash、Clash Verge、sing-box、Hiddify 等客户端的一键导入。

macOS 上的通用客户端怎么选？

Clash 订阅首选 Clash Verge Rev，通用订阅首选 v2rayN，sing-box 订阅用 SFM。

六款常用客户端对比

六款客户端各自适合谁

• Clash Verge Rev机场给 Clash 订阅时的首选，官方文档写明只通过 GitHub Release 发布。
• ClashX Meta由 MetaCubeX 维护，通过菜单栏图标操作，适合用惯原版 ClashX 的人。仓库首页还是原 ClashX 的旧说明（仍在介绍 ClashX Pro 等），当前功能以发行页和界面为准。
• FlClash与 Android 版出自同一个项目，手机上用过它的人容易上手。0.9.0 起更新日志写有“分享链接导入”，但官方没有说明能否把 Base64 订阅当作可自动更新的订阅使用，有 Clash 订阅时优先用 Clash 订阅。
• Clash Party就是旧教程里的 Mihomo Party，2025 年 8 月的 1.8.6 版起改用现名。表中只有它的官方说明覆盖 macOS 10.15 和 11，旧系统可以考虑它。
• v2rayN机场只给通用订阅时的首选。它是图形界面，不是核心本身；官方写明 macOS 的 dmg 安装包没有签名，安装后要多做一步，见首次打开被拦截。
• SFMsing-box 官方的 macOS 客户端。自 1.14.0 起不再上架 Mac App Store，改为独立版发布；App Store 上的 sing-box MT 是 iPhone、iPad 和 Apple TV 版本。

其他仍在维护的客户端

下面三款都支持 Intel 和 Apple 芯片，有特定需要时再考虑。

不建议再用的旧客户端

下面几款已经停更或归档，新装时不要选。

• App Store 上的同名应用有的应用名字带 Clash，但看不出与原版 Clash 项目有关联，不要按名字找客户端。

安装包怎么选：Apple 芯片还是 Intel？

先确认芯片，再到官方发行页按文件名挑对应的安装包。

三步选对文件

1. 确认芯片点屏幕左上角苹果菜单 →「关于本机」。显示“芯片 Apple M…”的是 Apple 芯片，显示“处理器 … Intel …”的是 Intel。
2. 对照文件名arm64、aarch64、Apple Silicon、Apple M 指 Apple 芯片；x64、x86_64、Intel 指 Intel；Universal 是通用包，两种芯片都能装。
3. 选最新正式版在下表的官方发行页下载，标着 Pre-release 的是预发布版。例如 v2rayN 的 7.25.x 中只有 7.25.4 和 7.25.6 是正式版。

各客户端的官方下载

• 项目页里的机场推广Clash Verge Rev 的项目首页、Clash Party 的 Release 说明里有机场推广，那是项目方的广告，和客户端本身无关。
• v2rayN 的 GPG 签名发布文件附有 GPG 签名，熟悉 GPG 的读者可以用来核对文件是否完整。它和 Apple 的开发者签名不是一回事，不影响下文的拦截提示。

按文件类型安装

• DMG打开后把应用拖进「应用程序」文件夹。
• PKG双击后按安装器提示完成。
• ZIP先解压，再把 .app 移到「应用程序」文件夹后运行，不要直接在「下载」文件夹里打开。

首次打开被拦截怎么办？

没有经过 Apple 公证的应用，首次打开时会被 macOS 拦下，开源客户端和机场客户端都可能遇到。先确认文件来自上表的官方发行页或机场官网，再只对这一个应用放行；出处说不清的文件直接删除。

用「仍要打开」放行

以下按 macOS 13 及以后的「系统设置」界面，按钮文字随系统版本略有差异。

1. 先打开一次在「应用程序」里双击应用。弹出无法验证开发者、无法检查恶意软件之类的提示时，关闭提示，不要选「移到废纸篓」。
2. 到设置里放行打开「系统设置」→「隐私与安全性」，在「安全性」部分找到该应用被阻止的说明，点「仍要打开」。
3. 再确认一次按弹出的提示确认，可能需要输入 Mac 登录密码或使用触控 ID。

• 设置里没看到这条说明回到第 1 步再打开一次。
• macOS 12 及更早版本在「系统偏好设置」→「安全性与隐私」→「通用」里找。
• 只放行这一个应用不要为了装软件去关闭整套 Gatekeeper 检查。

提示“已损坏，无法打开”

遇到这种提示时，设置里可能没有「仍要打开」可点。v2rayN 官方说明其 macOS 的 dmg 安装包没有签名，安装到「应用程序」后需要在「终端」运行：

xattr -cr /Applications/v2rayN.app

• 这条命令的作用清除该应用下载时被附加的隔离等扩展属性，之后再正常打开。
• 只对官方下载的应用这样做文件必须来自官方发行页。
• 其他客户端遇到同样提示先从官方发行页重新下载一次；仍然不行，按该项目文档或发行页说明处理。

怎么导入订阅？

先在面板复制对应格式的订阅链接，再按所用客户端的步骤导入。菜单名称和位置以当前版本的界面为准。

先准备订阅链接

在机场用户面板复制订阅链接，它看起来类似 https://example.com/subscribe/abc123。

• 当作账号凭证保管不要发到群里或截图外传。
• 按客户端选格式Clash Verge Rev、ClashX Meta、FlClash、Clash Party 用 Clash（Mihomo）订阅，v2rayN 用通用订阅，SFM 用 sing-box 订阅。
• 一键导入面板上的导入按钮会调用客户端的链接协议，Clash Verge Rev、FlClash、ClashX Meta 支持 clash://install-config?url=，Clash Party 用 mihomo://install-config，SFM 用 sing-box://import-remote-profile。先装好客户端再点，浏览器询问是否打开应用时确认；没有反应就复制链接手动导入。

Clash Verge Rev

1. 打开订阅页左侧点「订阅」。
2. 粘贴并导入把订阅链接粘贴到页面顶部写着“订阅文件链接”的输入框，点「导入」。
3. 启用订阅点选这张订阅卡片，或右键选「使用」。

• 要设置更新间隔或用户代理改用「新建」→ 类型选「远程」→ 填「订阅链接」。
• 界面名称以上为简体中文界面的名称，按钮位置以当前版本为准。

ClashX Meta

1. 打开配置管理点菜单栏里的 ClashX Meta 图标 →「配置」→「托管配置」→「管理」。
2. 添加订阅在“托管的配置文件”窗口点「添加」，填入订阅链接并确认。
3. 设置更新之后可以手动「更新」，也可以开启「自动更新」并设置更新间隔。

官方没有图文步骤，以上名称取自简体中文界面，位置以当前版本为准。

v2rayN

1. 添加订阅分组菜单「订阅分组」→「订阅分组设置」→「添加」。
2. 填写地址「别名」随意填写，「可选地址 (Url)」粘贴订阅链接，确定。
3. 更新订阅回到主界面，「订阅分组」→「更新全部订阅（不通过代理）」；节点列表出现节点即导入成功。

SFM

1. 新建配置进入「Profiles」，点「New Profile」。
2. 填写订阅类型选「Remote」，填写 Name 和 URL（订阅链接）；自动更新间隔默认 60 分钟。
3. 创建并连接点「Create」创建，然后选中这个配置并启动连接。

以上为英文界面名称，按钮位置以当前版本为准。首次连接时如果出现 VPN 配置或系统扩展提示，按系统授权一节允许。

FlClash

1. 新建配置「配置」→「添加配置」。
2. 通过 URL 导入选「URL」，粘贴订阅链接后提交。

官方没有图文步骤，按钮名称以当前版本为准。

Clash Party

1. 选择配置模式首次启动如果让你选择，选「标准模式」，直接使用订阅里的节点和规则；「简易模式」是手动管理节点的。
2. 导入订阅侧边栏「订阅管理」→ 在“请输入您的订阅网址”输入框粘贴 →「导入」。

机场自有客户端

• 按帮助中心登录上文提到的几家写明用官网账号登录，之后在客户端里选节点，不需要手动导入订阅。
• 登录后没有节点先到官网确认套餐是否有效。

系统代理和 TUN 用哪个？

日常上网只开系统代理；终端命令行或不读系统代理的应用需要走代理时，再开 TUN，而且只在一个客户端里开。

系统代理：日常上网用这个

选好节点后，打开客户端里的系统代理开关，名称和位置以当前版本为准。

• 作用修改 macOS 网络设置里的代理项，Safari、Chrome 等遵循系统代理的程序就会经由客户端访问网络。
• 代理模式Clash 系客户端还有规则、全局、直连等模式，日常用规则模式，由订阅里的分流规则决定哪些网站走代理。

TUN 模式：接管不读系统代理的程序

客户端创建一块虚拟网卡，把不读系统代理设置的程序流量也接管过来，这一步需要更高权限。

• 只在一个客户端里开两个客户端同时开 TUN 或系统代理会互相干扰。
• 开启后网络异常先关掉 TUN，确认只用系统代理能否正常访问，再逐项排查。

开启 TUN 时的系统授权

开启时可能遇到下面几类系统提示，会出现哪种、开关在哪里取决于客户端和版本，按当前界面提示和官方文档操作。

怎么确认已经连上？

打开系统代理后，按下面四步依次检查，哪一步不对就看连不上或出错怎么办。

1. 确认 macOS 已接管打开「系统设置」→「网络」→ 当前网络（如 Wi-Fi）→「详细信息…」→「代理」。通常能看到网页代理（HTTP）、安全网页代理（HTTPS）等项已开启并指向本机地址 127.0.0.1；有的客户端改用自动代理配置。
2. 做延迟测试节点列表有延迟测试按钮时，结果会显示毫秒数或超时。它只说明节点此刻能否连通、响应快慢，不代表下载速度，也不代表其他时段同样可用；个别节点超时就换一个。
3. 做访问测试用浏览器打开一个平时需要代理才能访问的网站。客户端如果有连接列表或日志页面，应能看到对应记录。
4. 核对用量部分客户端会在订阅卡片上显示已用流量和到期时间，取决于机场是否提供这些信息；没有显示就到机场面板查看。

连不上或出错怎么办？

按“现象 → 检查 → 可能原因 → 下一步”逐项处理，仍不行再联系机场客服。

应用打不开，或提示“已损坏”

• 检查文件是否来自官方发行页；芯片版本是否选对；系统版本是否达到上表要求（v2rayN 需 macOS 13.6，SFM 需 macOS 13.0）。
• 下一步按首次打开被拦截一节放行；系统版本不够时，Clash 订阅可改用 Clash Party。

Clash Verge Rev 导入时报 invalid yaml

• 常见原因订阅返回的是 Base64 通用订阅，不是 Clash YAML。Clash Verge Rev 只接受包含节点（proxies 或 proxy-providers）的 YAML 配置；Clash Party 遇到同样情况会提示 “Profile is not a valid YAML”。
• 下一步在面板换成 Clash / Mihomo 格式的链接；机场只提供通用订阅时改用 v2rayN。

订阅导入或更新失败

• 检查浏览器能否打开机场面板；Mac 的日期和时间是否准确。
• 可能原因订阅地址在当前网络下无法直接访问，或订阅已被重置、套餐已到期。
• 下一步手上已有可用节点时改用代理更新。Clash Verge Rev 在订阅卡片上右键选「更新（代理）」，v2rayN 用「更新全部订阅（通过代理）」。
• 仍然失败到面板确认订阅状态，完整步骤见订阅更新失败与无法连接排查。

退出客户端后上不了网

• 原因客户端非正常退出时，macOS 的代理设置可能还开着，指向一个已经不存在的本地端口。
• 下一步重新打开客户端，关闭系统代理后再退出；或到「系统设置」→「网络」→ 当前网络 →「详细信息…」→「代理」，手动关闭网页代理（HTTP）、安全网页代理（HTTPS）、SOCKS 代理等开关。
• 卸载过开启 TUN 的客户端仍异常时，到「系统设置」的「VPN」或「网络」里检查是否留有它的配置。

部分软件不走代理

• 原因这类软件通常不读取系统代理设置。
• 下一步在一个客户端里开启 TUN 模式。

接下来看什么？

• 订阅格式和对应机场Clash 机场怎么选、v2rayN 机场怎么选。
• 同时用 Windows 电脑Windows 客户端入门。
• 按预算和设备挑机场机场推荐。