进阶配置

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 是示例值,不是所有客户端的固定端口。

系统代理是否开启、应用是否遵循系统代理,是配置之外的问题。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'

改用 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,查看子域请求在连接日志中是否命中预期规则,而不要用示例站点是否实际提供网页作为判断依据。

配置报错与分流异常:按解析、加载、连接三层定位

  1. 先验证 YAML 和引用。 用空格缩进,保持同层键对齐。列表项用连字符,映射项用键值对。不要为了追加一条规则而再建一个顶层 rules;应追加到已有列表。独立运行时,可在配置目录用 mihomo -t -f config.yaml 测试配置;若客户端使用单独的工作目录,应按实际目录和配置文件测试。重点看第一条报错,先修结构,再修名称。
  2. 确认测试的是生效配置。 图形客户端可能合并订阅、覆写和本地偏好后再交给内核。原始文件能通过测试,并不说明运行中的配置包含同一条规则。查看当前启用的配置及客户端可见的合并结果,重新加载后确认模式、端口和策略组选择。
  3. 验证入口再追踪出站。 本文端口示例可用 curl --proxy http://127.0.0.1:7890 https://example.org/ 发起测试。若代理端口无法连接,先查监听是否启动或被占用;如果连接已经出现在日志中,则核对目标域名、命中的规则和最终出站。命中正确但请求仍失败时,再查 DNS 上游、所选出站或目标服务。

每次只改一个变量。先用 DIRECT、REJECT 和两条可区分的域名条件验证规则,再逐步换回订阅节点和远程规则集。这样出现异常时,可以判断问题来自本地入口、配置合并、规则数据还是具体出站。

Clash下载