从文件本身开始
Mihomo配置文件使用YAML表达结构。保存为UTF-8,确认文件扩展名与实际读取路径。编辑器打开文件的位置,不一定就是核心的工作目录;客户端也可能生成另一份运行时配置。先核对活动文件,再讨论字段是否生效。
YAML不是Mihomo专属语言。对象用键值组织,列表用短横线表示,块结构用空格缩进。不要把Tab混入缩进;同一级键保持对齐,含特殊字符的字符串使用合适引号,注释不能破坏前面的值。缩进与层级手记给出了逐段定位语法错误的方法。
字段之间怎样连接
| 位置 | 负责的内容 | 检查重点 |
|---|---|---|
| 基础字段 | 运行模式、端口与日志等 | 值类型与实际运行环境 |
| proxies | 直接定义节点 | 协议字段与名称唯一性 |
| proxy-providers | 声明节点来源 | 类型、路径与内容格式 |
| proxy-groups | 组织候选与选择行为 | 名称引用和候选范围 |
| rules | 按顺序匹配请求 | 条件先后与目标策略 |
YAML · 演示片段,不用于真实连接
mode: rule
log-level: info
proxy-groups:
- name: "示例策略"
type: select
proxies:
- DIRECT
rules:
- MATCH,示例策略这段演示只展示基本层级,候选只有直连,不含真实代理连接信息。字段集合应随实际需求确定,不需要为了填满模板而添加不使用的功能。节点变多时,可以按来源管理方式拆分维护。
保存、验证、加载分开进行
保存只是把文字写入磁盘。先进行YAML语法检查,再核对Mihomo支持的字段和引用;之后按实际客户端或运行服务的方式重载,并查看结果。语法有效不能证明配置已经被运行进程读取。
若检查通过却行为不变,进入配置检查与核心加载排查核对路径和日志。新建连接后再查看规则匹配与策略选择,不要只以已有连接的表现判断修改结果。
常见错误,按层定位
- 解析器指向某一行
- 向上检查父级缩进、引号和上一行的冒号,不只修改提示行。
- 策略名称不存在
- 对照组名和引用处的大小写、空格及标点,避免只改了一处。
- 提供者文件读取失败
- 检查实际目录、文件权限、载荷格式与路径安全范围。
