Clash 配置文件入门:看懂 YAML 的 proxies 与 rules
订阅链接和配置文件是什么关系
在客户端里粘贴 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(拒绝)。示例里的三条依次是:
- 域名以 google.com 结尾的请求,交给「节点选择」组;
- 目标 IP 属于中国大陆的请求,直连;
MATCH是兜底规则,前面都没匹配上的请求,交给「节点选择」组。
规则从上往下逐条匹配,命中第一条就停止,后面的不再看。因此顺序很重要,MATCH 必须放在最后一行。
把三块连起来看一个请求的完整路径:访问 google.com 时,命中第一条规则,流量交给「节点选择」;这个组里你当前选中的如果是「自动选择」,就再由它挑出延迟最低的节点;最终流量从那个节点出去。
YAML 缩进的常见错误
YAML 用缩进表示层级,对格式非常敏感,多一个或少一个空格都可能让整份配置无法加载。常见错误如下:
| 错误 | 说明 | 正确做法 |
|---|---|---|
| 用 Tab 缩进 | YAML 不允许用 Tab 字符做缩进 | 一律用空格,通常每层两个空格 |
| 同一层级缩进不一致 | 同一个列表里的各项、同一个节点的各字段没有对齐 | 同级内容左边对齐 |
| 冒号后面没有空格 | 写成 port:443 不会被识别为键和值 |
写成 port: 443 |
| 短横线后面没有空格 | 列表项写成 -name |
写成 - name |
| 用了中文标点 | 全角的冒号、逗号、引号不是 YAML 语法 | 全部使用英文半角符号 |
| 含特殊字符的值没加引号 | 名字或密码里带冒号、井号等符号时会被误解析 | 用英文双引号把值包起来 |
| 引用了不存在的名字 | 代理组成员或规则去向写的名字与定义的不完全一致 | 名字逐字核对,包括空格和大小写 |
最后一种不是 YAML 语法错误,而是内容错误,但很常见:改了节点名却没同步改代理组,内核就会报找不到对应的代理。
排查时看客户端的日志或报错信息,里面一般会给出出错的行号或字段名,对着去找即可。常见报错的含义见Clash Verge 常见报错。
为什么一般不用手写
- 节点信息只能来自机场。 服务器地址、端口、密码都是机场分配的,而且会更换,自己写不出来也维护不了。
- 订阅更新会覆盖本地文件。 直接修改从订阅下载的配置,下一次自动更新就会被新文件整份替换,改动全部丢失。
- 规则体量大。 一套好用的分流规则涉及大量域名和 IP 段,机场和社区已经整理好了现成的规则集,手写既慢又容易遗漏。
- 出错成本高。 一个缩进错误就会让整份配置加载失败,表现为客户端启动报错、完全连不上。
确实需要自定义时,正确的做法是不动订阅文件本身,而是用客户端提供的扩展或覆写功能,把自己的规则合并到订阅之上,这样订阅更新后改动依然有效。具体操作见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日,未经本站实测,购买前请以官网为准。整理方法见这里。
接着读
安卓机场客户端对比:Clash Meta、v2rayNG、NekoBox、FlClash、Hiddify
安卓机场客户端对比:从内核、订阅格式、分应用代理和上手难度比较 Clash Meta for Android、v2rayNG、NekoBox、FlClash、Hiddify,说明安卓 Clash 客户端的安全下载渠道和新手建议。
Clash for Windows 停更后用什么替代:迁移步骤详解
Clash for Windows 停更说明:2023 年底已停止维护并删除原仓库,旧版不支持新协议、没有安全更新。本文对比 Clash for Windows 替代客户端,给出迁移到 Clash Verge Rev 的步骤。
Clash 规则分流与代理组入门:分流规则类型、四种代理组和指定节点的方法
Clash 规则与分流规则入门:解释规则模式如何从上到下匹配、DOMAIN-SUFFIX、GEOIP、MATCH 等规则类型,select、url-test 等四种代理组的区别,以及怎么给某个网站指定节点。
Clash Meta for Android 教程:安卓 Clash 导入订阅
Clash Meta for Android 教程新手版:讲清安卓 Clash 客户端的下载安装、新建配置导入机场订阅、启动与选节点、访问控制(分应用代理)、订阅自动更新,以及后台被杀、启动后没网等常见问题的处理办法。