Clash / Mihomo 配置文件全解:从读懂 YAML 结构到安全定制专属分流方案
直接结论(Answer-First)
现代桌面与软路由最主流的代理配置文件格式是兼容 Mihomo(原 Clash.Meta)内核的 YAML 配置文件。整份配置其实只由五块核心积木拼成:基础与端口参数、DNS 解析模块、proxies(或 proxy-providers 节点池)、proxy-groups(策略调度组)与自上而下执行的 rules(分流规则集)。真正的高阶用法不是每次收到订阅就去直接改原文件(下次更新就会丢失),而是利用 [Clash Verge Rev](/clients/clash-verge-rev) 等现代客户端提供的本地扩展覆写(Merge / Script),做到机场节点列表照常自动更新,而自己的 AI 定向锁区、低倍下载分流与防泄漏 DNS 参数永久留存。
一、配置文件的五大核心积木:一张蓝图看懂几千行 YAML
哪怕某家机场给你下发的 YAML 文件长达两三千行,其实绝大部分篇幅只是密密麻麻的节点参数和冗长的规则域名列表。把它剥离成骨架后,任何人只要三分钟就能看懂全貌:
yaml
mixed-port: 7890 # 1. 本地监听端口与工作模式配置
allow-lan: false
mode: rule
log-level: info
dns: # 2. DNS 防污染与 Fake-IP 解析模块
enable: true
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5
- 119.29.29.29
proxies: # 3. 节点明细区(或者外部 proxy-providers 引用)
- { name: "香港 01", type: vless, server: hk.example.net, port: 443, ... }
- { name: "新加坡 01", type: ss, server: sg.example.net, port: 8443, ... }
proxy-groups: # 4. 策略分组区(决定谁自动测速、谁手动固定、谁故障切换)
- name: "🚀 节点选择"
type: select
proxies: ["⚡ 自动选择", "香港 01", "新加坡 01"]
- name: "🤖 AI 工具专用"
type: select
proxies: ["新加坡 01", "日本 01"]
rules: # 5. 分流规则路由表(从上往下逐行比对,先中先走)
- DOMAIN-SUFFIX,openai.com,🤖 AI 工具专用
- GEOIP,CN,DIRECT
- MATCH,🚀 节点选择理解了这五个板块的上下游联动关系,今后无论软件报什么配置错误,或者你想调整哪一个网站走哪条节点,都不会再像看天书一样无从下手。
二、基础网络字段与 dns 模块关键参数解析
配置文件最顶部的全球通用设置决定了你的电脑如何在本地系统与内核之间交接数据包:
| 核心字段名称 | 常见推荐取值与工程含义 | 新手最容易踩的错误配置 |
|---|---|---|
mixed-port | 默认 7890 或 7897:一个端口同时兼容 HTTP 和 SOCKS5 系统代理协议 | 在同一台电脑上同时运行两个代理客户端均占用 7890 端口,引发软件端口冲突直接闪退或断流 |
allow-lan | 个人笔记本设为 false 仅限本机 127.0.0.1 接入;需要让手机、游戏机同局域网共享代理时再改为 true | 在咖啡馆或公司公共 Wi-Fi 下开启了 allow-lan: true 且未设连接密码,导致同局域网陌生设备蹭网白嫖你的机场流量 |
mode | 绝大多数日常场景严格设为 rule(规则分流模式) | 误将模式改成 global(全局模式)后忘了调回,导致连国内百度、淘宝和网盘也强行绕去香港节点白烧流量还变慢 |
ipv6 | 若当地宽带或所连节点池并不稳定支持 IPv6,建议保持 false 关闭状态以免泄漏或拖慢握手 | 开着系统原生 IPv6 却未配置代理接管,造成访问流媒体时部分请求顺着国内原生 IPv6 地址泄露导致解锁失效 |
tun 区块 | 由桌面界面开关统筹接管虚拟网卡流量(详情参考 TUN 模式全解) | 普通桌面配置直接照抄带有激进路由表的远端 TUN YAML,导致启动后与企业 VPN 或虚拟机网桥产生路由环路死锁 |
关于 dns 区块的深度参数(例如 fake-ip-filter 国内域名白名单、nameserver 与 fallback 国内外防污染分离),可前往 DNS 防泄漏设置完整指南 逐行对照调试。
三、proxies 节点池与四大 proxy-groups 调度策略实战选择
真正决定一台客户端“用起来聪不聪明、稳不稳”的灵魂,在于第四板块 proxy-groups(策略组)如何管理第三板块里成百上千条节点。很多老手觉得自己用的机场比别人稳,其实就是悄悄改对了策略组类型。
策略组 type | 工作调度机制解析 | 最适用的业务与场景 | 真实隐患与使用忌讳 |
|---|---|---|---|
select(手动选择) | 完全由用户点击选定其中某一个节点或下级子组,除非手动切换否则纹丝不动 | AI 办公与高风控账号首选(例如锁定固定 SG-02 或 US-01 用 Claude),或用来担任主策略总开关 | 如果你选定的那一台单独编号某天夜间突然下线维护,需要用户自己点进面板换一个邻居节点 |
url-test(自动测速) | 按照设定的 interval(如 300 秒)向 url 发真连接探测包,自动把流量交予目前延迟最小(或低于 tolerance 容差范围)的节点 | 日常网页冲浪与港/日高速浏览组;适合将一批全 1x 同地区健康专线放入池中省心轮值 | 严禁把香港与新美混合塞进同一个自动选择组用来走 AI!香港延迟永远最低(14–31ms),会导致你永远自动连到香港而频繁触发 ChatGPT 封禁 |
fallback(故障转移) | 严格按照列表从上到下的先后顺序把首位节点当成绝对主用,只在首节点连续测速超时后才自动跌落给第二顺位替补 | 追求长期稳态的极佳平衡方案:既保证了 IP 不会随轻微延迟抖动而每五分钟乱跳一次,又能在单一节点 0B 抽风时自动无缝切换兜底 | 需要自己按真实带宽高低与解锁情况手动排好列表内的前后顺序,把经过验证的健康号放在第一名 |
load-balance(负载均衡) | 按轮询(round-robin)或基于域名/来源 IP 哈希把不同网页并发连接分散打向组内多个不同节点 | 重度多并发大包爬取或单纯提升多路极限吞吐量场景(且要求池里每台机器都能解锁且速率近似) | 家用最危险策略:正如实测见过同一家日本组里 日本04 = 257MB/s 而 日本05 = 8KB/s、美线 美国02 = 1.6KB/s,如果开了负载均衡,浏览器部分图片与页面请求就会随机撞死在慢机上导致整页加载转圈 |
极佳策略组合实践:给自己的日常主力组设为
fallback故障转移或精简筛选过的url-test(里面仅包含经过手动排查无 0B 慢机的1x港/日节点);再额外单建一个🤖 AI 稳定组用select或fallback(里面坚决剔除所有香港节点,只保留健康新加坡、日本与美西编号)。
四、rules 分流规则匹配顺序与核心语法速查
在 Mihomo 内核中,rules 段落就像邮政分拣流水线上的多道筛网。每一个发出去的网络连接请求,都会从第一条规则开始往下比对;只要命中第一条符合条件的规则,流水线立刻放行执行对应动作,彻底跳过后面剩余的所有规则。
以下是最常见、最高频的六种标准规则指令与典型写法:
| 规则前缀关键字 | 匹配判断逻辑 | 实战样例(附带含义解析) |
|---|---|---|
DOMAIN | 精确匹配完全相同的单个完整域名 | DOMAIN,chatgpt.com,🤖 AI 工具专用(仅针对精准域名做分流) |
DOMAIN-SUFFIX | 匹配该主域名及其名下所有的子域名后缀 | DOMAIN-SUFFIX,openai.com,🤖 AI 工具专用(自动涵盖 api.openai.com、auth.openai.com 等全部子域) |
DOMAIN-KEYWORD | 域名字符串只要包含某个关键词即立刻命中(注意匹配范围极广易误伤) | DOMAIN-KEYWORD,anthropic,🤖 AI 工具专用(匹配所有含 anthropic 字段域名) |
IP-CIDR | 按照明确的目标服务器 IPv4/IPv6 地址网段做分流判别 | IP-CIDR,192.168.0.0/16,DIRECT,no-resolve(加 no-resolve 避免为纯局域网地址触发无效 DNS 查询) |
GEOIP | 利用本地加载的 MaxMind IP 库判定目标 IP 属于哪一个国家或区域 | GEOIP,CN,DIRECT(国内 IP 直接直连放行;常紧接内网局域网白名单之后或置于靠后位置) |
RULE-SET | 调用由外部托管维护或本地缓存的成千上万条专项分类规则集合(Mihomo 原生强项) | RULE-SET,openai,🤖 AI 工具专用(无需自己手写上百行动态更新域名表,随规则集后台热更新) |
MATCH | 无条件匹配前面所有规则均漏网的其余全部连接,永远必须写在整个配置文件最末尾一行 | MATCH,🚀 节点选择(兜底规则,确保未被国内规则接管的未知海外小站全部顺利走代理通道) |
关键优化技巧(
no-resolve的重要性):凡是紧接在域名规则之后的IP-CIDR与GEOIP规则,如果前面还没有触发远端解析,纯靠 IP 段匹配时务必留意加上,no-resolve尾标(仅对部分局域网或已知特定 CIDR),能减少大量多余的本地域名解析卡顿;而在处理海外域名的GEOIP,CN前,系统必须先走规则识别把海外主流站点抓出来,否则如果 DNS 被污染或未配对也会引发错分。详细分流架构可参阅 代理分流规则精细化教程。
五、不丢配置的高阶法则:如何在 Clash Verge Rev 中使用本地 Merge / 扩展脚本
几乎每一个刚学会改 YAML 配置文件的用户都会遇到过同一件令人崩溃的事:昨晚辛苦花了半小时改好所有分组和几十条专属规则,结果今天早上电脑点了一下“更新订阅”,机场官方发来的新版配置直接把昨天的劳动成果覆盖了个一干二净!
想要做到**“机场有新节点自动收进列表、但自己加的 AI 分流策略、排除高倍率正则以及定制 DNS 参数永远稳如泰山”**,现代客户端正确的工程路径是放弃直接修改订阅缓存源文件,全面改用 本地覆写(Merge / Script Extension):
- 为什么永远不能直接手动改远程订阅原文件? 因为从远程 URL 下载的配置文件本质上只是服务器端按周期刷新的只读缓存快照。无论是点击手动更新按钮,还是设定了每 12/24 小时自动定时拉取,客户端都会把服务器返还的新数据直接重新覆写磁盘原文件,不会去给你做本地差异合并(Diff Merge)。
- 标准解法一:利用内置 Merge(YAML 局部叠加覆写) 在 Clash Verge Rev 的订阅(Profiles)界面中,右键选中你正在使用的主订阅,点击 “编辑扩展覆写(Merge / Extend)”,或者在全局建立一个对所有订阅通吃的全局扩展脚本。你只需要在这里写出自己想要追加的个别分流规则、自定义的策略分组(或利用
prepend-rules把规则插在机场默认所有规则的最顶端)、以及自定义的 DNS 白名单,内核就会在每次拉取机场最新节点后,在内存中把服务器下发配置与你本地扩展片段动态缝合在一起启动。 - 标准解法二:用极简 JavaScript 扩展实现高级多机场拼接与正则排除 如果你同时持有“主力月付(如 光速云 或 星岛梦)+ 一份跨体系不限时备用(如 唯兔云 或 二猫云)”,利用官方原生
proxy-providers结合本地扩展脚本,就能完全脱离危险的网上免费在线订阅转换网页(参看 订阅链接安全防护),直接在你电脑内存里把两套订阅安全融合在一个操作界面里,同时用正则表达式自动排除掉[2x]、[3x]高倍率标签节点或只提取新加坡节点放入专属 AI 列表。
六、常见 YAML 配置文件启动失败报错速查手册
当你自己动手微调或引入了外部 Merge 规则后,一旦点击重启内核突然弹窗报错(提示无法启动服务或文件解析异常),99% 的情况集中在下面五种极其简单的低级文字错误上:
| 报错关键词或典型现象 | 最大概率根源排查点 | 一分钟快速修复方法 |
|---|---|---|
yaml: line X: found character that cannot start any token | 配置文件里意外混入了中文全角冒号 :、全角引号、或者用 Tab 制表符代替了半角空格做行首缩进 | 把文件拖入支持显示空白符的代码编辑器(如 VS Code 或记事本开启显示空格),把行首 Tab 全换成 2 个标准半角空格,检查中文字符误打 |
proxy group [XXX] not found 或内核无提示直接秒退 | 在 rules 最后一条某规则指向了名为 AI专用 的组,但在上面的 proxy-groups 里写成了 AI 专用(多了一个空格或少了一个 emoji 图标导致字符串不对齐) | 保持分组命名全篇一字不差(建议直接复制粘贴组名),尽量避免在强依赖手写关联的名字里混用复杂不可见特殊字符 |
proxy-groups 循环嵌套引用(Cycle detected) | 策略组 A 里面包含了策略组 B,而策略组 B 的子节点清单里又反向包含了策略组 A,引发死循环 | 检查各自 proxies 列表,确保调度结构永远呈树状自上而下清晰单向引用,不可互指 |
| 规则明明写了但某网站始终走了直连或错误节点 | 该域名实际上先命中了写在更前面的另一条宽泛规则(例如泛匹配或前排远端规则集),或者本地开启了浏览器的安全 DNS(DoH)绕开了软件接管 | 利用客户端的“连接(Connections)”实时审计标签页搜索该域名,一眼就能看见它到底第几行命中了哪条规则并按需把自定义规则置顶 (prepend) |
订阅内节点全正常但无法加载远端 rule-providers | 首次拉取规则集的时候外部规则源托管在 GitHub 上,本地在拉取瞬间没有代理协助导致下载卡死失败,进而报错无法加载完整规则 | 开启兼容国内镜像源或配置规则拉取通道走代理,具体排障方法参阅 客户端自动更新与规则拉取失败排查 |
个人日常维护配置文件的极简备份与迁移规范
当你经过不断试错,终于把一份包含本地 Merge、定制策略组、fake-ip-filter 以及自用正则表达式的配置文件打磨得无比顺手时,千万别忘了做异地安全备份。很多用户重装 Windows 系统或更换新 MacBook 后发现又要重新一点点回忆几个月的分流微调参数。正确的保存习惯是:在电脑云盘(注意绝对不要上传带有机场完整 token= 订阅 URL 的原文件到公开库!)或者本地加密目录里,只单独保存一份脱敏后的纯本地 Merge/规则覆写模板文件。下一次换新设备装完 Clash Verge Rev,第一步安全粘贴新买或原有的订阅地址,第二步把这份脱离任何私密凭证的覆写模板直接导入扩展面板,三十秒就能完全复刻出一模一样的上网手感与所有分流策略。此外在更换主力机场时,由于通用规则扩展完全靠分组正则与标准后缀驱动,这份个人配置资产同样可以无缝对接到下一家开放订阅的新机场上,真正做到“配置随人走,机场随便换”。对于拥有家里软路由与桌面端多套设备的玩家,也可以通过同步剔除隐私令牌的纯逻辑扩展规则来维持统一上网规则手感。只要严格把握好配置文件里缩进校验、策略组树状引用不闭环以及 MATCH 永置最末行的核心纪律,无论以后切换多少家机场服务商,手里那套稳定干净的分流模板都能长年无痛沿用,帮你把配置折腾的时间成本压到最低极限。
七、配置文件专题集群延伸规划(Tier-3 深化清单)
作为代理客户端技术操作体系的基石,本页在“使用指南”中直接串联起软件安装、分流策略及排障链路。后续第三层实战专题将沿如下高实用度方向持续扩写(当前作路线规划清单,不生成空白页面):
- 双机场
proxy-providers零泄露本地聚合完整模板教程:提供干净无污染、附带健康检查与倍率正则过滤的标准 YAML 骨架代码,帮助用户彻底告别网上第三方订阅转换站。 - JavaScript 扩展脚本(Script Extension)入门实战:教会非程序员用户用十行标准安全 JS 代码给任何简陋订阅自动注入
🤖 AI 专用和🎬 流媒体独立分组。 - Mihomo(Clash.Meta)相比老版已停更 Clash 原核的独家实用语法盘点:深入详解
GEOSITE内置分类标签、sub-rules子规则嵌套与sniffer流量域名嗅探防泄漏等现代特性。
八、常见问题(FAQ)
我刚买完机场导入订阅就能用了,还有必要看懂 Clash YAML 配置文件吗?
看懂核心字段非常值得。机场下发的默认配置往往比较笼统,比如只给一个统一代理组。看懂代理组与规则段落后,你就能五分钟内把 ChatGPT/Claude 定向锁进新加坡或日本、把香港留给日常浏览、把大文件下载分配到低倍率节点,不再被默认设置绑架。
常见的 select、url-test、fallback、load-balance 四种策略组分别适合什么场景?
select(手动选择)适合固定某个干净编号防封号;url-test(自动测速选择)会每隔一定时间挑选真连接延迟最低的节点;fallback(故障转移)平时死守排在最前面的首选节点,只有主节点彻底连不上才依次切到替补;load-balance(负载均衡)会把连接分散给池内所有节点,最怕混入单台超慢故障机。
为什么我自己在软件里手动编辑了订阅规则,过两天自动更新订阅后又全恢复原样了?
这是新手最高频遇到的覆写问题。直接修改远程订阅缓存文件会在下一次拉取更新时被服务器下发的新 YAML 整份覆盖。正确做法是使用 Clash Verge Rev 或 Mihomo 内置的本地 Merge/Script 扩展覆写机制,把你的定制规则独立存放在局部覆写规则文件里自动叠加。
Clash 规则列表里的 MATCH,Proxy 放在最上面为什么所有网站都不走直连了?
因为 Clash 规则引擎严格遵循“从上到下第一条命中即生效”的原则。兜底规则 MATCH 是通配匹配器,如果放在靠前位置,后面所有针对国内网站(GEOIP,CN / GEOSITE,CN)的直连规则全都不会被执行。所以 MATCH 必须始终处于 rules 段落的最后一行。
我从网上搜来别人分享的一键增强 Clash 配置脚本或复杂配置文件,能直接导入运行吗?
不建议直接盲目运行来历不明的第三方脚本或他人完整配置。陌生的 JavaScript 覆写脚本和来路不清的配置可能修改你的 DNS 解析服务、注入恶意的代理转向节点或偷加远端未知规则集,存在流量劫持隐患,详见订阅安全防护页。
如果一个机场同时不提供通用订阅,我能手动提取节点写出 Clash 配置吗?
不能。例如飞猫云、SOGO 云、闪跃、全球云、隐形人、Firefly 等明确不提供第三方订阅链接的品牌,只支持使用其官方指定客户端,无法通过规范方式生成或维护标准 Clash YAML 文件,务必留意购买前需求核对。
在 Clash Verge Rev 里遇到 YAML 语法错误提示导致无法启动内核怎么查?
YAML 对空格缩进和冒号后必须加空格极其敏感(严禁使用 Tab 键缩进)。改完配置文件或编写 Merge 扩展后若内核启动失败,先重点排查最近新增的那几行是否少了短横线后的空格、中文全角冒号误输、或代理名称引用与顶部定义名字不完全匹配。
延伸导航:客户端全平台下载清单 · 代理分流规则实战 · DNS 防泄漏与 Fake-IP 教程 · 订阅链接安全防注入指南