Mihomo / 配置入门

Mihomo YAML配置入门:文件结构、缩进规则与基础字段理解

先把一份配置当作有层级的文件来阅读。明确每个字段属于哪里、引用了谁,再决定怎样修改。

层叠工程图纸、描图纸与精密标注尺
层叠工程图纸、描图纸与精密标注尺

从文件本身开始

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支持的字段和引用;之后按实际客户端或运行服务的方式重载,并查看结果。语法有效不能证明配置已经被运行进程读取。

若检查通过却行为不变,进入配置检查与核心加载排查核对路径和日志。新建连接后再查看规则匹配与策略选择,不要只以已有连接的表现判断修改结果。

常见错误,按层定位

解析器指向某一行
向上检查父级缩进、引号和上一行的冒号,不只修改提示行。
策略名称不存在
对照组名和引用处的大小写、空格及标点,避免只改了一处。
提供者文件读取失败
检查实际目录、文件权限、载荷格式与路径安全范围。