Clash config.yaml 文件结构详解:端口、dns、proxies 到 rules 逐段读懂
按配置文件从上到下的顺序,解释通用端口、运行模式、dns、proxies、proxy-groups、rule-providers 与 rules 各段作用及常见写错位置。
通用端口与运行模式:先确认流量入口
判断配置是否生效,先看应用连接的是哪个入口,再看内核如何分流。下面以 mihomo 为准。旧版 Clash 与 mihomo 的字段支持范围不同;客户端版本也不等于内核版本。独立运行时可用 mihomo -v 查看内核版本,图形客户端则以其显示的内核信息为准。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
mixed-port 同时接受 HTTP 和 SOCKS 代理连接。按此例配置应用时,代理地址填 127.0.0.1,端口填 7890,协议按应用支持项选择。若配置使用独立的 port 和 socks-port,两项分别对应 HTTP 和 SOCKS,不要把 DNS 监听端口或控制接口端口填到应用代理栏。这里的 7890 是示例值,不是所有客户端的固定端口。
mode: rule按rules匹配;测试域名规则时先确认当前运行模式为 Rule。mode: global使用全局策略组的当前选择,不按普通规则列表分流。mode: direct让进入内核的连接直连;它不等于关闭系统代理,也不等于退出内核。
系统代理是否开启、应用是否遵循系统代理,是配置之外的问题。TUN 则通过虚拟网卡接管符合路由条件的流量,配置位于独立的顶层 tun 区段。修改 mixed-port 不会开启 TUN;开启 TUN 后,也不能仅凭浏览器能访问网页判断某个应用走了哪条路径。
dns:区分监听地址、上游与 Fake-IP
dns 是顶层映射。enable 开启内核 DNS 功能,listen 指定内核接收 DNS 查询的地址,nameserver 列出用于解析的上游。下面用回环地址上的 1053 做本机测试,避免将示例监听地址扩展到局域网。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
fake-ip-filter:
- localhost
- '*.lan'
在默认过滤模式下,匹配 fake-ip-filter 的域名不返回 Fake-IP,但这不代表它们一定能被上游解析,也不代表连接会直连。Fake-IP 是内核用于将连接关联回域名的地址映射;是否走代理仍由运行模式和规则决定。通配项 '*.lan' 需要引号,避免前导星号被 YAML 当作别名语法。
可以运行 nslookup -port=1053 example.com 127.0.0.1 单独检查监听端口。在这份示例中,未被过滤的 A 记录查询可得到配置网段内的 Fake-IP。这只验证查询抵达内核并收到应答,不证明系统 DNS 已切换,也不证明目标站点可以连接。若手动查询成功但应用表现不同,再检查应用自带的加密 DNS、系统缓存以及启用 TUN 时的 DNS 劫持设置。
proxies 与 proxy-groups:节点定义和策略选择分开
顶层 proxies 是出站节点列表。每项通常包含 name、type、server、port,其余参数由协议决定。节点的 port 指向远程服务,与本机的 mixed-port 无关。不要把订阅 URL 填进节点的 server:客户端可能把订阅转换成完整配置,而 mihomo 的 proxy-providers 则用于按配置加载节点集合。
顶层 proxy-groups 定义策略组。组内的 proxies 是候选项名称列表,不是节点对象列表;通过节点提供器引入候选项时,用组内的 use 引用提供器名称。先用只包含内置出站的组验证引用关系,无需填写节点凭据:
proxy-groups:
- name: Lab-Select
type: select
proxies:
- DIRECT
- REJECT
select 组采用当前选择。规则命中 Lab-Select 后,当前选择是 DIRECT 就直连,是 REJECT 就拒绝。测试前应在客户端确认组内选项,因为界面可能恢复上次记录的选择。把节点加入组时,复制节点的完整 name,核对大小写、空格和标点。重命名策略组后,也要同步修改引用该组的规则。
rule-providers:规则集定义不等于启用分流
rule-providers 提供匹配条件,不提供出站节点。在此处声明规则集只建立名称与内容的对应关系;还需要在 rules 写一条 RULE-SET,指定命中后使用的出站。先用内联规则集验证这一点,可以排除下载和缓存问题。
rule-providers:
lab-domains:
type: inline
behavior: domain
payload:
- '+.example.org'
behavior: domain读取域名条目,例如+.example.org;不在条目尾部指定策略组。behavior: ipcidr读取地址网段,例如192.0.2.0/24;不加IP-CIDR,前缀。behavior: classical读取带类型的条件,例如DOMAIN-SUFFIX,example.org;最终出站仍写在外层RULE-SET中。
改用 HTTP 提供器时,另行配置 type: http、url、本地缓存 path 和更新 interval。interval: 86400 表示 24 小时,单位是秒。format 要与资源实际格式一致,不能把返回登录页的链接当作规则文件,也不能靠更改扩展名把文本变成 MRS。图形客户端的内核工作目录可能不同于原始订阅文件所在目录;找缓存时先确认工作目录,再核对相对路径。
rules:按列表顺序匹配,不按具体程度排序
把下面的列表接到前面的配置中。rules、rule-providers、proxy-groups 与 dns 都是顶层键,彼此不缩进。内核从上到下检查规则,使用首条命中规则指定的策略,不会把更具体的域名条件自动提到前面。
rules:
- DOMAIN,example.org,DIRECT
- RULE-SET,lab-domains,Lab-Select
- MATCH,DIRECT
当连接的目标域名可供内核匹配时,example.org 先命中第一行;www.example.org 则命中规则集,交给 Lab-Select。若把规则集那一行移到完整域名规则之前,根域名也会被规则集接走。把 MATCH 写在前面,则后续规则没有匹配机会。测试时可在 Lab-Select 选择 REJECT,查看子域请求在连接日志中是否命中预期规则,而不要用示例站点是否实际提供网页作为判断依据。
配置报错与分流异常:按解析、加载、连接三层定位
- 先验证 YAML 和引用。 用空格缩进,保持同层键对齐。列表项用连字符,映射项用键值对。不要为了追加一条规则而再建一个顶层
rules;应追加到已有列表。独立运行时,可在配置目录用mihomo -t -f config.yaml测试配置;若客户端使用单独的工作目录,应按实际目录和配置文件测试。重点看第一条报错,先修结构,再修名称。 - 确认测试的是生效配置。 图形客户端可能合并订阅、覆写和本地偏好后再交给内核。原始文件能通过测试,并不说明运行中的配置包含同一条规则。查看当前启用的配置及客户端可见的合并结果,重新加载后确认模式、端口和策略组选择。
- 验证入口再追踪出站。 本文端口示例可用
curl --proxy http://127.0.0.1:7890 https://example.org/发起测试。若代理端口无法连接,先查监听是否启动或被占用;如果连接已经出现在日志中,则核对目标域名、命中的规则和最终出站。命中正确但请求仍失败时,再查 DNS 上游、所选出站或目标服务。
每次只改一个变量。先用 DIRECT、REJECT 和两条可区分的域名条件验证规则,再逐步换回订阅节点和远程规则集。这样出现异常时,可以判断问题来自本地入口、配置合并、规则数据还是具体出站。