Clash YAML 配置文件详解:九个关键部分怎么看

玩 Clash 的人几乎都导入过机场订阅,却很少有人把订阅链接直接贴到浏览器地址栏里瞧瞧。打开后看到的不是乱码,而是一份 Clash YAML 配置文件:节点、策略组、分流规则、DNS 都写在这段文字里。你从机场买到的订阅,说到底就是它。

这份配置每一块管什么,哪些值得亲手改,读完就有数了。「连不上」「国内网站变慢」「我改的东西一更新就没了」这几类毛病,多半能自己找到原因。

一、订阅链接背后是什么

订阅链接指向机场按需生成的一段 YAML 文本。客户端(Clash Verge Rev、Clash Meta for Android、FlClash 等)会定期访问这个地址,拉下配置,覆盖本地那一份。

从这里可以推出三点:

  • 在机场后台点「重置订阅」,换掉的就是这段文本,节点和规则由机场来维护。
  • 本地的配置当然也能改,但下次更新订阅时默认会被整份顶掉。不少人纳闷「我改的怎么没了」,根子在这里,第七节会讲避免的办法。
  • 链接里的 token 相当于账号凭证,不要外传。

YAML 靠缩进和键值对来组织内容。Clash 的配置大体分成几块:顶层的全局设置,加上 proxies(节点)、proxy-groups(策略组)、rules(规则),以及 dns。

二、顶层字段:几个全局开关

配置文件开头那些顶格书写的字段,就是全局设置:

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: true
external-controller: 127.0.0.1:9090

下面列几个常用的:

  • mixed-port:本地混合端口,HTTP 与 SOCKS 共用一个,多数是 7890,系统代理指向的正是它。旧配置可能把 port 和 socks-port 分开写,作用是一样的。
  • allow-lan:是否让局域网里的其他设备(手机、平板)借这台电脑上网,默认 false。设成 true 以后,还可以配合 bind-address、lan-allowed-ips 限定哪些 IP 可以接入。
  • mode:默认值为 rule,另外还可选 global 和 direct;这三项在客户端中分别显示为「规则 / 全局 / 直连」。选择方法可参考《Clash 的规则、全局与直连模式有何不同》。
  • log-level:控制日志输出多寡,从最安静到最啰嗦分别是 silent、error、warning、info、debug。要追查故障就拨到 debug,每条连接匹配的规则和最终出口节点都会写进日志。
  • ipv6:是否处理 IPv6 流量,默认开启。
  • external-controller:内核 RESTful API 的监听地址。你在客户端界面上点的那些按钮,其实都是通过这个 API 去控制内核的。给它设一个 secret,就等于加了一道密码。

配置中的端口应以自己的客户端设置为准。

三、proxies:节点由哪些字段构成

proxies 是个数组,每个节点占一项。一个节点至少得有 name、type、server、port 四项:

proxies:
  - name: "香港 01"
    type: ss
    server: hk1.example.com
    port: 443
    udp: true
  • name:节点名称,必填,不可重名。客户端节点列表里显示的就是它。
  • type:协议类型,常见的有 ss、vmess、vless、trojan、hysteria2。
  • server:服务器地址,写域名或 IP 皆可。
  • port:端口号。
  • udp:是否允许 UDP 经过该节点,默认 false。游戏、语音通话以及 QUIC(如今许多网站都在用)都依赖 UDP,有的节点要明确打开才行。
  • ip-version:出站时用 IPv4 还是 IPv6,可填 dual、ipv4、ipv6、ipv4-prefer、ipv6-prefer;只有节点服务器域名带有 IPv6 解析时才有意义。
  • tfo:TCP Fast Open,仅对 TCP 协议有效。
  • mptcp:多路径 TCP,大部分人用不上。
  • dialer-proxy:让该节点经由另一个节点或策略组去建立连接,即「前置代理」。旧配置里的 relay(节点串联)已被弃用,现在建议改用它。
  • smux:多路复用,把多条连接并到一条 TCP 里,减少握手开销,线路丢包多或高峰拥挤时可以考虑。

各协议另有专属字段:vmess 带 uuid、alterId、cipher,vless 带 uuid、flow,trojan 带 password。它们基本无需手写,机场订阅里早已填好。要读懂一个节点,认得 name、type、server、port 这四项就足够。

四、proxy-groups:策略组是关键

规则最后指向的是策略组,而非某个具体节点。策略组把一批节点(也可以是别的策略组)归拢到一起,主要分四种类型:

proxy-groups:
  - name: "自动选择"
    type: url-test
    url: "https://www.gstatic.com/generate_204"
    interval: 300
    proxies:
      - "香港 01"
      - "日本 02"
  • select:手动指定一个,用得最多,界面上能下拉切换的那个组就是它。
  • url-test:依据 url 和 interval 定期测试,自动选延迟最小的节点。tolerance 是切换容差(毫秒),比如填 50,就表示新节点的延迟要比当前的低出这个数值以上才会切换,免得延迟稍有波动就来回跳。
  • fallback:当前节点不可用时,按列表顺序切到下一个能用的。
  • load-balance:负载均衡。strategy 可选 round-robin(请求轮流分给各节点)、consistent-hashing(目标地址相同则固定走同一节点)、sticky-sessions(来源加目标相同则固定同一节点,缓存 10 分钟)。

再看几个常用字段:

  • url:用于健康检查,常见地址为 generate_204,即返回 204 的空白页面。
  • interval:检查的间隔,单位为秒,填 0 即不自动检查。
  • lazy:默认 true,该组没被选用时不做检查,节省资源。
  • timeout:健康检查的超时时间,单位毫秒。
  • filter / exclude-filter:用正则表达式筛选节点,是最实用的一招。机场订阅动辄给出几百个节点,写上 filter: "港|HK|hongkong",一个组就自动只剩香港节点,不必逐个手挑。

五、rules:分流规则怎样匹配

规则自上而下逐条比对,哪条先命中就按哪条处理,后面的不再看,所以先后次序很重要。列表末尾通常有一条 MATCH 作兜底,接住所有没被前面规则命中的流量。

rules:
  - DOMAIN-SUFFIX,google.com,PROXY
  - DOMAIN-KEYWORD,netflix,PROXY
  - GEOSITE,youtube,PROXY
  - GEOIP,CN,DIRECT
  - IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
  - MATCH,PROXY

下面是最常见的规则类型:

  • DOMAIN:完整域名的精确匹配。
  • DOMAIN-SUFFIX:按域名后缀匹配。google.com 可以匹配 www.google.com 和 mail.google.com,但匹配不到 content-google.com。
  • DOMAIN-KEYWORD:按域名中含有的关键字匹配。
  • GEOSITE:匹配 geosite 集合中的域名,例如 youtube、netflix、gfw。这些集合是社区整理的域名清单,随规则集一起更新。
  • GEOIP:依据 IP 所属国家匹配,GEOIP,CN 的意思就是国内 IP 直连。
  • IP-CIDR:匹配一个 IP 段。
  • PROCESS-NAME:通过进程名称匹配流量。例如在 Windows 中填入 chrome.exe,便可针对该程序单独控制流量。
  • MATCH:兜底规则,匹配全部。

容易踩坑的是 no-resolve。IP 类规则(IP-CIDR、GEOIP 等)默认会先做一次 DNS 解析,把域名变成 IP 再判断是否命中。加上 no-resolve 就跳过这一步,既省时间,也避免拿到被污染的结果;这个参数只有针对目标 IP 的规则才支持。

另一个是顺序:若把 GEOIP,CN,DIRECT 放在最前面,后面所有域名规则都会失效,因为流量还没轮到域名判断,就已经被「这个 IP 在不在中国」拦截了。因此机场的配置通常把 GEOIP,CN 放在靠后的位置。

六、DNS:防污染与 fake-ip

Clash 自带一套 DNS 处理逻辑,这是它与普通系统代理最大的不同之一。弄懂它,很多「规则明明写对了却打不开」的怪事就有了解释。

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - https://doh.pub/dns-query
    - https://dns.alidns.com/dns-query
  fallback:
    - tls://8.8.4.4
    - tls://1.1.1.1
  fallback-filter:
    geoip: true
    geoip-code: CN
  • enable:是否启用内核自带的 DNS,false 则使用系统 DNS。
  • enhanced-mode:可选 redir-host(默认)或 fake-ip。fake-ip 是 Clash 的特色做法:对需要代理的域名先给出一个假的保留地址(198.18.x.x 网段),真正的解析推迟到建立连接的那一刻。好处是省下一次 DNS 查询,也不会把你想访问什么泄露给本地 DNS。
  • nameserver:国内 DNS,用来解析国内的域名。
  • fallback:境外 DNS(8.8.4.4、1.1.1.1),用来解析境外的域名。
  • fallback-filter:决定某个域名究竟该采信 nameserver 还是 fallback。配上 geoip: true 与 geoip-code: CN,意思是:国内 DNS 给回的若是中国 IP 就采用;不是中国 IP(可能被污染了)就改用 fallback 的结果。

背后的道理是:国内运营商的 DNS 碰到某些境外域名,会给出错误的 IP,这就是污染。Clash 同时询问国内和境外 DNS,国内给的答案看着不像中国 IP,就说明有问题,转而采用境外 DNS 的答案。

使用 fake-ip 要留意:开启后 DNS 返回的是假 IP,局域网设备互访、依赖真实 IP 的内网服务可能出毛病。办法是把这些域名加进 fake-ip-filter 排除,比如 *.lan。

七、用 provider 避免订阅更新冲掉自己的改动

更新订阅默认整份覆盖本地配置。想一边沿用机场的节点,一边保住自己写的策略组与规则,就要用 provider。

proxy-providers:
  my-airport:
    type: http
    url: "https://机场域名/api/v1/client/subscribe?token=xxx"
    interval: 3600

proxy-providers 把机场订阅当作一个「代理集合」动态载入,更新时只刷新这个集合,你写的 proxy-groups 和 rules 原封不动。rule-providers 的思路相同:规则集单独放在一个文件或 URL 上,用 RULE-SET 引用,规则就能独立更新。

刚入门的话,直接用机场给的整份订阅最省事。想深入、自己写规则时,再把节点放进 proxy-provider,策略组与规则留在本地,两边就互不干扰了。

八、修改配置前后要做的事

  1. 去哪里改:多数客户端都提供编辑配置的入口。Clash Verge Rev 在 Profiles 页,配置旁边有个编辑按钮。动手前先复制一份当备份,改坏了还能退回去。
  2. 最常见的坑是缩进。YAML 靠缩进划分层级,空格和 Tab 混用,或者多一格少一格,都会直接报错。用客户端自带的编辑器要比记事本稳当,至少不会把 Tab 藏起来。
  3. 如何确认改对了:客户端保存后多半会自动重载,语法有误的行号会在报错里提示。改好后先试试节点延迟,再实际打开几个网站确认,不要只盯着延迟数字。

导入本地配置,需要把类型设为 Local,再加载自己的 YAML 文件;界面布局可能随版本略有变化。

九、常见问题

问:订阅链接打开是一大堆文字,这正常吗?

正常。那就是配置文件本身,节点与规则都在里面。

问:配置一更新订阅就没了,为什么?

更新订阅默认整份覆盖本地。要么按第七节,用 proxy-providers、rule-providers 把节点与自定义内容分开,要么不去碰机场那份订阅,自己另建一份配置文件。

问:规则模式打不开某个网站,全局模式却可以,是节点坏了吗?

节点本身多半没坏。更可能是规则压根没匹配上,或者策略组指向了别处。先把 log-level 改成 debug,在日志里追踪这条连接最终落在哪条规则、被送去哪个节点。

问:开了 fake-ip 之后,局域网设备访问不了怎么办?

在 fake-ip-filter 里加上内网域名(例如 *.lan),让它们走真实解析。

小结

拿到一份 Clash YAML,先记住四个板块各自的职责:节点归 proxies,策略组归 proxy-groups,分流归 rules,解析归 dns。弄清这四处,连不上、速度慢、国内站点绕去代理这类状况大多可以自行判断,没必要一出事就重装客户端。

还可阅读:Clash 的规则、全局与直连模式有何不同、如何排查 Clash 订阅无法更新的问题

字段的可选值和协议上的限制,以 Mihomo 配置手册为准,逐项对照即可。上面的零散片段只用来说明字段含义,拼不出一份能直接运行的完整配置。