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、单节点、策略组与四级规则链:
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 缩进无误且所有节点与组名引用正确闭环时,核心将输出配置语法测试通过:
配置文件语法测试通过日志 (mihomo -t)
./mihomo -t -f ./config.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基础新手教程 · 下一步:学习更为细致的 分流规则集与兜底算法 及 策略组延迟测试原理
五大主推精选导航
兼容纯净 YAML 配置:五大精选主力机场推荐
编写出优雅的 YAML 规则后,需要高品质中继节点支持。以下服务商均直接提供格式规范的通用 Clash / Mihomo 订阅,免除手动编写节点的烦琐:
全球云
20 元/月 · 120GB/月(折后16元) 120GB - 1500GB/月
核心卖点: 独家 8 折优惠码 qq88!20+ 国家和地区全球出口覆盖,主打 TikTok、YouTube、跨境电商与流媒体解锁所需的多区域原生出口,智能分流极速稳定。
节点网络: 涵盖港、澳、台、日、韩、新、美、德、英、法等全球 20+ 地区高速出口
AI与流媒体: 全区域原生 IP 支持 ChatGPT、Claude、Jasper AI 与跨境支付系统
适用场景:
跨境电商与 TikTok 矩阵运营多国流媒体地区库切换海外社媒高频交互与多出口调度
套餐阶梯: 轻量版 20元/120GB(折后16元);进阶版 40元/300GB;重度版 100元/700GB;大户版 180元/1500GB | 轻量年付 99元/年(59GB)
暮光(暮光加速)
20 元/月 · 120GB/月 120GB - 1.5TB/月
核心卖点: 全单专属优惠码 mm88 享 8 折!超大带宽集群与高速中转,晚高峰观看 YouTube 4K/8K 视频秒加载无缓冲,大文件下载跑满带宽,全面解锁 Netflix 4K 与 ChatGPT。
节点网络: 高速中转及大带宽集群,香港、日本、美国大带宽出口
AI与流媒体: 全面解锁 ChatGPT、Claude 3.5、Midjourney、Netflix 4K
适用场景:
晚高峰 4K 极清视频无缓存播放超大流量持续下载高吞吐内容生产
套餐阶梯: 基础版 20元/120GB;标准版 40元/300GB;旗舰版 100元/700GB;至尊版 180元/1.5TB
飞猫(飞猫云)
7 元/月 · 50GB/月(学生年付折算) 50GB - 150GB/月
核心卖点: 输入专属优惠码 flycat888 享季付及以上 8 折!低价小流量配 IEPL/IPLC 纯专线,晚高峰实测香港与日本节点低延迟稳定,学生党与轻量备用高性价比标杆。
节点网络: IEPL/IPLC 混合专线,核心聚焦香港、日本与美西
AI与流媒体: 支持常用 ChatGPT、Claude 与主流流媒体
适用场景:
学生党低成本网络备用香港方向超低延迟交互多终端轻度协同冲浪
套餐阶梯: 星耀版 25元/150GB(首次月付测试首选) | 学生版 84元/年(每月50GB,折合7元/月)
微风(微风网络 BreezeNet)
25 元/月 · 200GB/月 200GB/月起
核心卖点: 大流量入门首选!月付 25 元即享 200GB 超充沛基础流量,IEPL 专线及高可用中转线路,支持自研客户端与开源 Clash 订阅一键导入,日常冲浪与大文件下载告别流量焦虑。
节点网络: IEPL 专线及高可用中转线路,香港与日本节点为主
AI与流媒体: 常规支持 ChatGPT、Gemini 等主流 AI 工具
适用场景:
大流量日常浏览与下载双端自研应用轻松登录轻度专线稳定加速与长效在线
套餐阶梯: 常规月付 25元/200GB | 参考年付套餐 137元/年 (100GB/月)
大佬(大佬云)
20 元/月 · 120GB 120GB - 1500GB
核心卖点: 价格梯度透明清晰:轻云 120GB 起步至无界 1500GB,优质专线与骨干中转集群,港台日美全覆盖,季付年付优惠充足,大户与多设备分流首选。
节点网络: 优质专线与中转网络,香港、台湾、日本、美西多线覆盖
AI与流媒体: 畅快支持 ChatGPT 4o、Claude 3.5 Sonnet 与主流流媒体
适用场景:
大流量流媒体沉浸播放多节点按需分流策略长期稳定的网络中继与多设备共享
套餐阶梯: 轻云 Lite 20元/120GB;跃云 Leap 40元/300GB;凌云 Soar 100元/700GB;无界 Infinity 180元/1500GB | 轻云 192元/年;跃云 384元/年;凌云 960元/年;无界 1728元/年