· 故障排查 · 约 7 分钟阅读

Clash 订阅链接失效或解析失败:从报错信息到逐项自查

按报错类型拆解订阅导入失败的常见原因,包括链接过期、格式不兼容、网络拦截和 YAML 语法错误,并给出可逐项执行的自查顺序。

先判断失败发生在哪一步

先保留还能使用的旧配置,再打开 Clash 客户端的日志或订阅更新详情。手动更新一次,记录时间,找到对应的第一条错误。订阅导入要经过三个步骤:获取响应、解析配置、由内核加载。界面弹出的“更新失败”可能指其中任何一步。

报错或现象优先检查
401、403、404账户状态、链接完整性、服务端访问限制
no such host、timeout、x509域名解析、连接路径、证书信任
HTTP 200,却提示格式无效响应是配置、登录页,还是通用节点列表
yaml: line 12 或 unsupported proxy type分别检查 YAML 结构和内核支持范围

401、403、404:检查链接和账户状态

  1. 从服务方的账户面板重新复制。选择标明适用于 Clash 或 mihomo 的订阅入口。检查粘贴结果有没有引号、换行或尾随空格。保留原始查询参数,不要手动删改 ? 后的内容,也不要从被界面省略的显示文本里复制。
  2. 核对有效期和令牌状态。账户仍能登录,不代表旧订阅地址仍然有效。若刚续费、重置订阅或迁移服务,优先用面板当前提供的地址新建配置,成功加载后再考虑替换旧条目。
  3. 按状态码缩小范围。401 通常表示认证未通过;403 表示请求被拒绝,可能涉及账户权限、访问频率或网关策略;404 可能是路径已迁移,也可能是服务端隐藏了资源状态。429 表示请求过多,应按服务方提示等待,不要连续刷新。

如果浏览器里能打开,Clash 客户端里却返回 403,先用 Safari 的「文件」→「新建无痕浏览窗口」复查。普通窗口可能带有已登录的 Cookie,而订阅更新器通常不共享浏览器会话。无痕结果也不一定与 Clash 客户端完全一致;两者可能使用不同的请求标识和连接路径。若只有登录后才能看到内容,向服务方确认是否复制了网页入口,而不是订阅直链。

超时、解析失败与证书错误:检查 macOS 网络

确认当前连接和代理端口

在 macOS 13 及更新版本中,打开「系统设置」→「网络」→ 当前网络服务 →「详细信息」→「代理」。检查网页代理和安全网页代理是否指向仍在监听的地址。比如系统设置填的是 127.0.0.1:7890,而 Clash 客户端当前混合端口已改为 7897,读取系统代理的应用就可能连接失败。这两个端口只是排查示例,实际以 Clash 客户端界面为准。

订阅更新器是否使用系统代理,取决于具体 Clash 客户端和它的下载设置。若更换配置前还能更新,先切回旧配置验证;若系统代理或 TUN 正在影响测试,在允许的网络上一次只调整一个开关,对照同一条订阅的结果。不要把 Safari 页面可打开当作更新器一定可达的证据。

区分 DNS、超时和 TLS

  • no such host:先核对域名拼写,再查看当前网络服务「详细信息」里的「DNS」。连接公共 Wi-Fi 时,先确认网络登录门户已经完成认证。
  • i/o timeout:先看错误发生在解析、连接还是等待响应。有条件时用获准的另一条网络复测一次。只在某个网络失败时,优先检查该网络的代理或访问策略,不要立刻重置订阅。
  • x509: certificate signed by unknown authority 或证书过期:检查「系统设置」→「通用」→「日期与时间」,确认系统时间正确。若问题持续,联系网络管理员或服务方;不要关闭证书校验,也不要安装来源不明的根证书。

HTTP 200 仍然解析失败:确认响应格式

200 只表示服务器返回了内容,不代表内容是配置。若 Clash 客户端能预览响应,先看开头和关键字段。出现 <!doctype html>、登录提示或网关提示时,应查响应为何变成网页;出现 JSON 错误对象时,先读服务端的错误信息。给这些内容改成 .yaml 扩展名不会改变格式。

  • 完整配置:通常能看到 proxies: 或 proxy-providers:,并可能含有 proxy-groups: 与 rules:。顶层字段和引用关系要符合当前内核要求。
  • 仅供代理提供者引用的数据:有些 YAML 文件只包含节点列表,用于现有配置里的 proxy-providers。拿到这类地址时,先问服务方有没有完整配置入口,不要假定可直接替换整份配置。
  • 通用节点订阅:响应可能是 Base64 文本,也可能逐行列出 ss:// 等 URI。能否导入取决于 Clash 客户端是否明确支持该入口;否则改用服务方提供的对应格式。

同一地址也可能按请求标识返回不同格式。如果浏览器预览与日志反映的内容不一致,优先使用服务方针对当前 Clash 客户端提供的入口。若日志能分辨主配置 URL 和代理提供者 URL,还要确认失败的是哪一个:主配置下载成功,不能说明它引用的节点数据也已更新。

YAML 行号和内核报错:分开处理

有行号,先检查缩进和列表

用本地纯文本编辑器打开配置副本。日志若指向第 12 行,也要检查第 11 行和同级字段。解析器常在读到下一项时才发现上一项少了引号、冒号或列表标记。缩进用空格,不用 Tab;同一层级对齐。下面只演示规则列表的写法,不是完整配置:

rules:
  - DOMAIN,example.com,DIRECT
  - MATCH,DIRECT

远程订阅更新可能覆盖手工编辑。若刚下载的原始响应就有语法错误,向服务方反馈脱敏后的行号与错误类型;若错误只在应用覆写之后出现,先停用最近修改的覆写项,再导入副本复测。

能解析但无法加载,再检查内核

unsupported proxy type 不是缩进错误。它表示当前加载器不接受配置中的节点类型。到 Clash 客户端的「关于」或启动日志中记录客户端版本和内核版本,例如日志里的 mihomo v1.19.0;界面的应用版本不能替代内核版本。面向 Clash Meta(mihomo)的配置可能使用旧 Clash 内核不认识的协议或字段,应按服务方和内核文档核对。

如果报的是找不到代理或策略组,则检查名称引用。rules 中写的目标要能对应内置策略、节点或策略组;策略组列出的节点名称也要存在。特别留意覆写是否改了组名,却没同步更新规则。不要只删除报错行:删掉末尾兜底规则或改错策略,可能让配置加载成功,却改变流量去向。

修复后分别验证更新、加载和连接

  1. 确认更新。手动更新一次,核对该条目的更新时间和日志,区分新响应与旧缓存。若使用远程代理提供者,也检查其更新结果。
  2. 确认加载。显式选中刚导入的配置,查看内核是否接受,节点和策略组是否出现。更新成功但未切换配置时,界面仍可能显示旧节点。
  3. 确认连接。用一个预期直连的站点和一个预期走代理的站点做对照,在连接日志中看规则和出站是否符合预期。若只有节点超时,问题已从订阅导入转为节点连通性,不必继续更换订阅地址。

仍未解决时,记录 macOS 版本、Clash 客户端版本、内核版本、更新时刻、HTTP 状态码和首条脱敏错误,并说明是否能在另一条获准网络上复现。连接与流量接管问题可继续参考配置问题诊断。

下载Clash