配置详解

Mihomo 配置文件结构详解

YAML 配置的基础设置、proxies、proxy-groups、rules 四大块各管什么，改配置前先看懂它。

内容复核 · 2026年11月3日

适合谁

想看懂 YAML 配置文件结构，或在排查问题时需要对照配置的人。

1
顶层常见四块：proxies 节点列表、proxy-groups 策略组、rules 规则列表，以及 dns、mixed-port 这类基础设置。
2
proxies 定义节点：每条节点写协议类型、服务器地址、端口和凭据。这部分通常由订阅自动生成，不需要手写。
3
proxy-groups 定义策略组：select 手动选节点，url-test 自动选延迟最低的，fallback 故障转移。策略组把节点组织成规则引用的“入口”。
4
rules 决定流量走向：自上而下匹配，命中即停。常见写法是先放行局域网和直连域名，再按 GEOIP 分流，最后 MATCH 兜底交给策略组。
5
手改配置前先备份：缩进错误是 YAML 最常见的坑。改完用客户端的配置校验，或用最小配置启动验证。

九成是缩进用了 Tab 或层级错位。YAML 只认空格缩进，逐行对齐后重试。

先确认改的是当前选中的配置文件；订阅自动更新会用服务方的版本覆盖手改内容，自定义规则要确认订阅更新策略。

想了解规则里用到的协议名词，看协议科普那篇。