macOS 提示“已损坏,无法打开”通常并非安装包真损坏,而是开源 Clash 客户端未购买 Apple 开发者公证,被系统 Gatekeeper 加上了 com.apple.quarantine 隔离属性。在核对 GitHub 官方 SHA256 校验值无误后,拖入 /Applications 目录并执行 xattr -cr 或在“隐私与安全性”中手动“仍要打开”即可彻底解决。
在 Mac 上首次安装 ClashX.Meta、Clash Verge Rev 或 Clash Party 时,很多新手都会被系统弹出的红色或黄色警告吓到:
- “Clash Verge.app”已损坏,无法打开。你应该将它移到废纸篓。
- 无法打开“ClashX.Meta”,因为 Apple 无法检查其是否包含恶意软件。
- 无法打开“Clash Party”,因为来自身份不明的开发者。
面对“已损坏”三个字,不少用户会误以为文件下载坏了,或者电脑中了病毒,反复重新下载好几次依然报错。实际上,只要你的安装包确实来自 GitHub 官方仓库,这类弹窗 99% 都源于苹果的安全机制 Gatekeeper 与 公证(Notarization) 策略,而不是软件本身损坏。
本文将从底层原理讲起,带你在安全核验安装包的前提下,用最稳妥的方式彻底解决 macOS(包括 Apple Silicon M1–M4 芯片与 macOS Sequoia 15)上的拦截报错。
一、为什么开源 Clash 客户端会被 macOS 提示“已损坏”?
理解原因后,你就知道为什么不能盲目听信网上的“一键关闭系统安全防护”脚本,也能精准判断不同弹窗的含义。
1. Apple 开发者签名与公证(Notarization)机制
macOS 为了防止恶意软件通过网页传播,默认要求所有从互联网下载的应用程序满足两个条件:
- Developer ID 签名:开发者需要向苹果付费注册 Apple Developer Program,并使用证书对应用签名。
- Apple 公证(Notarization):将签名后的应用上传给苹果服务器自动扫描,通过后下发公证票据(Ticket)。
然而,ClashX.Meta、Clash Verge Rev、Clash Party 等均属于开源社区免费维护的网络工具项目。一方面,社区维护者往往不会为免费开源工具绑定实名付费的 Apple Developer ID;另一方面,部分开源版本只做了临时签名(Ad-hoc signing)甚至未签名。
2. 浏览器附加的 com.apple.quarantine 隔离属性
当你通过 Safari、Chrome、Edge 等浏览器下载 .dmg、.zip 或 .pkg 文件时,macOS 会自动在文件的扩展属性(Extended Attributes)中写入一条名为 com.apple.quarantine 的标记,俗称隔离属性。
在 Apple Silicon(M1 / M2 / M3 / M4) 芯片的 Mac 上,苹果对可执行代码的签名要求比旧款 Intel Mac 更严格。当系统检测到一个带有 com.apple.quarantine 标记、却没有通过苹果公证或签名校验不完整的应用时,Gatekeeper 就会直接给出极具误导性的提示——“应用已损坏,无法打开”。
3. 三种常见弹窗的真实含义对照
| 系统弹窗提示语 | 常见触发场景 | 真实原因 | 推荐处理优先级 |
|---|---|---|---|
| “xxx”已损坏,无法打开。你应该将它移到废纸篓 | Apple Silicon M1–M4 安装未公证或临时签名的 Clash 客户端 | 文件带隔离属性且未通过 Apple 公证/严格签名检查(极少数情况为下载不完整) | 先校验 SHA256,再执行 xattr -cr |
| 无法打开“xxx”,因为无法验证开发者 | macOS 12–14 安装未签名的开源软件 | 开发者未使用苹果付费证书签名 | 系统设置手动放行或执行 xattr |
| 无法打开“xxx”,Apple 无法检查其是否包含恶意软件 | 通过浏览器下载的未公证应用 | 已签名但未提交苹果服务器公证 | 系统设置“隐私与安全性”点击“仍要打开” |
二、绕过拦截前的必备安全动作:核对官方来源与 SHA256
切记一个原则:绝不对来源不明的软件盲目执行 xattr 放行命令。 网上存在大量伪装成“Clash 官网”“ClashX 绿色版”的钓鱼下载站,里面可能捆绑了木马或广告程序。如果你直接对假包执行解除隔离命令,就等于亲手为恶意程序打开了系统大门。
在放行之前,请务必完成以下两步核查:
1. 核对唯一的官方 GitHub Releases 地址
- ClashX.Meta:
https://github.com/MetaCubeX/ClashX.Meta/releases - Clash Verge Rev:
https://github.com/clash-verge-rev/clash-verge-rev/releases - Clash Party:
https://github.com/mihomo-party-org/clash-party/releases
同时注意区分芯片架构:Apple Silicon(M1–M4)请优先选择文件名包含 aarch64、arm64 或 universal 的安装包;Intel 芯片 Mac 请选择 x64 或 x86_64。
2. 在终端计算并比对 SHA256 校验值
如果官方 Release 页面附带了 SHA256 哈希值或校验文件,你可以打开 macOS 自带的“终端(Terminal)”,运行以下命令查看本地下载文件的真实指纹:
# 假设你下载的文件在“下载”文件夹中,请将文件名替换为实际下载的文件名
shasum -a 256 ~/Downloads/Clash.Verge_*.dmg
终端会输出一串 64 位的十六进制字符。将它与 GitHub Releases 页面公布的校验值逐位比对(重点核对开头 8 位和结尾 8 位即可)。
- 如果完全一致:说明文件既没有被篡改,也没有因为网络断流而损坏,可以放心进入下一步解除隔离。
- 如果不一致:说明安装包确实下载不完整或来源异常,请立即删除并重新从官方 Releases 下载。
三、标准修复方案一:终端执行 xattr 清除隔离属性(最彻底)
这是目前在 macOS Ventura、Sonoma、Sequoia 以及全系 Apple Silicon Mac 上成功率最高、最干净的方法。它不会降低整个系统的安全级别,只针对你指定的这一个 Clash 客户端解除隔离标记。
第 1 步:先将应用完整拖入“应用程序”文件夹
- 如果是
.dmg镜像:双击打开后,将应用图标拖拽到右侧的 Applications(应用程序) 快捷方式中,等待拷贝完成,然后推出(卸载)DMG 镜像。 - 如果是
.zip压缩包(例如 ClashX.Meta):双击解压得到.app文件后,手动把它拖进访达侧边栏的 应用程序 文件夹。 - 如果是
.pkg安装包(例如 Clash Party):直接双击按向导完成安装,程序会自动部署到/Applications目录。
注意:不要留在
~/Downloads(下载)目录里运行,也不要在挂载的/VolumesDMG 窗口里直接运行,否则后续权限授予和自动更新都会出现异常。
第 2 步:检查应用现有的扩展属性(可选)
打开“终端”(可以通过 Command + 空格 呼出聚焦搜索,输入 Terminal 或 终端 回车),查看应用是否带有隔离标签:
xattr -l "/Applications/Clash Verge.app"
如果输出中包含 com.apple.quarantine,就印证了是 Gatekeeper 隔离机制在起作用。
第 3 步:按你安装的客户端执行对应放行命令
请根据你实际安装的客户端名称,复制对应的命令粘贴到终端并回车:
# 情况 A:如果你安装的是 Clash Verge Rev
sudo xattr -rd com.apple.quarantine "/Applications/Clash Verge.app"
# 情况 B:如果你安装的是 ClashX.Meta
sudo xattr -rd com.apple.quarantine "/Applications/ClashX.Meta.app"
# 情况 C:如果你安装的是 Clash Party
sudo xattr -rd com.apple.quarantine "/Applications/Clash Party.app"
按下回车后,终端会提示 Password:,此时输入你的 Mac 开机管理员密码(屏幕不会显示任何字符,这是正常现象),输完直接按回车。如果命令没有任何输出并回到输入提示符,说明隔离属性已经清除成功。
进阶情况:清除所有扩展属性或遇到文件名不一致
如果你不确定应用在 /Applications 里的精确名称,或者执行上面命令后依然提示“已损坏”,可以使用更彻底的 xattr -cr(递归清除该应用包内所有扩展属性):
- 在终端里先输入
sudo xattr -cr(注意-cr后面必须留一个空格,先不要按回车)。 - 打开访达(Finder)进入“应用程序”文件夹,找到对应的 Clash 应用图标,直接用鼠标把图标拖进终端窗口里。终端会自动帮你补全完整且带转义符的精确路径。
- 点击终端窗口使其获得焦点,按回车键并输入管理员密码即可。
如果极少数情况下是因为二进制文件在 Apple Silicon 上缺少局部签名导致的闪退,可以在清除隔离后再补一条本地临时重签名命令(需要系统已安装 Xcode Command Line Tools):
# 仅在执行 xattr -cr 后仍闪退或报签名无效时使用
sudo codesign --force --deep --sign - "/Applications/Clash Verge.app"
四、标准修复方案二:通过“隐私与安全性”图形界面手动放行
如果你不习惯使用终端,且系统弹出的是**“无法验证开发者”或“Apple 无法检查其是否包含恶意软件”**(而非直接报“已损坏”),可以直接在 macOS 系统设置里通过点击完成放行。
macOS Sequoia 15 及以上版本的操作路径
从 macOS 15 Sequoia 开始,苹果取消了过去“按住 Control 键点击应用选择打开”的绕过方式,必须前往系统设置确认:
- 在“应用程序”文件夹中双击 Clash 客户端,系统会弹出安全拦截窗口,点击**“完成”或“好”**(切勿点击“移到废纸篓”)。
- 打开左上角苹果菜单,进入 系统设置(System Settings) → 左侧栏向下滚动找到 隐私与安全性(Privacy & Security)。
- 在右侧页面一直向下滚动到**“安全性”**区域,你会看到一行提示:
已阻止使用“Clash Verge”,因为来自身份不明的开发者。 - 点击该提示右侧的**“仍要打开(Open Anyway)”**按钮。
- 在二次确认弹窗中再次点击**“仍要打开”**,随后通过触控 ID(Touch ID)或管理员密码完成授权。
macOS Sonoma 14 / Ventura 13 的操作路径
步骤与 Sequoia 基本一致:先尝试双击打开一次触发拦截记录,再进入 系统设置 → 隐私与安全性 → 安全性,点击底部的**“仍要打开”**即可。
五、macOS Sequoia 15 与 Apple Silicon M1–M4 专属权限避坑
即使成功打开了 Clash 客户端界面,在较新的 macOS 系统上,首次运行还会遇到几项与系统权限相关的拦截。如果不正确授予,会导致软件能打开却无法接管流量或无法开启 TUN 模式。
1. 本地网络(Local Network)访问权限
macOS Sequoia 15 新增了严格的“本地网络”隐私控制。当你首次启动 Clash Verge Rev 或 ClashX.Meta 时,系统可能会弹窗询问:
“Clash Verge”想要查找本地网络上的设备。
请务必点击“允许”。 如果你误点了“不允许”,会导致软件无法与本地 127.0.0.1 混合代理端口或局域网设备正常通信。修复路径为:系统设置 → 隐私与安全性 → 本地网络,找到对应的 Clash 客户端并将右侧开关重新打开。
2. 后台登录项与扩展(Helper / 服务模式)授权
当你准备启用 增强模式 / TUN 虚拟网卡模式 时,客户端需要安装特权辅助工具(Helper 或 Service Mode)以创建虚拟网卡并修改路由表:
- 系统会弹窗要求输入 Mac 管理员密码以安装辅助工具,请正常输入授权。
- 若弹出“已添加后台项目”通知,请不要在 系统设置 → 通用 → 登录项与扩展 中把 Clash 对应的后台服务开关关闭,否则会导致 TUN 模式开启失败或每次重启失效。
3. 不要使用 spctl --master-disable 全局关闭防护
网上很多过时的教程会教你运行 sudo spctl --master-disable 来把“允许从以下位置下载的应用”改成“任何来源”。但在 macOS Sequoia 中该命令的行为已经发生变化,而且全局关闭 Gatekeeper 会大幅降低 Mac 的日常安全性。记住:只对信任的单个应用执行 xattr -rd com.apple.quarantine,永远比关闭全局防护更安全。
六、还是打不开?进阶排查清单
如果按照上述步骤操作后依然无法启动,请对照下表逐项排查:
- 确认是否下错了芯片架构:打开苹果菜单 → 关于本机,查看芯片是
Apple M1/M2/M3/M4还是Intel。虽然 Apple Silicon 可以通过 Rosetta 2 运行 Intel 版软件,但强烈建议直接下载原生arm64 / aarch64版本,不仅启动更快,也能避免内核异常与额外耗电。 - 确认压缩包是否真的不完整:部分地区直连 GitHub 下载容易在最后几兆断流,导致文件看似下载完成实则损坏。务必核对文件大小和
shasum -a 256值。 - 确认是否旧进程或残留权限卡死:如果之前安装过旧版 ClashX 或异常退出过,可以打开“活动监视器”搜索
clash或mihomo,强制退出残留进程后再重新启动。
成功打开客户端后,如果你还不清楚如何导入订阅链接并验证节点连通性,可以继续阅读 Clash Mac 零基础入门教程;若遇到导入订阅报错或节点全部超时的情况,请直接查阅 订阅失败与节点超时 10 步排障法。
常见问题解答(FAQ)
执行 xattr -cr 后还是提示“已损坏,无法打开”怎么办? +
请依次排查三点:第一,确认你已经把应用拖进了 /Applications 目录,而不是还在 /Volumes 挂载的 DMG 里执行命令;第二,确认应用名称与命令里的路径完全一致(例如 Clash Verge.app 中间有空格,需要反斜杠转义或加引号);第三,确认在 Apple Silicon Mac 上没有误下到极旧版本或不完整的断流压缩包,可先用 shasum -a 256 核对文件完整性。
在终端输入 sudo 密码时屏幕什么都不显示,是不是卡住了? +
不是卡住了,这是 Unix 和 macOS 终端的标准安全机制。输入你的 Mac 开机锁屏密码时,终端不会显示星号或圆点,正常完整输入后直接按回车(Return)键即可提交验证。
为了安装 Clash,需要把 macOS 的“任何来源”全局打开吗? +
不建议全局永久关闭 Gatekeeper(即不建议长期开启 sudo spctl --master-disable)。针对单个可信的开源客户端,单独移除它的 com.apple.quarantine 隔离属性是最安全、影响面最小的方案,既能正常使用 Clash,又保留了系统对其他未知下载文件的防护能力。
macOS Sequoia 15 为什么右键点击“打开”不再出现绕过按钮了? +
从 macOS 15 Sequoia 开始,苹果进一步收紧了 Gatekeeper 交互逻辑,移除了传统的“Control + 右键点击打开即可直接绕过未公证警告”的快捷方式。现在必须先尝试打开一次触发拦截,再进入“系统设置 → 隐私与安全性”拉到最底部点击“仍要打开”,或者直接使用终端 xattr 命令解除隔离。
为什么每次更新 Clash Verge Rev 或 ClashX.Meta 之后又要重新授权一次? +
因为通过浏览器重新下载的新版本安装包会被浏览器再次打上 com.apple.quarantine 扩展属性,覆盖安装到 /Applications 后旧的放行记录不再适用于新的二进制哈希。更新后重新执行一次 xattr -cr 或在隐私与安全性中放行一次即可。
还没有稳定可用的 Clash 订阅?首选 唯兔云
¥14.9/月起,100 GB / 月,提供年付低至 ¥6.66/月、月付 100GB–1.4TB 及永久不限时包,优惠码 rabbit,原生兼容 ClashX.Meta / Clash Verge Rev。