什么是Clash订阅?YAML配置文件架构、策略组与分流规则原理解析
在代理客户端的世界中,Clash 及其衍生的 Mihomo 内核之所以能够横扫多平台并成为事实上的行业基准,其核心驱动力正是这套设计严密、结构清晰的 YAML 格式订阅配置文件。它不仅定义了你可以使用的所有节点,还以极高自由度规定了每一条网络请求的流向。本文系统拆解一份规范 Clash 订阅的底层骨架。
一、Clash 订阅的技术本质
从技术定义上讲,一份标准的 Clash 订阅文件是一个符合 YAML 1.2 语法规范 的纯文本文件。
客户端向服务商给定的订阅 URL 发起 GET 请求后,服务端将该文件下发到本地。客户端在内存中对其进行语法解析,并构建起一张完整的路由转发状态表与节点健康检查队列。
理解订阅生成流程可参考专文:什么是Clash订阅链接?安全防盗用常识。
二、配置文件的四大核心顶层模块
一份标准的 Clash 配置文件由以下四大核心模块依次嵌套构成:
[全局基础设置 (Port, Mixed-Port, Mode, DNS)]
↓
[Proxies 节点列表 (具体的数十个代理服务器参数)]
↓
[Proxy Groups 策略组 (节点的组织容器与自动调度策略)]
↓
[Rules 分流规则列表 (从上至下的域名/IP分流判断树)]
1. 基础运行参数与 DNS 模块
port: 7890
socks-port: 7891
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
dns:
enable: true
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5
这一部分定义了客户端监听的本地端口、工作模式以及防污染 DNS 行为。深入的 DNS 配置细节可阅读Clash DNS污染与Fake-IP防泄露指南。
2. Proxies (节点列表)
这是整个机场的资产库,定义了所有可用服务器的底层参数:
proxies:
- name: "🇭🇰 香港 01 [IEPL专线]"
type: ss
server: hk01.entry.example.com
port: 443
cipher: 2022-blake3-aes-128-gcm
password: "UserSecretToken"
包含节点类型(Shadowsocks、Trojan、VLESS 等)、入口地址、端口与密钥凭证。
3. Proxy Groups (策略组)
策略组是 Clash 智能化分流的灵魂所在。它允许将多个节点打包成一个逻辑单元,赋予其动态调度能力:
- select (手动选择):由用户在 UI 界面上手动点选主力节点。
- url-test (自动低延迟优选):内核定期向测速 URL 发起握手探测,自动路由至延迟最低的节点。
- fallback (可用性容灾回退):按顺序优先使用首选节点,一旦失联自动切换至备用节点。
- load-balance (负载均衡):多连接分散并发。
4. Rules (分流规则树)
Clash 最强大的特性正是其精准的规则分流体系:
rules:
- DOMAIN-SUFFIX,google.com,PROXY
- DOMAIN-KEYWORD,openai,🤖 智能AI组
- DOMAIN-SUFFIX,bilibili.com,DIRECT
- GEOIP,CN,DIRECT
- MATCH,🐟 漏网之鱼
- 匹配机制:严格遵循自顶向下、首次命中优先 (First Match) 原则。
- 如果请求的网址是
bilibili.com,匹配到第三行规则直接判定为DIRECT直连,后续的GEOIP规则不再执行。
三、为什么直接手动修改订阅文件极易出错?
很多用户尝试用记事本手动编辑下载回来的订阅文件,随后便遭遇客户端弹窗报错 yaml: line xx: mapping values are not allowed:
- YAML 对缩进极其敏感:必须严格使用空格(Space)缩进,混入任何一个 Tab 制表符都会导致整份文件解析崩塌。
- 冒号后必须带有空格:例如
type: ss是合法的,但写成type:ss会直接抛出语法异常。 - 更新覆盖问题:若直接在远程订阅文件中修改,下次点击更新时,所有本地手工修改的内容都会被云端覆盖。正确做法是使用 Clash Verge Rev 的扩展 Merge 脚本进行无损覆写,详见Clash Verge Rev进阶教程。
四、总结与延伸指引
深入理解 Clash 订阅的结构,不仅能让你看懂客户端的各项工作逻辑,还能在遭遇更新异常时精准定位问题所在。如果更新订阅时提示语法报错,请参考Clash订阅更新失败与YAML解析错误解决。需要选购配置规范、策略组预设科学的优质机场,欢迎查阅本站的机场推荐总览与机场大全数据库。遇到疑难杂症,请随时访问常见故障排查。