Clash config.yaml 逐段解析:端口、DNS、proxies 与 rules 怎么写
按顺序拆开一份完整配置文件,逐段讲清 mixed-port、dns、proxies、proxy-groups、rule-providers 与 rules 的作用和常见写法。
完整示例:先看配置项如何相互引用
这份样例面向支持内联规则集的 mihomo(原 Clash Meta),用域名规则和显式代理请求验证分流,不依赖订阅更新或 TUN。Clash 原版能识别部分同名字段,但不要把这份文件视为跨内核通用配置,尤其要先确认规则集类型是否受支持。
mixed-port: 7890
allow-lan: false
mode: rule
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
proxies:
- name: "本机 SOCKS5"
type: socks5
server: 127.0.0.1
port: 1080
proxy-groups:
- name: "办公出口"
type: select
proxies:
- DIRECT
- "本机 SOCKS5"
rule-providers:
office-domains:
type: inline
behavior: domain
payload:
- "+.example.org"
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- RULE-SET,office-domains,办公出口
- MATCH,DIRECT
一次请求从 mixed-port 进入后,内核在规则模式下按 rules 的顺序检查目标。命中 office-domains 时转到「办公出口」,再使用该组当前选中的出口。即使最终选了 DIRECT,规则仍然可以命中策略组;判断分流是否正确,要同时看命中的规则和实际出口。
mixed-port:区分本地入口与上游端口
mixed-port: 7890 让内核在同一个本地端口接收 HTTP 代理和 SOCKS5 代理连接。应用填的是 127.0.0.1:7890;proxies 里的 1080 则是内核选用示例节点后才会拨号的上游端口。一个是应用连内核,一个是内核连上游,两者不能互换。
allow-lan: false 对应本机使用场景。写下监听端口也不会替系统打开代理开关。只想验证某个应用时,先让该应用显式连接端口;需要接入不理会系统代理的应用时,再单独评估 TUN。TUN 通过虚拟网卡接管符合路由设置的流量,和应用主动连接 7890 走的是不同入口。
端口被占用时改哪里
如果日志提示 address already in use,先确认是否同时运行了第二个内核实例。若要改用 7891,还要把手动填写的浏览器代理、终端参数等一并改成 7891。桌面客户端可能覆写配置端口;诊断时以启动日志中的实际监听值为准。
dns:上游解析与 fake-ip 的区别
dns.enable: true 启用内核的 DNS 模块,nameserver 定义该模块用于常规解析的上游。本例使用 IP 为 223.5.5.5 的传统 DNS 服务,运行前应确认当前网络可达并符合本地网络的 DNS 要求。仅修改这一段不会把系统或浏览器的所有 DNS 查询都送进内核。浏览器自带的安全 DNS、应用显式代理和 TUN 的 DNS 接管需要分开判断。
enhanced-mode: fake-ip 下,符合条件的域名 A 查询可由内核返回临时映射地址。看到 198.18.0.0/16 范围内的地址,并不表示网站部署在该网段。后续连接需要由同一内核接住,才能按映射找回域名。使用 HTTP 代理访问 HTTPS 时,应用通常可直接在 CONNECT 请求里提供目标主机名,因此不必先看到一个 fake IP 才能命中域名规则。
局域网服务在启用 fake-ip 后打不开
先核对该域名是否经过内核解析,再检查同一应用的连接是否也经过内核。如果应用拿到了映射地址却绕开内核连接,单改 nameserver 通常解决不了。若确认该服务必须拿到真实地址,可在现有 dns 段加入 fake-ip-filter,例如精确排除 printer.home.arpa。同时要确保上游 DNS 能解析这个私有名称;过滤只改变返回地址的方式,不会替公共 DNS 增加局域网记录。
proxies 与 proxy-groups:节点和策略组分开维护
顶层 proxies 描述连接上游所需的参数。每个节点有名称、协议、服务器和端口,其他字段随协议变化。示例使用 type: socks5;换成其他协议时,不能只改 type 沿用旧字段。若节点来自订阅,先确认订阅是否已生成完整配置,还是由客户端通过 proxy-providers 加载节点列表。
proxy-groups 则声明路由可选的出口。组内的 proxies 列出名称,不重复写服务器地址;DIRECT 是内置直连策略。「办公出口」使用 select,由客户端手动选择,不会依据测速自动换节点。若节点来自命名的 proxy-providers,策略组可以用 use 引用提供器;不要把提供器名称误写成节点名称。
改名时按引用方向检查:把节点「本机 SOCKS5」改名后,要改组成员列表;把组「办公出口」改名后,要改规则目标。名称里多一个空格也是不同名称。对于会定期刷新的订阅,优先用客户端提供的覆写或合并功能保留本地改动;直接编辑订阅缓存,下一次刷新可能把改动覆盖。
rule-providers 与 rules:先备规则集,再决定出口
rule-providers 定义规则集合,本身不指定流量出口。示例的 office-domains 使用 behavior: domain,以 +.example.org 覆盖根域名及其子域名。真正的策略绑定发生在 RULE-SET,office-domains,办公出口;只定义规则集、不写这条引用,请求就不会通过这组规则进行匹配。
| behavior | 条目示例 | 用途 |
|---|---|---|
domain | +.example.org | 匹配指定域名及其子域名。 |
ipcidr | 192.0.2.0/24 | 匹配目标 IP 网段;这里使用文档示例网段。 |
classical | DOMAIN-SUFFIX,example.org | 保留规则类型,条目不追加策略组名称。 |
规则集拆成本地文件时,可将 type 改为 file,声明 format: yaml 和 path: ./rules/office.yaml,将原来的 payload 整段放入该 YAML 文件。相对路径按内核工作目录定位,不应假设它和客户端界面里显示的订阅文件同目录。远程更新则使用 type: http,设置 url 与以秒为单位的 interval,并让内容格式和 behavior 对得上。
规则优先级由列表顺序决定
规则模式下,内核从上到下检查 rules,采用第一条命中的策略。要让 status.example.org 始终直连,可把 DOMAIN,status.example.org,DIRECT 放在对应的 RULE-SET 前面。若放在后面,更宽泛的规则集已先命中,该例外就不会执行。MATCH 是无条件兜底,必须放在最后;将它的策略改成某个组,会改变所有未命中前序规则的请求。
配置校验:依次确认加载、入口和规则命中
- 检查文件是否能加载。使用空格缩进,同级键对齐;修改
dns等已有段时,在原段内合并,不在顶层写第二份同名键。有独立 mihomo 命令行时,可在样例所在目录运行mihomo -t -f ./config.yaml。校验通过只说明配置能被读取和验证,不代表上游已经连通。 - 确认请求进入正确的内核。加载配置并确认模式为规则,把「办公出口」选为
DIRECT。运行下方命令显式使用7890,避免把系统代理开关或浏览器扩展混入测试。若连接本地端口立即被拒绝,先看监听状态,不要先改 DNS。 - 对照两个目标的命中记录。查看客户端连接记录,必要时在日志中查找域名。
example.org应命中office-domains,经「办公出口」选择直连;example.com应直接命中第一条域名后缀规则。两次都能打开并不能证明规则写对,因为末尾的MATCH,DIRECT也能使请求直连。
curl --noproxy "" --proxy http://127.0.0.1:7890 --max-time 10 -I https://example.org/
curl --noproxy "" --proxy http://127.0.0.1:7890 --max-time 10 -I https://example.com/
以上命令适用于常见 Unix Shell;在 Windows 的 PowerShell 中应调用 curl.exe,并确认空字符串参数能传给程序。这里的 --noproxy "" 清除环境变量里可能存在的绕过列表,--max-time 10 给单次请求设置 10 秒总时限。
如果策略组命中正确,但切换到「本机 SOCKS5」后才失败,回查 1080 是否有服务监听,并核对上游协议和认证参数。若请求仍走了兜底,就核对当前生效的配置、目标是否以域名进入内核,以及是否被更靠前的规则截获。每次只改一个环节,再用同一域名重测,才能判断改动是否起效。