先查应用名称和核心

这几个名称不能代表同一维护状态和相同核心。本文以现有 Mac 用户排障为范围：在关于/日志中记下应用来源、版本和内核。ClashX.Meta 的来源是 MetaCubeX/ClashX.Meta；它不是 Linux 客户端。下载前核对仓库当前发行说明，本文不替旧 ClashX Pro 镜像提供可信保证。

核对订阅是否适配当前核心

先在 Roxi 网站登录自己的账户，打开订阅区域，复制“第三方客户端”订阅地址。不要复制官网首页、邀请链接或浏览器地址栏里的登录地址。客户端不附送节点；套餐、流量、到期时间和设备限制以账户页为准。

使用账户页的 Clash Meta / mihomo 链接；手动处理时将原 /sub/个人标识 改为 /sub/clash/个人标识，得到完整 mihomo YAML 配置。

下面的 /sub/... 仅表示原链接中的路径。保留账户提供的域名、个人标识和查询参数；只替换一次路径，不把示例占位符当作真实地址，也不要重复加成 /sub/clash/clash/。已有专用链接时直接使用。不要将订阅 URL 发给公共转换站。

  1. 在支持远程配置的版本中添加 URL，更新后选择为当前配置，检查实际节点与解析错误。
  2. 若旧核心不认识 VLESS、MRS 等字段，优先迁移到本目录的 Clash Verge Rev、Clash Party 或 FlClash，不删除整个规则段勉强启动。
  3. 新客户端先导入原始远程订阅，再逐条重建必要的本地规则；不要直接移植旧应用的数据库。

Mac 的系统代理和退出检查

首次连接只启用自己需要的接管方式，核对 Wi-Fi 与有线网卡对应的代理设置。普通浏览器可用而其他应用失败，再检查应用是否读取系统代理。退出时先停止接管再退出菜单栏程序；系统设置仍有旧代理端口时恢复本次改动前的值。

怎样确认真正连通

  1. 确认这次更新成功、节点数大于零，并选中了刚导入的配置。更新失败时可能仍在使用旧缓存，不能只看列表里还有节点。
  2. 固定一个节点，访问实际要用的网站或应用，再查看连接或日志中的目标、规则与出口。延迟数字、VPN 图标和“已启动”都不能单独证明业务成功。
  3. 同时检查一个平时可直连的网站；随后断开连接，确认基础网络恢复。只在全局模式可用时回到规则排障，不把全局作为长期修复。

失败后按层排查，保留可恢复的配置

现象先核对下一步
下载失败或 401 / 403订阅地址、账户状态、设备限制和当前网络回账户复制新地址；看响应说明，不连续重复导入
解析失败 / 节点为零下载到的是 YAML、JSON、节点列表还是登录网页换成本文指定格式，保留错误字段名与客户端版本
能启动但目标打不开当前节点、规则、DNS 和请求日志换一条兼容节点做对照，勿删除 TLS 校验
停止后不能直连系统代理、其他 VPN、断线阻止设置先在客户端正常停止接管，再退出；恢复改动前设置

求助只提供系统与客户端/核心版本、失败阶段、发生时间和脱敏日志。升级前备份本地规则；订阅更新会替换远程内容，个性化设置尽量放在客户端支持的覆写或本地规则里。