mihomo 配置与排障词汇

Clash 术语手册

从 config.yaml 里的字段名,查到日志里的出站结果。

遇到陌生开关先查定义;遇到连接异常,按接管、解析、匹配、出站的顺序定位。卡片标题可以直接链接到单条术语。

内核与协议

先分清界面、内核和远端,报错才知道往哪一层查。

mihomo
mihomo 是 Clash 生态中的代理内核,负责读取配置、接收连接、匹配规则并选择出站。图形客户端管导入和开关,真正处理连接的是内核。遇到“字段不支持”的报错,先看客户端实际加载的内核版本,而不是只看界面版本。
代理协议
代理协议约定客户端怎样与远端服务器建立连接、认证和传送数据。在节点定义中通常先看 type,再查该协议需要的字段。本地应用用 HTTP 代理接入,并不代表内核也用 HTTP 代理协议连接远端。
混合端口(mixed-port)
混合端口让内核在同一个本地端口接收 HTTP 和 SOCKS 代理连接。比如设为 7890 后,本机应用可指向 127.0.0.1:7890,并选择它支持的代理类型。这是应用接入端口,不是订阅地址,也不是远端服务器端口。
UDP 转发
UDP 转发指代理链路转送 UDP 数据报的能力,语音通话和部分游戏会用到它。入口得能接收 UDP,选中的出站和远端也得支持。网页能打开只说明对应连接通了;排查通话问题时,要单独确认应用的 UDP 流量走到了哪里。

配置文件结构

区分原始文件和生效配置;完整结构见配置字段。

YAML
YAML 是 mihomo 配置使用的数据格式,用缩进区分层级,用短横线表示列表项。缩进用空格,不用制表符,并让同级项对齐。若解析报错指向某一行,也检查上一行的冒号和缩进:内核可能到下一行才发现结构接不上。
主配置(config.yaml)
主配置是内核启动或重载时读取的配置,常见文件名是 config.yaml。它可以包含基本设置、代理定义、策略组和规则,也可以引用外部资源。图形客户端可能在导入后另存一份运行配置,编辑手头的同名文件不一定会改到内核读的那份。
代理定义(proxies)
proxies 是在主配置中逐项定义代理节点的列表。每项用 name 命名,并按协议填写服务器、端口等参数;策略组可以按名称引用它。若节点改名后组里找不到它,先检查引用是否跟着改,再去排查网络。
覆写与合并
覆写与合并是在原配置的基础上生成另一份实际生效的配置。改一个标量字段和加一条列表项是两回事:客户端可能替换整个列表,也可能支持前插或追加。补规则后看一下生效列表,确认原有规则还在,新规则也没有排到兜底项后面。

策略组与规则

规则决定交给谁,策略组决定实际选哪个出站。

规则分流
规则分流是在规则模式下按条件为连接选择出站。普通规则从上往下检查,命中后不再继续;域名特例应放在会覆盖它的宽泛规则之前。排查自定义规则时,先确认 mode: rule,再看连接详情实际命中了哪一条。
策略组(proxy-groups)
策略组把多个出站选项归在同一个名字下,供规则引用。组内可以列出节点、其他策略组或内置出站,选择方式取决于组类型。规则命中某个组只完成第一步,确认连接去向时还要检查组里当前选中的成员。
域名后缀规则(DOMAIN-SUFFIX)
域名后缀规则可同时匹配指定域名和它的子域名。例如 DOMAIN-SUFFIX,example.com,DIRECT 匹配 example.com 和 api.example.com,但不会匹配 notexample.com。只想匹配一个完整域名时,用 DOMAIN。
GeoIP
GeoIP 是依据 IP 地址段数据进行地区归类的规则类型。GEOIP,CN,DIRECT 检查的是目标 IP 是否被数据归入 CN,并不检查域名是不是以 .cn 结尾。同一个域名可能解析到不同地址,命中结果也可能随之改变。
兜底规则(MATCH)
MATCH 不带匹配条件,用来处理走到规则列表末尾的连接。MATCH,DIRECT 表示前面都没匹配时走直连,也可以把末项指向一个策略组。把普通规则加到 MATCH 后面,它就没有机会处理已经被兜底接住的连接。
自动测速组(url-test)
url-test 策略组向指定 URL 发起探测,按探测结果选择出站。常用字段有 url、interval 和 tolerance;容差可以减少因小幅延迟波动造成的切换。测试地址访问得快,不代表访问业务站点也快,更不等于下载带宽更大。

网络接管方式

数据包有没有进入内核、域名交给谁解析,分开检查。

系统代理
系统代理是操作系统提供给应用读取的代理设置,不等同于整个系统的流量都被接管。读取该设置的应用会连接本地代理端口,使用独立设置的应用则可能绕过它。浏览器能用而终端不通时,先查命令行工具读取哪套代理设置。
TUN 模式
TUN 模式通过虚拟网卡接收由路由导入的 IP 数据包,再由内核处理。应用不必先理解 HTTP 或 SOCKS 代理,但接管范围仍取决于路由、权限和排除项。开启开关后若连接列表没有相关记录,先检查虚拟网卡和路由是否实际生效。
Fake-IP
Fake-IP 是一种 DNS 处理模式,内核向应用返回临时地址,并记录它与域名的对应关系。后续连接到该地址时,内核可按映射取回域名用于匹配。对依赖真实解析结果的服务,可先判断是否需要将对应域名加入 fake-ip-filter。
DNS 劫持(dns-hijack)
在 mihomo 的 TUN 配置里,dns-hijack 指把命中条件的 DNS 查询交给内核的 DNS 模块。它不是上游解析器地址,也不会自动接管应用通过 HTTPS 发出的 DNS 查询。改完该项后,要分别确认查询是否被接收、接收后又交给了哪个上游。
DNS 泄漏
DNS 泄漏指本应走指定解析链路的查询,从意料之外的出口发出。网页走了代理,不能据此断定此前的域名解析也走了同一路径。排查时分别看操作系统和应用内的解析设置,并对照内核日志确认查询有没有经过预期的解析器。
DNS 分流(nameserver-policy)
DNS 分流按查询的域名选择上游解析器。比如让内网域名交给能识别它的组织内解析器,其余域名沿用常规上游。这一步决定谁回答查询,不等于决定访问该地址时走直连还是代理,后者还要看连接规则。

订阅与节点

能拉取、能解析、能连接,是三个不同的检查结果。

订阅
订阅是客户端定期获取配置或节点列表的入口,通常表现为一个链接。完整配置可以包含规则和策略组,节点列表则可能需要交给现有配置使用。导入前先确认客户端接受哪种格式;分享排障截图时,不要把订阅链接一并贴出。
节点
节点是一个可被内核选来转发连接的远端代理条目。名称主要供界面显示和配置引用,建立连接要用到服务器地址、端口和协议参数。列表里看得到名称,只说明条目已经加载;是否能用还要看远端连通和认证结果。
节点延迟
客户端显示的节点延迟通常是通过该节点访问测试地址时测得的响应耗时。它不是单纯对节点地址做连通探测,也不能直接换算成下载速度。比较时用相同的测试地址和接入网络;一次超时只能说明当次探测没有按时完成。
订阅更新
订阅更新是重新拉取远端内容,并由客户端解析后替换或更新订阅数据的过程。请求超时先查到订阅地址的网络,返回内容无法导入则先查响应格式。更新成功后如果策略组仍显示旧条目,再核对当前启用的配置是否引用了这份订阅。