Clash 配置文件详解:config.yaml 每一部分是什么意思
机场订阅下载下来就是一份 YAML 格式的配置文件。看懂它,就能理解 Clash 在做什么,也方便排查问题。日常使用不需要手改,客户端的设置界面会帮你改。
整体结构
一份配置文件大致分成这几块:
| 部分 | 作用 |
|---|---|
| 基础设置 | 端口、模式、日志、局域网访问等 |
| dns | DNS 解析方式 |
| tun | 虚拟网卡模式 |
| proxies | 节点列表 |
| proxy-groups | 策略组(节点分组) |
| rule-providers | 外部规则集(可选) |
| rules | 分流规则 |
基础设置
mixed-port: 7890 # HTTP 和 SOCKS5 共用的端口
allow-lan: false # 是否允许局域网其他设备连接
bind-address: "*"
mode: rule # rule 规则 / global 全局 / direct 直连
log-level: info # 日志级别:silent / error / warning / info / debug
ipv6: false
external-controller: 127.0.0.1:9090 # 控制接口,网页面板和客户端用
secret: "" # 控制接口密码,开放到局域网时一定要设置
unified-delay: true # 统一延迟计算方式,测速结果更准
tcp-concurrent: true # 同时尝试多个 IP,加快连接
不同客户端默认端口不一样,比如 Clash Verge Rev 默认 7897,以客户端设置里显示的为准。
tun
tun:
enable: true
stack: mixed # system / gvisor / mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
客户端里的「虚拟网卡模式」开关,改的就是这里的 enable。原理见TUN 模式教程。
proxies:节点
proxies:
- name: "香港 01"
type: ss
server: hk01.example.com
port: 443
cipher: 2022-blake3-aes-128-gcm
password: "xxxx"
每个节点包含名称、协议类型、服务器地址、端口和认证信息。这部分由机场生成,不要外泄。各协议的区别见代理协议科普。
proxy-groups:策略组
proxy-groups:
- name: 节点选择
type: select
proxies: [自动选择, 香港 01, 日本 01, DIRECT]
- name: 自动选择
type: url-test
url: https://www.gstatic.com/generate_204
interval: 300
proxies: [香港 01, 日本 01]
select 手动选,url-test 自动选延迟最低的。详见策略组教程。
rule-providers:规则集
rule-providers:
ai:
type: http
behavior: classical
url: https://example.com/ai.yaml
path: ./rules/ai.yaml
interval: 86400
把一大批规则放在外部文件里,按时自动更新,配置文件更简洁。
rules:分流规则
rules:
- RULE-SET,ai,节点选择
- GEOSITE,cn,DIRECT
- GEOIP,CN,DIRECT
- MATCH,节点选择
从上往下匹配,命中即停。写法见规则分流教程。
改配置的正确方式
订阅更新会覆盖整份文件,所以:
- 改端口、模式、TUN、局域网:用客户端的设置界面;
- 加规则、改 DNS:用客户端的覆写功能(Clash Verge Rev 的全局扩展配置、Clash Party 的覆写);
- 完全自己写配置:新建一个本地配置文件,而不是修改订阅。
常见问题
YAML 格式报错怎么办?
YAML 对缩进非常敏感,必须用空格,不能用 Tab;同一层级的缩进要一致;冒号后面要有空格。可以先在在线 YAML 校验工具里检查格式(注意不要粘贴含节点密码的内容)。
external-controller 有安全风险吗?
默认只监听 127.0.0.1,只有本机能访问,没有风险。如果改成 0.0.0.0 开放给局域网,一定要设置 secret,否则同一网络里的人都能控制你的 Clash。