· 内核进阶 · 预计阅读 8 分钟
mihomo 内核与原版 Clash 差异:新增协议、规则集与配置字段变化
对照原版 Clash,梳理 mihomo(Clash Meta)在协议支持、rule-providers、DNS 与 TUN 字段上的扩展,以及旧配置迁移时需要改写的位置。
内核版本与配置兼容范围
Clash Meta 是 mihomo 的旧称。比较原版 Clash 时,要区分原版开源内核和另外发布的 Clash Premium。规则集和 TUN 并不是从 mihomo 才出现:Premium 已有相关能力,但它的配置不能视为原版开源内核的通用配置,也不能假定所有字段在 mihomo 中行为相同。
迁移前先确认客户端实际启动的内核。客户端的版本号与内核版本号是两回事。如果能访问正在使用的 mihomo 可执行文件,可用 mihomo -v 查看版本;单独下载的二进制即使同名,也不能代表图形客户端正在使用它。
| 配置项 | 迁移到 mihomo 时的处理 |
|---|---|
mixed-port、mode | 先保留原值。若客户端覆写监听端口或运行模式,以实际启动时的值为准。 |
proxies、proxy-groups、rules | 常用结构可以保留。逐一核对节点类型、组成员名称和规则目标。 |
rule-providers、RULE-SET | 若旧配置来自 Premium,检查载入方式、规则行为和实际匹配顺序。 |
dns、tun | 分别迁移和验证。不要同时更换 DNS 上游、增强模式和系统路由。 |
新增协议:先核对节点类型,再看传输字段
mihomo 扩展了原版 Clash 的出站协议范围。例如,VLESS 节点写作 type: vless,Hysteria 2 写作 type: hysteria2,TUIC 写作 type: tuic。只把旧配置里的 type: vmess 改为 type: vless 不会转换协议;出站类型、凭据和传输参数必须与服务端一致。
- VLESS 与 REALITY:VLESS 是节点协议,REALITY 不是独立的
type。对于使用 REALITY 的 VLESS 节点,核对servername、reality-opts内的public-key和short-id。仅当服务端要求 Vision 时才配置对应的flow。 - Hysteria 2 与 TUIC:两者基于 QUIC。能解析服务器域名、能访问网页,或能连通服务器的 TCP 端口,都不能证明相同端口的 UDP 流量可达。排查时分别核对协议字段、认证信息和实际网络对 UDP 的支持。
- 订阅导入:先区分完整 YAML 配置和仅供节点提供器读取的节点清单。订阅更新成功只代表客户端拿到了内容;若策略组没有引用新节点,正常请求仍可能走原来的出站。
规则集:文件格式、行为与匹配顺序
rule-providers 注册规则集,rules 中的 RULE-SET 才决定何时使用它、命中后走哪个出站。下面用本地文件演示迁移,避免把远端规则集的下载失败和配置错误混在一起。
主配置中的规则集引用
mode: rule
rule-providers:
local-domains:
type: file
behavior: classical
format: yaml
path: ./rules/local-domains.yaml
rules:
- RULE-SET,local-domains,DIRECT
- MATCH,DIRECT
规则集文件 rules/local-domains.yaml
payload:
- DOMAIN-SUFFIX,example.org
这里两条规则都指向 DIRECT,用于检查规则命中,不改变默认出站。内核在规则模式下按顺序匹配,通常以第一条命中为准。用连接记录验证时,确认 example.org 命中的是 RULE-SET,而不是末尾的 MATCH;只看出站名称无法区分两者。把真实配置的兜底规则放在最后,也留意上方更宽泛的域名或 IP 规则是否提前匹配。
behavior: classical 可使用示例中的 DOMAIN-SUFFIX,example.org;behavior: domain 读取域名匹配条目,不沿用这类带规则类型前缀的写法;behavior: ipcidr 读取 IP 网段。format 则描述文件编码格式,不是匹配行为。把文件后缀改成 .mrs 不会将 YAML 转成 MRS;若改用 MRS,应使用实际生成的文件,且规则行为应为 domain 或 ipcidr。
DNS 迁移:分清目标域名与节点域名
目标域名是应用访问的地址;节点域名是代理服务器本身的地址。客户端能解析前者,不代表内核能解析后者。若节点配置中的 server 使用域名,mihomo 可用 proxy-server-nameserver 为节点域名指定解析上游。排查时确认该上游在节点尚未连通时也能到达,避免形成「先连节点才能解析节点」的依赖。
nameserver是常规查询的上游配置之一;nameserver-policy可为匹配的域名指定不同上游。企业内网域名应使用能解析该内部区域的 DNS,而不是仅追加一个公共上游。enhanced-mode: fake-ip会给符合条件的查询返回映射地址。若运行配置使用198.18.0.1/16,看到该范围内的应答通常是预期现象,不是目标服务器的公网地址。- 如果某个内网域名需要真实 IP,可检查
fake-ip-filter与fake-ip-filter-mode。在黑名单模式下,匹配过滤项的域名不返回 Fake IP;过滤只改变应答方式,不会自动为内网域名选择能解析它的上游。
普通查询成功而业务失败时,先用同一个域名对比应用实际使用的解析路径和内核连接记录。浏览器自己的加密 DNS 可能走不同路径。此外,依赖 IP 的规则可能触发域名解析;在适用的规则上加 no-resolve 会阻止该规则主动为域名查询 IP,不代表全局关闭 DNS。
TUN 迁移:先验证代理端口,再接管系统路由
系统代理依赖应用遵循代理设置;TUN 通过虚拟网卡和路由接收流量。浏览器在系统代理下正常,并不能证明 TUN 已接管终端、游戏或其他不读取系统代理的应用。迁移时先关闭 TUN,验证代理监听和节点,再单独打开 TUN 对比变化。
- 若运行配置使用
mixed-port: 7890,可执行curl -I --proxy http://127.0.0.1:7890 https://example.org/。在将curl设为别名的 Windows PowerShell 环境中使用curl.exe。收到响应后还要查连接记录,确认请求是否走了预期策略;返回响应不等于代理节点已被选中。 - 启用
tun.enable后,核对内核是否具备创建虚拟网卡和修改路由的权限。auto-route控制自动添加路由;有线、无线和其他 VPN 并存时,检查自动识别的出口是否正确,不要把默认出口误判成节点故障。 - 如果启用 TUN 后仅 DNS 异常,检查
dns-hijack的匹配范围。any:53用于匹配 UDP 53,tcp://any:53用于匹配 TCP 53;这些规则不会把 HTTPS 上的加密 DNS 查询当作普通 53 端口查询接管。
旧配置迁移的验证顺序
保留可用的旧配置,在独立工作目录测试新配置。以下命令从包含该配置的工作目录运行;如果使用图形客户端,最终还要核对订阅合并和覆写之后交给内核的配置。
mihomo -v
mihomo -t -d . -f config.yaml
-t 用于测试配置,不代替运行时验证。先用一个已知可用的节点验证代理入口,再检查一条应直连的请求和一条应进入代理组的请求,最后分别验证 DNS 与 TUN。若更新订阅后问题重现,对照更新前后的实际规则顺序和组成员,检查覆写是否仍然生效。
如果切换后连内网也中断,优先停用 TUN 并恢复先前的系统代理与配置,再逐项复测。字段含义可对照配置参考;应用代理、策略组和内核之间的关系可查阅名词解释。