客户端

Clash 配置文件入门:看懂 YAML 的 proxies 与 rules

更新于 · 约 16 分钟读完 · 登机口编辑整理

订阅链接和配置文件是什么关系

在客户端里粘贴 Clash 订阅链接,客户端做的事情就是访问这个链接,下载一份文本文件并保存到本地。这份文件就是配置文件,内核启动时读取它,照里面写的内容工作。

所以「订阅」和「配置文件」说的是同一个东西的两面:订阅是获取方式,配置文件是拿到的内容。客户端订阅页里的每一张卡片,背后都对应一份这样的文件,多数电脑端客户端可以在卡片的菜单里打开它查看。

这套格式最初由 Clash 内核定义,现在主流的 mihomo 内核沿用并扩展了它,背景见mihomo 内核是什么。

配置文件的五个主要部分

部分 写的是什么 谁来决定
基础设置 本地监听端口、运行模式、日志级别等 订阅里有默认值,客户端的设置通常会覆盖它
dns 域名怎么解析 订阅或客户端
proxies 每一个节点的连接参数 机场
proxy-groups 把节点组织成若干个组,以及组内的选择方式 机场预设,用户在界面里点选
rules 什么流量交给哪个组,或者直连、拒绝 机场预设,可自行扩展

除了这五块,实际的订阅里还常见 proxy-providers 和 rule-providers,它们把节点列表或规则列表放在外部文件里引用,是 proxies 和 rules 的另一种组织方式。

一份极简的示意配置

下面是一份能说明结构的最小配置。节点的服务器地址和密码都是占位符,不能直接使用:

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - 223.5.5.5
    - 119.29.29.29

proxies:
  - name: "香港 01"
    type: ss
    server: hk.example.com
    port: 443
    cipher: aes-128-gcm
    password: "password-placeholder"
  - name: "日本 01"
    type: trojan
    server: jp.example.com
    port: 443
    password: "password-placeholder"

proxy-groups:
  - name: "节点选择"
    type: select
    proxies:
      - "自动选择"
      - "香港 01"
      - "日本 01"
  - name: "自动选择"
    type: url-test
    proxies:
      - "香港 01"
      - "日本 01"
    url: "http://www.gstatic.com/generate_204"
    interval: 300

rules:
  - DOMAIN-SUFFIX,google.com,节点选择
  - GEOIP,CN,DIRECT
  - MATCH,节点选择

真实的订阅比这长得多,节点有几十上百个,规则有成百上千条,但骨架完全一样。下面逐块说明。

逐块看懂

基础设置

  • mixed-port:本地监听端口,HTTP 和 SOCKS 两种代理共用这一个端口。给终端或其他软件手动设置代理时,填的就是本机地址加这个端口号。
  • allow-lan:是否允许局域网内的其他设备通过这台电脑的代理端口上网。不需要共享时保持 false。
  • mode:运行模式,rule 是按规则分流,global 是全部走代理,direct 是全部直连,对应客户端界面上的三种模式。
  • log-level:日志的详细程度。

这几项在图形客户端的设置页里都有对应的开关,而且客户端的设置通常优先于订阅里的值。所以想改端口,去设置页改,不要去改配置文件。

dns

这一块决定域名由谁解析、用什么方式解析。示例里的 enhanced-mode: fake-ip 是目前常见的一种模式,nameserver 下面列的是用来解析域名的 DNS 服务器。DNS 设置不当会造成网页打不开、分流不准等问题,但它细节较多,单独写在Clash DNS 设置里。新手使用机场或客户端给的默认值即可。

proxies

节点列表,每个节点是以短横线开头的一项。各字段的含义:

  • name:节点的名字,就是界面上显示的那个。它同时是这个节点在整份配置里的唯一标识,后面的代理组通过名字引用它,所以不能重名;
  • type:协议类型,示例里的 ss 是 Shadowsocks,trojan 是 Trojan;
  • server 和 port:节点服务器的地址和端口;
  • 其余字段随协议不同而不同,比如加密方式、密码或用户标识、传输层和 TLS 相关的参数。

节点的全部信息都由机场提供,协议不同字段差别很大,没有必要去记。这一段内容等同于账号凭证,截图或分享配置文件时要注意不要泄露。

proxy-groups

代理组把节点组织起来,并规定组内怎么选。每个组有名字、类型和成员列表:

  • 示例里的「节点选择」类型是 select,由用户在界面上手动点选;
  • 「自动选择」类型是 url-test,内核每隔 interval 指定的秒数访问一次 url 指定的测试地址,自动使用延迟最低的成员。

注意「节点选择」的成员里包含了「自动选择」这个组,也就是说组可以嵌套组。客户端代理页里一层套一层的分组,就是这么来的。组的类型还有故障转移、负载均衡等,各自的用法见Clash 规则分流。

rules

规则一行一条,格式是「匹配类型,匹配内容,去向」。去向可以是某个代理组的名字,也可以是内置的 DIRECT(直连)和 REJECT(拒绝)。示例里的三条依次是:

  1. 域名以 google.com 结尾的请求,交给「节点选择」组;
  2. 目标 IP 属于中国大陆的请求,直连;
  3. MATCH 是兜底规则,前面都没匹配上的请求,交给「节点选择」组。

规则从上往下逐条匹配,命中第一条就停止,后面的不再看。因此顺序很重要,MATCH 必须放在最后一行。

把三块连起来看一个请求的完整路径:访问 google.com 时,命中第一条规则,流量交给「节点选择」;这个组里你当前选中的如果是「自动选择」,就再由它挑出延迟最低的节点;最终流量从那个节点出去。

YAML 缩进的常见错误

YAML 用缩进表示层级,对格式非常敏感,多一个或少一个空格都可能让整份配置无法加载。常见错误如下:

错误 说明 正确做法
用 Tab 缩进 YAML 不允许用 Tab 字符做缩进 一律用空格,通常每层两个空格
同一层级缩进不一致 同一个列表里的各项、同一个节点的各字段没有对齐 同级内容左边对齐
冒号后面没有空格 写成 port:443 不会被识别为键和值 写成 port: 443
短横线后面没有空格 列表项写成 -name 写成 - name
用了中文标点 全角的冒号、逗号、引号不是 YAML 语法 全部使用英文半角符号
含特殊字符的值没加引号 名字或密码里带冒号、井号等符号时会被误解析 用英文双引号把值包起来
引用了不存在的名字 代理组成员或规则去向写的名字与定义的不完全一致 名字逐字核对,包括空格和大小写

最后一种不是 YAML 语法错误,而是内容错误,但很常见:改了节点名却没同步改代理组,内核就会报找不到对应的代理。

排查时看客户端的日志或报错信息,里面一般会给出出错的行号或字段名,对着去找即可。常见报错的含义见Clash Verge 常见报错。

为什么一般不用手写

  1. 节点信息只能来自机场。 服务器地址、端口、密码都是机场分配的,而且会更换,自己写不出来也维护不了。
  2. 订阅更新会覆盖本地文件。 直接修改从订阅下载的配置,下一次自动更新就会被新文件整份替换,改动全部丢失。
  3. 规则体量大。 一套好用的分流规则涉及大量域名和 IP 段,机场和社区已经整理好了现成的规则集,手写既慢又容易遗漏。
  4. 出错成本高。 一个缩进错误就会让整份配置加载失败,表现为客户端启动报错、完全连不上。

确实需要自定义时,正确的做法是不动订阅文件本身,而是用客户端提供的扩展或覆写功能,把自己的规则合并到订阅之上,这样订阅更新后改动依然有效。具体操作见Clash Verge 进阶设置。如果机场给的不是 Clash 格式,需要的是转换而不是手写,见订阅转换教程。

订阅里其他常见的字段

真实的订阅文件开头往往比示意配置多出十几行。它们大多是内核的行为开关,不影响理解主体结构,但看到时知道大概意思会安心一些。

字段 含义
port、socks-port 分别单独开一个 HTTP 端口和 SOCKS 端口;和 mixed-port 是并列关系,可以只写其中一种
external-controller 内核对外提供的控制接口地址,图形客户端和网页控制面板通过它切换节点、读取连接
secret 访问上述控制接口的口令
ipv6 是否处理 IPv6 流量
unified-delay 改变延迟的计算口径,让不同协议的节点延迟更有可比性
tcp-concurrent 域名解析出多个地址时同时尝试连接,用最先连上的那个
find-process-mode 是否查找发起连接的程序名,按进程分流的规则依赖它
profile 是否记住你在各个组里手动选过的节点,重启后不用重选
tun TUN 模式的参数
sniffer 域名嗅探,从流量里识别出目标域名,帮助规则在拿不到域名时也能匹配

这些字段有的属于 mihomo 内核的扩展,旧的原版内核不认识。这也是为什么同一份订阅在停更的旧客户端里可能报错。

有两项要特别留意。external-controller 如果监听在所有网络接口上而又没有设置 secret,同一局域网里的其他设备就能控制你的内核,公共网络下有风险;图形客户端通常会自行处理这两项,不要手动把它改成对外开放。tun 一段一般也不需要自己写,客户端设置页里的 TUN 开关会在加载配置时把对应内容补进去。

proxy-providers 和 rule-providers 长什么样

前面提到这两个字段是 proxies 和 rules 的另一种组织方式。它们的共同点是:内容不直接写在配置里,而是给出一个地址,由内核定时下载。

proxy-providers:
  airport-a:
    type: http
    url: "https://example.com/sub"
    path: ./providers/airport-a.yaml
    interval: 3600
    health-check:
      enable: true
      url: "http://www.gstatic.com/generate_204"
      interval: 300

proxy-groups:
  - name: "节点选择"
    type: select
    use:
      - airport-a

这段的意思是:定义一个名叫 airport-a 的节点集,每隔 3600 秒从 url 下载一次节点列表并存到 path;health-check 让内核定时给这批节点测延迟。下面的代理组不再用 proxies 逐个列出节点名,而是用 use 把整个节点集拿进来。

这种写法的用处是把「节点从哪来」和「怎么分组、怎么分流」拆开。自己维护一份包含分组和规则的配置,节点交给 proxy-providers 去拉取,机场换节点时不用动自己的配置。想把两家机场的节点放进同一份配置,也是靠它:定义两个节点集,在代理组的 use 里都写上。

rule-providers 同理,定义的是规则集,在 rules 里用 RULE-SET 引用,写法和示例见Clash 规则分流。

要注意的是,下载地址访问失败时,内核会沿用上一次保存在本地的文件;如果本地还没有文件,这一组就是空的,引用它的代理组也会没有成员可选。看到某个组里一个节点都没有,可以到客户端里查看外部资源的更新状态。

常见问题

Clash 配置文件在哪里可以看到?

电脑端的客户端一般可以在订阅页里,通过订阅卡片的菜单打开或编辑对应的文件,也可以打开客户端的配置目录直接查看。注意里面包含节点的完整连接信息,不要把文件或截图发给别人。

可以直接修改订阅下载的配置文件吗?

技术上可以,但改动保留不住。订阅每次更新都会用机场下发的新文件替换本地文件。想让修改长期有效,要用客户端的扩展配置或覆写功能,而不是直接改原文件。

配置文件报错、加载失败怎么办?

如果文件是直接从订阅下载的、没有改过,先更新客户端到最新版,因为常见原因是订阅里用了旧内核不认识的协议或字段;再重新更新一次订阅,排除下载不完整。如果是自己改过之后报错,按日志提示的位置检查缩进、标点和名字引用,或者撤销修改恢复原样。

proxies 和 proxy-groups 有什么区别?

proxies 是一个个具体的节点,写的是怎么连接到某台服务器。proxy-groups 是对节点的编排,写的是这些节点归到哪些组、组内手动选还是自动选。规则指向的通常是组而不是单个节点,这样换节点时只需要在组里点一下,不用改规则。

代理组之间可以互相引用吗?

可以单向嵌套,比如手动选择组的成员里包含一个自动选择组。但不能形成环,也就是甲组引用乙组、乙组又引用甲组,这种配置内核会拒绝加载并报错。自己改代理组时注意引用方向保持单向。

配置文件里的 tun 段需要自己写吗?

用图形客户端的话不需要。设置页里的 TUN 模式开关会在加载配置时自动写入对应内容,而且优先于订阅里的值。只有直接运行内核、不用图形界面时,才需要在配置文件里手写这一段。

想把两家机场的节点合在一份配置里,该怎么做?

思路是用 proxy-providers 把两家的订阅各定义成一个节点集,再在代理组里用 use 同时引用。这需要自己维护一份包含分组和规则的配置,适合已经熟悉配置结构的人。只是想两家轮换着用的话,在客户端里导入两份订阅、需要时切换,更简单也更不容易出错。

看懂结构之后,想进一步了解规则类型和四种代理组怎么用,接着读Clash 规则分流;订阅的导入和更新见订阅导入与更新教程。

本文中的套餐与价格整理自公开资料,核对日期为 2026年11月14日,未经本站实测,购买前请以官网为准。整理方法见这里。

接着读