Clash 配置文件详解:看懂并修改 config.yaml
逐段解释 Clash(mihomo)配置文件 config.yaml 的结构:端口与基础设置、proxies 节点、proxy-groups 策略组、proxy-providers 订阅集合和 rules 规则,附一份带注释、可直接改用的完整示例。
最后更新:
Clash 的全部行为都由一份 YAML 配置文件决定。用订阅的时候,这份文件由服务商生成,你不需要动它;但看懂它的结构,才能自己加规则、调整策略组,或者排查问题。
本文按 mihomo 内核的语法说明,原版 Clash 的配置是它的子集。
整体结构
一份配置文件由五个部分组成:
| 部分 | 作用 |
|---|---|
| 基础设置 | 端口、运行模式、日志、控制接口 |
dns |
域名解析方式,见 DNS 设置 |
proxies / proxy-providers |
节点列表,或从订阅地址拉取节点 |
proxy-groups |
策略组:把节点组织起来,决定手动选还是自动选 |
rules / 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,取最快的
# ---------- DNS ----------
dns:
enable: true
ipv6: false
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
default-nameserver: [223.5.5.5, 119.29.29.29]
nameserver:
- https://dns.alidns.com/dns-query
- https://doh.pub/dns-query
# ---------- 节点 ----------
proxies:
- name: "香港 01"
type: ss
server: hk01.example.com
port: 8388
cipher: aes-256-gcm
password: "your-password"
- name: "日本 01"
type: trojan
server: jp01.example.com
port: 443
password: "your-password"
sni: jp01.example.com
# ---------- 策略组 ----------
proxy-groups:
- name: "节点选择"
type: select # 手动选择
proxies: ["自动选择", "香港 01", "日本 01", DIRECT]
- name: "自动选择"
type: url-test # 自动选延迟最低的
proxies: ["香港 01", "日本 01"]
url: https://www.gstatic.com/generate_204
interval: 300 # 每 300 秒测一次
tolerance: 50 # 延迟差小于 50ms 不切换
# ---------- 规则 ----------
rules:
- DOMAIN-SUFFIX,local,DIRECT
- GEOSITE,category-ads-all,REJECT
- GEOSITE,cn,DIRECT
- GEOIP,private,DIRECT,no-resolve
- GEOIP,CN,DIRECT
- MATCH,节点选择
基础设置
| 配置项 | 含义 |
|---|---|
mixed-port |
混合端口,HTTP 和 SOCKS5 都用它。也可以用 port、socks-port 分开设置 |
allow-lan |
设为 true 后,同一局域网的手机、电视可以把代理地址填成这台机器的 IP |
mode |
运行模式,一般保持 rule |
log-level |
日志详细程度,排查问题时临时改成 debug |
external-controller |
控制接口地址,网页面板和图形客户端通过它管理内核 |
secret |
控制接口的密码 |
tun |
虚拟网卡设置,见 TUN 模式 |
proxies:节点
proxies 下的每一项是一个节点。所有类型都有 name、type、server、port 四个字段,其余字段随协议变化。mihomo 支持的常见类型:
type |
协议 |
|---|---|
ss |
Shadowsocks |
vmess |
VMess |
vless |
VLESS(可搭配 REALITY) |
trojan |
Trojan |
hysteria2 |
Hysteria2 |
tuic |
TUIC |
wireguard |
WireGuard |
http / socks5 |
普通 HTTP、SOCKS5 代理 |
节点的 name 不能重复,策略组靠名字引用节点。每种协议的完整写法见 Clash 支持的协议。
proxy-providers:从订阅拉取节点
不想把节点写死在配置里时,可以让内核定时从订阅地址下载节点列表:
proxy-providers:
my-sub:
type: http
url: "你的订阅链接"
interval: 43200 # 每 12 小时更新
path: ./providers/my-sub.yaml
health-check:
enable: true
url: https://www.gstatic.com/generate_204
interval: 300
proxy-groups:
- name: "节点选择"
type: select
use: [my-sub] # 用 use 引入整个 provider
proxies: [DIRECT]
这样分流规则和策略组由你自己掌握,节点交给订阅自动更新,适合在服务器上长期运行。
proxy-providers 还可以用 filter 按名称筛选节点,例如只保留名字里带「香港」的:
filter: "香港|HK"
proxy-groups:策略组
策略组决定「一批节点里到底用哪个」。常用的四种类型:
type |
行为 | 适合 |
|---|---|---|
select |
手动选择 | 主入口,自己决定用哪个节点或哪个子组 |
url-test |
定期测速,自动用延迟最低的 | 不想手动挑节点 |
fallback |
按顺序用第一个可用的 | 有明确的主备顺序 |
load-balance |
把请求分摊到多个节点 | 多节点并用 |
策略组可以嵌套:上面示例里,「节点选择」的选项里包含了「自动选择」这个组。常见的做法是为不同用途建不同的组,例如「流媒体」「AI 服务」,再在规则里把对应域名指向这些组。
DIRECT(直连)和 REJECT(拒绝)是内置策略,可以直接写进任何策略组的 proxies 里。
修改配置的正确姿势
直接改订阅下载下来的文件,下次更新就会被覆盖。应该用客户端提供的覆写机制:
- Clash Verge Rev
- 加几条规则:右键订阅卡片 →「编辑规则」,在界面里添加前置规则;
- 加节点或策略组:右键订阅卡片 →「编辑节点」「编辑代理组」;
- 对所有订阅都生效的改动:在「订阅」页面的「全局扩展配置」里写 YAML;
- Clash Meta for Android:「设置 → 覆写」;
- mihomo 命令行:自己维护
config.yaml,节点用上面的proxy-providers引入。
改完后查看客户端的「日志」页面,确认没有报错。
接下来可以看规则与分流,了解 rules 部分的详细写法。
常见问题
Clash 的配置文件在哪里?
Clash Verge Rev 在「设置 → Verge 设置 → 配置目录」可以直接打开所在文件夹;右键订阅卡片选「编辑文件」能看到订阅原文。命令行运行 mihomo 时,配置文件是 -d 参数指定目录下的 config.yaml,默认目录是 ~/.config/mihomo。
改了订阅里的配置,为什么一更新就没了?
订阅更新时会用服务器上的内容整个覆盖本地文件。想让修改保留下来,要用客户端的覆写功能:Clash Verge Rev 是「全局扩展配置」和订阅卡片右键里的「编辑规则」,Clash Meta for Android 是「设置 → 覆写」。
YAML 格式要注意什么?
缩进只能用空格,不能用 Tab,同一层级的缩进必须对齐;冒号后面要有一个空格;包含冒号、井号等特殊字符的值要加引号。格式写错时内核会拒绝加载,并在日志里给出出错的行号。
url-test、fallback、load-balance 有什么区别?
url-test 定期测速并自动选用延迟最低的节点;fallback 按顺序使用第一个可用的节点,出故障才切到下一个;load-balance 把请求分散到多个节点上。手动选择用 select 类型。