兔洞博客
兔洞博客
个人博客

Clash YAML 配置检查

⚠️ 配置可能包含服务器地址、密码和私钥。工具只在当前浏览器本地运行,不会上传内容;仍不建议在公共设备上粘贴敏感配置。

配置无法导入、更新后节点消失或规则不生效时,可以先用本工具排查常见格式和引用问题。粘贴后会自动检查。

配置只在浏览器本地分析,不会上传或发起网络请求。

这个工具是干什么的

Clash 类客户端(Clash Verge Rev、Clash Party / Mihomo Party、mihomo 等)的配置文件是一份 YAML 文本。很多人从订阅转换、别人分享的模板或自己手写改配置时,会碰到配置明明看着没错,客户端却导入失败、节点消失、规则不生效的情况。绝大多数时候不是机场的问题,而是 YAML 本身的格式或引用错了。

本工具把这份配置贴进来,只在你浏览器里分析,帮你快速定位最常见的几类问题:

  • 缩进 / 冒号写错:YAML 靠缩进表达层级,少一个空格、冒号后没空格就会解析失败,客户端直接报 YAML error。
  • 关键块缺失:proxies(节点)、proxy-groups(策略组)、rules(规则)任一块没了,导入后就会节点为空或规则不生效。
  • 策略组引用断链:proxy-groups 里写了引用某个节点或别的组,但名字拼错、那个节点根本没在 proxies 里定义,客户端要么报错要么组里是空的。

什么时候该用它

  • 客户端提示 YAML / parser / proxy group / rule provider 错误
  • 配置更新后节点突然消失、或规则怎么都不生效
  • 你手改了配置、或从别处复制了一段想合并进去

能检查什么

  • proxies / proxy-groups / rules 关键块是否存在
  • YAML 语法错误(缩进、冒号、数组格式)并定位行号
  • proxy-groups 里引用的节点名是否都在 proxies 中定义(引用断链)
  • 敏感字段(password / token / uuid / secret)存在提醒

检查范围

这是面向 Clash 配置的静态基础检查,不是完整 YAML 解析器,也不会下载 proxy-providers 或 rule-providers,不会验证节点可用性。通过检查不代表配置一定可用,最终应在 Clash Verge Rev、Clash Party 或其他兼容客户端中实际加载。

策略组名称包含逗号、行内复杂对象或特殊 YAML 语法时,也可能出现误报,以客户端实际加载为准。

常见误区

  • “通过检查 = 节点能用”:不对。本工具只查格式和引用,不验证节点是否在线、套餐是否有效。最终要在客户端里实际加载、能出墙才算数。
  • “报错了就整份重来”:绝大多数错误集中在一两行,定位改掉即可,重写容易引入更多错。
  • “策略组名带逗号会错”:组名里含逗号、或用了行内复杂对象时,解析器可能误报,以客户端实际加载为准。
工具与软件