五个状态,逐层确认
| 层次 | 要确认的事 | 通过后仍不能证明 |
|---|---|---|
| YAML语法 | 缩进、字符串、映射和列表可解析 | 字段被Mihomo支持 |
| 配置语义 | 字段类型、组名与来源引用有效 | 运行核心已读取新文件 |
| 核心加载 | 当前进程成功载入指定配置 | 每个节点实际可用 |
| 节点可用 | 所需协议与连接检测正常 | 所有目标服务均可访问 |
| 业务连接 | 实际请求到达目标并返回预期结果 | 其他网络环境同样成功 |
先从配置文件的基本组织核对路径和字段,再决定进入哪一层。跳过中间状态直接更换全部节点,往往会丢掉原本能定位问题的信息。
测试命令必须指向你要检查的文件
mihomo -t -f "./config.yaml"命令中的./config.yaml是示例路径,需在自己的环境中替换为实际文件。-t测试配置后退出,-f指定配置文件。这个命令不表示已把新文件加载到现有运行进程,也不能作为远端节点连接成功的凭据。构建资料页面无需运行代理或改变系统网络设置。
测试可能涉及配置引用的文件或资源,应先检查受信任的配置与工作目录。保留退出状态和错误内容,不要把演示输出冒充真实日志。若提示YAML解析失败,转到缩进、空格和列表检查;若指出找不到策略名称,逐字比较组定义与引用。
查看正在运行的那份配置
确认核心进程的启动方式、工作目录、配置参数与实际读取路径。某些客户端会生成运行时配置,手工编辑的原文件不一定就是最后加载的文件。记录活动配置标识和加载时间,避免只检查编辑器里那一份副本。
按实际客户端或服务支持的方式重新加载,查看是否成功以及是否继续保留旧配置。重载失败时不要只反复点击,应先读取首条有效错误。提供者文件不存在、路径权限不足、格式不符合预期或版本不支持字段,都需要按具体错误处理。
从一条新连接验证规则链
加载成功后再创建新连接,检查目标、命中规则、策略组当前选择和最终节点。已有连接可能不会因修改而重新匹配。规则仍不符合预期时,按由上到下的匹配顺序确认是否被更早的宽条件接管。
规则符合预期而连接失败,就把排查范围下移到节点、协议和目标服务。单个检测地址可达不代表全部业务都可用;保留错误类型与发生条件,换一个明确可对照的请求验证,避免对运行环境作无依据的结论。
留下一份可以恢复的记录
验证前备份配置和必要的来源文件,记录改动内容及测试对象。出现异常时恢复上一次已确认能加载的版本,重新核对活动路径,防止“回滚了文件却没回滚运行状态”。共享问题记录时隐藏节点凭据、订阅Token和认证信息。
当语法、字段、加载和连接分别有证据时,“检查通过却没生效”就会变成一个可定位的问题。只修复当前失败的那一层,再从这一层继续验证。


