五个状态,逐层确认

层次要确认的事通过后仍不能证明
YAML语法缩进、字符串、映射和列表可解析字段被Mihomo支持
配置语义字段类型、组名与来源引用有效运行核心已读取新文件
核心加载当前进程成功载入指定配置每个节点实际可用
节点可用所需协议与连接检测正常所有目标服务均可访问
业务连接实际请求到达目标并返回预期结果其他网络环境同样成功

先从配置文件的基本组织核对路径和字段,再决定进入哪一层。跳过中间状态直接更换全部节点,往往会丢掉原本能定位问题的信息。

测试命令必须指向你要检查的文件

命令 · 示例路径
mihomo -t -f "./config.yaml"

命令中的./config.yaml是示例路径,需在自己的环境中替换为实际文件。-t测试配置后退出,-f指定配置文件。这个命令不表示已把新文件加载到现有运行进程,也不能作为远端节点连接成功的凭据。构建资料页面无需运行代理或改变系统网络设置。

测试可能涉及配置引用的文件或资源,应先检查受信任的配置与工作目录。保留退出状态和错误内容,不要把演示输出冒充真实日志。若提示YAML解析失败,转到缩进、空格和列表检查;若指出找不到策略名称,逐字比较组定义与引用。

查看正在运行的那份配置

确认核心进程的启动方式、工作目录、配置参数与实际读取路径。某些客户端会生成运行时配置,手工编辑的原文件不一定就是最后加载的文件。记录活动配置标识和加载时间,避免只检查编辑器里那一份副本。

按实际客户端或服务支持的方式重新加载,查看是否成功以及是否继续保留旧配置。重载失败时不要只反复点击,应先读取首条有效错误。提供者文件不存在、路径权限不足、格式不符合预期或版本不支持字段,都需要按具体错误处理。

从一条新连接验证规则链

加载成功后再创建新连接,检查目标、命中规则、策略组当前选择和最终节点。已有连接可能不会因修改而重新匹配。规则仍不符合预期时,按由上到下的匹配顺序确认是否被更早的宽条件接管。

规则符合预期而连接失败,就把排查范围下移到节点、协议和目标服务。单个检测地址可达不代表全部业务都可用;保留错误类型与发生条件,换一个明确可对照的请求验证,避免对运行环境作无依据的结论。

留下一份可以恢复的记录

验证前备份配置和必要的来源文件,记录改动内容及测试对象。出现异常时恢复上一次已确认能加载的版本,重新核对活动路径,防止“回滚了文件却没回滚运行状态”。共享问题记录时隐藏节点凭据、订阅Token和认证信息。

当语法、字段、加载和连接分别有证据时,“检查通过却没生效”就会变成一个可定位的问题。只修复当前失败的那一层,再从这一层继续验证。