适用条件:先确认是不是这个问题
适用于手动编辑 mihomo 配置后无法加载,或加载成功却认证失败的情况。先保留原文件,再检查刚修改的文本;本文不适用于远程订阅本身返回 401 的问题。
为什么会出现这种现象
YAML 中,前面有空格的井号可能开始注释,冒号加空格表示键值结构,Tab 也不能代替层级缩进。看起来写进去了的密码或名称,解析后可能已不是原来的字符串。语法能通过也不证明账号参数正确。
按顺序操作,每次只改一项
- 复制当前配置作为备份,并保存报错行号。只查看本机副本,避免把带密码的完整配置粘到在线 YAML 校验器。
- 用能显示空白字符的编辑器核对报错行及上一行:同级键左对齐,列表短横线位置一致,缩进全部使用空格。不要全文件自动替换后立即覆盖原稿。
- 对包含“空格加 #”“冒号加空格”或通配符的字符串加引号。下方示例中引号内的 # 是内容,结尾 # 才是注释;不要把需要布尔值的 enable: true 一并改成字符串。
- 在客户端对副本执行配置检查或查看加载错误。确认通过后再切换到修订配置,重建一个测试连接;只在本机比对实际字符串,不在截图中展示密码。
name: "示例: 香港 # 1"
password: "demo # value" # 此处才是注释
# 缩进使用空格,不使用 Tab怎样判断已经修好
先确认配置加载错误消失,再检查新连接是否仍有认证失败。若只修缩进就恢复加载,说明修复的是语法;若认证仍失败,应继续核对服务端提供的字段,不能把“YAML 合法”记成“节点可用”。
没修好时如何恢复与继续排查
切回备份配置即可撤销本轮编辑。如果远程订阅更新后又出现问题,改用客户端支持的本地覆写入口,或把脱敏后的字段类型和报错行号交给订阅提供方,不长期修改自动生成的缓存文件。