Clash配置文件里,各字段负责什么

完整配置的层次

Clash 的主配置文件遵循严格的 YAML 键值字典结构。一个支持多协议、具备 Fake-IP 分流能力的规范配置(以 Mihomo / Clash.Meta v1.18+ 为基准)由以下五个核心层级组成:

配置块层级 核心字段名称 主要职责与行为 错误配置的典型表现
1. 通用监听与全局控制 mixed-port, allow-lan, mode, log-level 定义本地端口开放行为、局域网共享权限、工作模式(rule/global/direct)与日志级别 端口被占用导致核心启动失败 (bind: address already in use)
2. DNS 解析子系统 dns.enable, enhanced-mode, nameserver 拦截系统 DNS 请求,决定是采用 fake-ip 虚拟网段还是 redir-host 真实远程解析 Fake-IP 缓存污染或国内外 DNS 上游配置倒置导致国内网站变慢
3. 代理单体定义 proxies 声明各个真实服务器节点的名称、协议(ss, vmess, trojan, vless, hysteria2)、地址、端口及密码凭据 密码或加密算法写错导致握手超时 (handshake timeout)
4. 策略组结构 proxy-groups 组合多个 proxies,定义调度策略(select 手动, url-test 自动测速, fallback 故障转移, load-balance 负载均衡) 引用的节点名称拼写错误导致核心解析抛出 proxy not found
5. 流量分流规则 rules 或 rule-providers 依据请求的域名后缀、关键词、IP 归属或进程名,将连接指派给具体的 proxy-group 或 DIRECT/REJECT 缺少 MATCH 兜底规则导致无法识别的流量直接阻断

字段之间的引用关系

YAML 是基于文本缩进的结构化语言,Clash 配置文件内部存在着强绑定的链式引用关系。如果引用的字符串不一致,核心加载阶段就会直接拒绝启动:

⚠️ 链式引用一致性规则

rules 中目标指向的值 必须存在于 proxy-groups[].name;
proxy-groups[].proxies 中的每个元素 必须存在于 proxies[].name 或属于内置保留字(DIRECT, REJECT)。

最小示例与校验

以下提供一份完全脱敏、符合 Mihomo / Clash.Meta v1.18+ 规范的最小可运行 YAML 模板。它涵盖了混合端口、Fake-IP DNS、单节点、策略组与四级规则链:

符合规范的最小 config.yaml 样例

            
1 # clashdian.com - 脱敏标准配置模板
2 mixed-port: 7890
3 allow-lan: false
4 mode: rule
5 log-level: info
6 ipv6: false
7
8 dns:
9 enable: true
10 listen: 0.0.0.0:1053
11 enhanced-mode: fake-ip
12 fake-ip-range: 198.18.0.1/16
13 nameserver:
14 - 223.5.5.5
15 - 119.29.29.29
16 fallback:
17 - https://dns.google/dns-query
18 - 1.1.1.1
19
20 proxies:
21 - name: "极连云-香港IPLC-01"
22 type: ss
23 server: 103.145.12.88
24 port: 8388
25 cipher: aes-128-gcm
26 password: "token-sample-password-2026"
27
28 proxy-groups:
29 - name: "节点选择"
30 type: select
31 proxies:
32 - "极连云-香港IPLC-01"
33 - DIRECT
34
35 rules:
36 - DOMAIN-SUFFIX,google.com,节点选择
37 - DOMAIN-KEYWORD,github,节点选择
38 - GEOIP,CN,DIRECT
39 - MATCH,节点选择

            
1 # 使用 mihomo 核心自带的 -t 测试参数进行严格语法检查
2 ./mihomo -t -f ./config.yaml

用最小示例核对概念

在正式启动代理前,在终端执行测试检查。当 YAML 缩进无误且所有节点与组名引用正确闭环时,核心将输出配置语法测试通过:

[INFO] Start testing configuration file ./config.yaml
[INFO] DNS enhanced-mode: fake-ip (range: 198.18.0.1/16)
[INFO] Inbound: mixed-port listening on 127.0.0.1:7890
[INFO] Proxy: [极连云-香港IPLC-01] parsed successfully
[INFO] ProxyGroup: [节点选择] linked 2 proxies
[INFO] Rules: 4 rules compiled successfully
configuration file ./config.yaml test is successful
📖 深入关联

前置阅读:Clash基础新手教程 · 下一步:学习更为细致的 分流规则集与兜底算法 及 策略组延迟测试原理