Updated 2026/05/12

Clash订阅排错手册：Mihomo YAML、sing-box JSON、OpenClash与节点为空

Clash订阅排错手册，整理 Mihomo YAML、sing-box JSON、OpenClash、策略组、节点为空和刷新失败。

小李代理配置手册面向已经拿到订阅链接、正在处理客户端导入问题的读者。页面围绕 Clash、Mihomo、sing-box、OpenClash、Shadowrocket、v2rayN 等工具整理配置字段、错误症状和排查步骤。

先判断订阅属于哪一种

Clash / Mihomo YAML

检查 proxies、proxy-groups、rules、rule-providers 是否完整。

sing-box JSON

检查 outbounds、route、dns 是否齐全，确认客户端能读取 JSON。

通用订阅

检查 SS、Trojan、VMess、VLESS 等节点协议是否被当前内核支持。

路由器插件

OpenClash、PassWall2 应先备份旧配置，再导入新订阅。

排错先看三层

层级 检查点 典型症状
链接层 订阅地址是否返回配置内容 刷新失败、返回登录页
解析层 YAML、JSON、节点协议是否被识别 节点为空、parse error
运行层 DNS、路由、策略组是否命中 有节点但无法访问

订阅排错的推荐顺序

先看链接是否能访问，再看返回内容是不是配置文件，最后看客户端能否解析。Clash 和 Mihomo 重点看 proxies、proxy-groups、rules；sing-box 重点看 outbounds、route、dns；v2rayN、NekoBox、Shadowrocket 等工具还要看节点协议是否被当前内核支持。

日志里常见的三个关键词

parse 通常表示配置结构无法解析，timeout 通常表示订阅入口、DNS 或网络访问异常，unsupported 通常表示协议、字段或客户端内核不支持。排错时先记录客户端版本、系统、订阅类型、刷新时间和报错原文，再决定是否更换订阅格式或升级内核。

机场订阅诊断索引（39 篇）

客户端配置索引（20 篇）

配置排错 FAQ

Clash 订阅和 Mihomo 配置有什么关系？

Mihomo 延续 Clash 配置生态，但字段支持和内核能力会变化，导入失败时要结合日志判断。

sing-box JSON 和 Clash YAML 可以混用吗？

两者结构不同。需要转换时，要重新检查 outbounds、route、dns 和规则集。

节点为空先查哪里？

先用浏览器确认订阅返回内容，再检查套餐状态、客户端版本和订阅格式。

订阅链接可以发给别人排错吗？

订阅链接通常包含账号凭据。排错时应隐藏完整链接，只提供客户端、系统、报错文本和刷新时间。