看懂 Clash YAML 配置文件:七大核心区块速查与实战模板
虽然绝大多数日常用户直接导入机场订阅就能使用,但只要遇到配置报错、需要排查分流为什么漏判、或者准备自己写一套 Merge 覆写规则,看懂 YAML 配置文件的结构逻辑就能让您立刻从“盲目试错”升级到“精准定位”。
一、YAML 语法的三条生死线(新手改文件必看)
- 禁止使用 Tab 键:所有层级缩进必须使用半角空格(通常每级 2 个空格)。
- 冒号后必须保留半角空格:
mode: rule是正确的,写成mode:rule会直接解析失败。 - 含特殊字符的值加引号:如节点名包含冒号、井号或星号,必须写成
name: "香港专线 [IEPL]:01"。
二、现代 Mihomo 完整标准配置骨架(Annotated Template)
下面是一份经过精简注释的标准 Mihomo 配置结构,包含了 2026 年推荐开启的 DNS、Sniffer 与经典分流骨架:
yaml
# ================= 1. 基础运行参数 =================
mixed-port: 7897 # HTTP 与 SOCKS5 混合监听端口
allow-lan: false # 是否允许同局域网其他设备通过本机代理
mode: rule # rule(规则) / global(全局) / direct(直连)
log-level: info # 日志等级:silent / error / warning / info / debug
ipv6: false # 若宽带或节点不支持稳定 IPv6,建议关闭以防双栈超时
unified-delay: true # 开启统一真延迟测速算法,消除握手误差
# ================= 2. DNS 防泄露与 Fake-IP =================
dns:
enable: true
ipv6: false
enhanced-mode: fake-ip # 极速防污染模式;兼容问题时可改 redir-host
fake-ip-range: 198.18.0.1/16
default-nameserver:
- 223.5.5.5
- 119.29.29.29
nameserver:
- https://dns.alidns.com/dns-query
- https://doh.pub/dns-query
fake-ip-filter:
- "*.lan"
- "*.local"
- "time.*.com"
- "ntp.*.com"
# ================= 3. 域名嗅探(TUN 场景核心) =================
sniffer:
enable: true
sniff:
HTTP:
ports: [80, 8080-8880]
override-destination: true
TLS:
ports: [443, 8443]
QUIC:
ports: [443, 8443]
skip-domain:
- "Mijia Cloud"
- "+.push.apple.com"
# ================= 4. 节点清单 (Proxies) =================
proxies:
- name: "香港专线 01"
type: vless
server: hk01.example.com
port: 443
uuid: 00000000-0000-0000-0000-000000000000
tls: true
servername: hk01.example.com
network: ws
udp: true
- name: "美国原生 01"
type: hysteria2
server: us01.example.com
port: 443
password: "your-password"
sni: us01.example.com
# ================= 5. 策略分组 (Proxy Groups) =================
proxy-groups:
- name: "🚀 节点选择"
type: select
proxies:
- "♻️ 自动测速"
- "香港专线 01"
- "美国原生 01"
- name: "🤖 AI 工具"
type: select
proxies:
- "美国原生 01"
- "🚀 节点选择"
- name: "♻️ 自动测速"
type: url-test
proxies:
- "香港专线 01"
- "美国原生 01"
url: "https://cp.cloudflare.com/generate_204"
interval: 300
tolerance: 50
# ================= 6. 规则分流列表 (Rules) =================
rules:
# 6.1 AI 平台优先匹配美国组
- DOMAIN-SUFFIX,openai.com,🤖 AI 工具
- DOMAIN-SUFFIX,chatgpt.com,🤖 AI 工具
- DOMAIN-SUFFIX,anthropic.com,🤖 AI 工具
- DOMAIN-SUFFIX,claude.ai,🤖 AI 工具
# 6.2 局域网与国内域名/IP 直连
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- GEOSITE,cn,DIRECT
- GEOIP,CN,DIRECT,no-resolve
# 6.3 兜底规则:其余全部走主代理组
- MATCH,🚀 节点选择三、常见策略组类型(type)实战解析
| 策略组类型 | 工作行为说明 | 最佳应用场景 |
|---|---|---|
select | 手动选择固定使用哪一个节点或子分组 | 主分组(🚀 节点选择)、AI 与银行账号固定节点 |
url-test | 按 interval 秒定期并发测速并自动切换到延迟最低者 | 日常冲浪、4K 流媒体(注意设 tolerance: 50 防频繁来回抖动) |
fallback | 按列表顺序从上到下检测可用性,主节点挂了自动切备胎 | 主力机场 + 备用机场自动容灾切换 |
load-balance | 按轮询或一致性哈希把请求分散到多个节点 | 多线程大文件下载(严禁用于需登录的 AI/电商网站) |
四、Rules 规则中 no-resolve 参数的奥秘
细心的用户会发现 GEOIP,CN,DIRECT,no-resolve 后面常常跟着一个 ,no-resolve:
- 如果不加
no-resolve,当遇到一条域名规则尚未匹配的请求时,内核为了判断GEOIP,CN必须先在本地发起一次 DNS 解析拿到 IP,这在访问某些被国内运营商污染的海外域名时不仅拖慢速度,还可能拿到错误的假 IP 从而误判为DIRECT; - 加上
no-resolve后,只有目标本来就是纯 IP 请求,或者前面 DNS 已经解析出真实结果时才判断地理归属,纯海外域名直接跳过此条并交给后面的MATCH远端解析,速度与准确率大幅提升。
五、实战延伸
- 想把这套规则思维无痛应用到您订阅的机场配置里(不丢更新):阅读 Clash 订阅覆写实战:Merge 与 Script 指南。
- 遇到了 YAML 解析报错?查看 Clash 订阅与超时故障排查手册。