· 故障排查 · 约 7 分钟阅读
Clash 订阅链接失效或解析失败:从报错信息到逐项自查
按报错类型拆解订阅导入失败的常见原因,包括链接过期、格式不兼容、网络拦截和 YAML 语法错误,并给出可逐项执行的自查顺序。
先判断失败发生在哪一步
先保留还能使用的旧配置,再打开 Clash 客户端的日志或订阅更新详情。手动更新一次,记录时间,找到对应的第一条错误。订阅导入要经过三个步骤:获取响应、解析配置、由内核加载。界面弹出的“更新失败”可能指其中任何一步。
| 报错或现象 | 优先检查 |
|---|---|
401、403、404 | 账户状态、链接完整性、服务端访问限制 |
no such host、timeout、x509 | 域名解析、连接路径、证书信任 |
HTTP 200,却提示格式无效 | 响应是配置、登录页,还是通用节点列表 |
yaml: line 12 或 unsupported proxy type | 分别检查 YAML 结构和内核支持范围 |
401、403、404:检查链接和账户状态
- 从服务方的账户面板重新复制。选择标明适用于 Clash 或 mihomo 的订阅入口。检查粘贴结果有没有引号、换行或尾随空格。保留原始查询参数,不要手动删改
?后的内容,也不要从被界面省略的显示文本里复制。 - 核对有效期和令牌状态。账户仍能登录,不代表旧订阅地址仍然有效。若刚续费、重置订阅或迁移服务,优先用面板当前提供的地址新建配置,成功加载后再考虑替换旧条目。
- 按状态码缩小范围。
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 中写的目标要能对应内置策略、节点或策略组;策略组列出的节点名称也要存在。特别留意覆写是否改了组名,却没同步更新规则。不要只删除报错行:删掉末尾兜底规则或改错策略,可能让配置加载成功,却改变流量去向。
修复后分别验证更新、加载和连接
- 确认更新。手动更新一次,核对该条目的更新时间和日志,区分新响应与旧缓存。若使用远程代理提供者,也检查其更新结果。
- 确认加载。显式选中刚导入的配置,查看内核是否接受,节点和策略组是否出现。更新成功但未切换配置时,界面仍可能显示旧节点。
- 确认连接。用一个预期直连的站点和一个预期走代理的站点做对照,在连接日志中看规则和出站是否符合预期。若只有节点超时,问题已从订阅导入转为节点连通性,不必继续更换订阅地址。
仍未解决时,记录 macOS 版本、Clash 客户端版本、内核版本、更新时刻、HTTP 状态码和首条脱敏错误,并说明是否能在另一条获准网络上复现。连接与流量接管问题可继续参考配置问题诊断。