Skip to content
Clash 客户端 · 配置参考数据核实与更新:2026-11-20正文约 3,004 字 · 预计阅读 7 分钟
核心结论(Answer-First)

一份现代 Mihomo (Clash.Meta) YAML 配置文件由基础运行参数、DNS 引擎、Sniffer 嗅探器、Proxies(节点清单)、Proxy-Groups(策略分组)、Rule-Providers(远程规则集)和 Rules(自上而下的分流路由表)七个主要区块构成。排查 YAML 报错时 90% 是缩进空格(必须用 2 空格而非 Tab)或策略组引用名拼写不一致所致。

看懂 Clash YAML 配置文件:七大核心区块速查与实战模板 ​

虽然绝大多数日常用户直接导入机场订阅就能使用,但只要遇到配置报错、需要排查分流为什么漏判、或者准备自己写一套 Merge 覆写规则,看懂 YAML 配置文件的结构逻辑就能让您立刻从“盲目试错”升级到“精准定位”。

一、YAML 语法的三条生死线(新手改文件必看) ​

  1. 禁止使用 Tab 键:所有层级缩进必须使用半角空格(通常每级 2 个空格)。
  2. 冒号后必须保留半角空格:mode: rule 是正确的,写成 mode:rule 会直接解析失败。
  3. 含特殊字符的值加引号:如节点名包含冒号、井号或星号,必须写成 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 远端解析,速度与准确率大幅提升。

五、实战延伸 ​