独立运行内核时,可以在正式启用之前用 -t 检查配置。这个步骤能提前发现一些解析和引用问题,但不是网络健康检测,也不是对所有远程资源与业务的保证。
明确文件与工作目录
下面是 Windows PowerShell 示例,假设可执行文件与 mihomo-data 文件夹都在当前目录:
.\mihomo.exe -t -d .\mihomo-data -f .\mihomo-data\config.yaml-f 指定配置文件,-d 指定配置目录。请把路径替换为自己的实际位置。Linux 或 macOS 可对应使用 ./mihomo,并使用适合系统的路径写法。路径写对,比重复运行相同命令更重要。
读完整错误,不只看退出结果
如果报错提到行号,查看附近的结构与最近修改;如果提到不存在的策略,核对代理组引用;如果提到不支持的字段,检查内核版本。配置含远程资源时还可能发生资源解析或访问,不能把这条命令描述为绝对离线的检查。
检查成功后,不应把输出转换成“节点都能用”。节点服务、账户权限、规则资源更新与 DNS 路径仍需独立验证。图形客户端用户优先使用客户端内置的检查与日志,不必另起一套裸核来重复配置。
下一步验证一条真实请求
正式运行后,确认日志中的配置路径与预期一致,再通过当前代理入口发起请求。观察规则命中、代理组与出口,必要时同时核对目标响应。
如果检查通过但启动仍提示端口被占用,属于运行环境问题,不是 YAML 一定有错。先正常退出重复的客户端或内核,避免为了让检查成功而不断修改原本正确的配置。把语法、进程与联网结果分别记录,排错更容易收敛。