metacubexd 在 macOS 上提示已损坏怎么处理
从项目 GitHub 下载 MetaCubeXD 桌面版,拖进“应用程序”后双击,系统弹窗说它已损坏、无法打开,还建议你移到废纸篓。先别删。这个提示和 App 没有签名有关,项目 README 已经给了处理办法,下面按顺序讲。
弹窗从哪来:桌面版没有签名
结论:这是 macOS 拦截未签名应用时的提示,不等于安装包坏了。
metacubexd 在 README 里自述是 Mihomo(也就是 Clash Meta)的网页面板,除了网页版,还有一个内置内核的桌面版。桌面版安装那一段写得很直白:“These builds are unsigned.”,也就是这些构建没有签名。项目目前不提供通过代码签名来验证发布者身份的方式。
macOS 的 Gatekeeper 会阻止未签名的应用,README 记录的弹窗原文是 “MetaCubeXD is damaged and can't be opened”。中文系统上看到的“已损坏,无法打开”就是这一句。
所以判断方法很简单:如果你打开的是 MetaCubeXD,而且弹窗文字是“已损坏”,基本就属于这一类。
处理前先核对下载来源
结论:README 要求先确认安装包来自项目自己的 Releases,再决定要不要放行。
去掉隔离属性等于告诉系统“我信任这个文件”。README 在这里提了三点要求:只从本仓库的 GitHub Releases 下载;核对下载地址和 release 的 tag 是否对得上;自己判断可以信任之后,再绕开系统的警告。
如果安装包是从网盘、群文件或者别的转载页拿到的,没办法核对 tag,就重新去项目 GitHub 的 Releases 页下载一份,再往下做。
办法一:用 xattr 去掉隔离属性
结论:把 App 拖进“应用程序”文件夹后,在终端执行 README 给出的那条命令。
步骤如下:
- 把 MetaCubeXD.app 拖进“应用程序”文件夹,路径就是 /Applications。
- 打开“终端”。
- 输入下面这条命令并回车:
xattr -dr com.apple.quarantine /Applications/MetaCubeXD.app- 回到“应用程序”文件夹,重新打开 MetaCubeXD。
命令针对的是 com.apple.quarantine 这个隔离属性。README 的写法默认 App 已经放在 /Applications 下;如果你放在了别的目录,命令末尾的路径要换成实际位置。
办法二:右键打开
结论:不想碰终端,可以用右键菜单放行一次。
README 写的另一种做法是:在 App 图标上点右键,选“打开”,在弹出的确认框里再点“打开”。原文是 “right-click the app → Open → Open in the confirmation dialog”。
README 把它和 xattr 命令并列写出,没有说哪种更好。
App 能开,但内核没跑起来
结论:内置的 mihomo 也可能被隔离,同一条命令能一起处理。
有一种情况容易被误判:右键打开之后,面板窗口出来了,但代理没有生效,内核像是没启动。README 的故障排查段专门写了这一条:从网上下载的未签名 .app,里面打包的 mihomo 会被隔离,进程会被系统结束。处理办法还是执行上面那条 xattr 命令,然后重新打开 App。
如果你之前用的是右键打开,遇到这种“窗口在、内核不在”的情况,就补跑一次 xattr 命令。
面板端口不要默认写 9090
结论:桌面版每次启动都会重新挑端口,别在浏览器里硬敲 9090。
很多人习惯在浏览器里打开本机的 9090 端口进面板。README 提醒,桌面版每次启动会为控制 API、Clash API 和 mixed 代理各选一个空闲的回环端口,原文是 “Do not assume 9090”。如果你在别的工具里手动填了 9090,连不上并不说明 App 有问题,要以桌面版自己显示的端口为准。
还是打不开怎么办
结论:README 没有覆盖到的情况,带齐信息去项目 GitHub 提 issue。
README 没有写这个问题从哪个版本开始出现,也没有说明 Apple 芯片和 Intel 机型有没有区别。处理完仍然打不开,可以在项目 GitHub 新开 issue,写清 MetaCubeXD 的版本、macOS 版本、芯片类型、执行 xattr 命令时终端的输出,以及完整的弹窗文字。
如果你只是想找一个能在 Mac 上用的 Clash 类客户端,可以先看 Clash 客户端下载现状,各家在签名和分发方式上并不一样。订阅导进去之后怎么检查,可以参考 Clash Verge 订阅验收 里的步骤,思路是通用的。
常见问题
MetaCubeXD 提示已损坏,是下载的文件坏了吗?
多数情况不是。README 说明桌面版构建没有签名,macOS 的 Gatekeeper 会拦下未签名应用,弹窗文字就是“is damaged and can't be opened”。先确认文件来自项目 GitHub 的 Releases 页,再按 README 的办法处理。
xattr 命令要在哪里运行?
先把 App 拖进“应用程序”文件夹,再打开“终端”执行 xattr -dr com.apple.quarantine /Applications/MetaCubeXD.app,命令里的路径要和 App 实际所在位置一致。
不想用终端,有别的办法吗?
README 给了另一种做法:在 App 上点右键,选“打开”,在弹出的确认框里再点一次“打开”。
App 能打开,但代理起不来,也是同一个原因吗?
可能是。README 的故障排查段写到,从网上下载的未签名 App,里面打包的 mihomo 也会被加上隔离属性,处理办法同样是执行那条 xattr 命令后重新打开。
面板端口是不是固定 9090?
不是。README 说桌面版每次启动会为控制 API、Clash API 和 mixed 代理各选一个空闲的回环端口,并提醒不要默认它是 9090。
处理完还是打不开该怎么办?
README 没有给出该问题对应的版本,也没有区分 Apple 芯片和 Intel 机型。可以去项目 GitHub 新开 issue,写清 App 版本、macOS 版本、芯片类型和完整的弹窗文字。