Mihomo代理规则不生效怎么排查?按连接、规则、策略组和DNS定位
简答:先确认目标应用的连接是否出现在Mihomo连接面板;没有记录时先查系统代理、应用代理或TUN入口。已有记录但走错线路时,检查当前是否为Rule模式、规则上下顺序、右侧策略组名称、RULE-SET加载状态,最后再对照DNS、fake-ip和no-resolve。
定义:Mihomo代理规则不生效,是指流量已经进入内核,但没有按预期命中规则、策略组或最终出站代理。
先试这一步:用连接记录判断问题在哪一层
本文是第三方使用指南,不是任何客户端或服务的官方页面。本文核对日期:2026-11-14。先不要修改整份配置,打开当前客户端的连接面板或实时日志,访问一个明确用于测试的域名,然后记录四项:目标域名、命中的规则、rulePayload(如果界面显示)、最终策略组或节点。
| 现象 | 优先判断 | 先做什么 |
|---|---|---|
| 连接面板完全没有记录 | 流量没有进入Mihomo | 检查系统代理、应用代理、TUN、其他VPN和应用绕过设置 |
| 有记录但命中MATCH | 前面的规则没有匹配 | 核对域名拼写、规则类型、规则顺序和最终配置 |
| 命中规则但显示DIRECT | 右侧策略组或模式导致直连 | 检查Rule模式、策略组名称及组内成员 |
| 命中代理组但节点失败 | 规则有效,出站连接失败 | 单独测试策略组成员、节点连通性和UDP支持 |
| RULE-SET没有命中 | 规则集未加载或格式不匹配 | 查看更新日志、路径、behavior、format和规则数量 |
Mihomo的路由规则按配置文件从上到下匹配,顶部规则优先级更高,MATCH会匹配所有请求,因此通常应放在规则末尾。官方规则文档还说明,目标IP类规则可能触发DNS解析,而no-resolve可跳过该解析。参考:路由规则。
第一层:确认配置已激活、模式正确且流量进入内核
- 确认当前配置确实已启用。在客户端中重新选择目标配置并执行一次更新或载入;如果客户端有“当前配置”“运行配置”或“最终配置”查看入口,以该内容为准,不要只看订阅原文。没有这类入口时,可在运行日志中寻找配置加载成功或错误信息。若出现
yaml: unmarshal errors、parse config failed等报错,先修复语法,不要继续判断规则命中。 - 确认模式是Rule。将Global和Direct只作为对照测试,不要把对照结果当作最终配置。Rule模式负责按规则选择出站;Global通常会把流量交给当前选中的全局代理组,Direct则可能绕过预期代理。Mihomo全局配置文档将
rule列为规则匹配模式,具体客户端菜单名称可能不同,应以当前界面为准。参考:全局配置。 - 重新建立连接。切换模式或配置后,关闭目标网页、应用内连接或长连接,再重新访问测试域名。旧连接可能仍显示此前的出站结果。
- 确认端口入口。Windows执行:
Get-NetTCPConnection -State Listen | Sort-Object LocalPort | Format-Table -AutoSize;macOS执行:lsof -nP -iTCP -sTCP:LISTEN;Linux执行:ss -lntup。预期能看到客户端配置中对应的HTTP、SOCKS、mixed或TUN相关监听。若命令无输出,可能是端口未监听、权限不足或客户端未启动;macOS/Linux可在需要时加sudo,Windows则使用管理员PowerShell。撤销方法:这些是只读检查命令,不会修改配置。
如果连接面板仍然没有记录,优先处理接入问题:浏览器是否单独设置了代理,应用是否启用了“不使用代理”,TUN是否被其他VPN或防火墙拦截。原生内核和图形客户端的入口、权限和TUN实现可能不同,不能把某个客户端的菜单路径当成Mihomo固定功能。
第二层:用最小规则验证顺序、规则类型和策略组名称
先备份当前配置。假设配置文件路径为/path/to/config.yaml,请替换成实际路径。
- Windows PowerShell:
$src = 'C:\path\to\config.yaml'; Copy-Item -LiteralPath $src -Destination ($src + '.before-rules') -Force - macOS/Linux:
src='/path/to/config.yaml'; cp -- "$src" "$src.before-rules"
变量和备份命令必须在同一个终端会话中执行;如果新开窗口,必须重新定义$src或src。确认备份文件存在后,再用一个最小配置片段做对照。下面示例只展示规则结构,节点部分请替换为当前配置已有的有效节点:
mode: Rule
proxy-groups:
- name: TEST-PROXY
type: select
proxies:
- YOUR-NODE-NAME
- DIRECT
rules:
- DOMAIN,example.com,TEST-PROXY
- DOMAIN-SUFFIX,example.org,TEST-PROXY
- IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
- MATCH,DIRECT验证时访问example.com或你自己控制的测试域名,并在连接详情中确认命中DOMAIN或DOMAIN-SUFFIX,最终策略为TEST-PROXY。如果显示MATCH,说明前面的域名没有按预期匹配;如果提示找不到策略组,重点核对规则右侧的TEST-PROXY与proxy-groups.name是否逐字一致,包括大小写、空格和标点。
DOMAIN匹配完整域名,DOMAIN-SUFFIX匹配域名后缀;例如官方文档说明,DOMAIN-SUFFIX,google.com可以匹配主域名及其子域名,但不会匹配content-google.com。不要把规则文件中的通配符写法直接等同于路由规则语法。参考:Route Rules。
第三层:RULE-SET和rule-providers不生效时逐项核对
如果单条DOMAIN规则能命中,而RULE-SET不能命中,问题通常集中在规则集定义或内容格式。逐项检查以下字段:
| 字段 | 检查标准 | 典型现象 |
|---|---|---|
| 名称 | rules中的RULE-SET名称必须与rule-providers下的键完全一致 | 配置能加载,但规则集不命中 |
| type | 远程规则通常为http,本地文件通常为file,内嵌内容为inline | 更新失败或找不到内容 |
| url/path | 远程地址可访问;本地路径在Home Dir或允许路径内 | timeout、403、file not found |
| behavior | 根据内容选择domain、ipcidr或classical | 规则集加载但实际没有匹配 |
| format | 按实际内容选择yaml、text或mrs,不要只看文件扩展名 | 解析错误或规则数量为零 |
| interval | 确认更新间隔和最后更新时间 | 修改远程文件后客户端仍使用旧缓存 |
官方文档列出了http、file和inline类型,并说明behavior可为domain、ipcidr或classical;规则集合内容也必须符合相应格式。参考:Rule-Providers和rule-providers内容格式。
rule-providers:
test-domain:
type: file
path: ./rules/test-domain.yaml
behavior: classical
format: yaml
rules:
- RULE-SET,test-domain,TEST-PROXY
- MATCH,DIRECT对应的test-domain.yaml可以是:
payload:
- DOMAIN-SUFFIX,example.com或者使用文本格式时,内容应与所声明的格式一致。出现403先检查URL是否需要鉴权;出现timeout先检查当前网络是否能访问该地址;出现behavior mismatch或规则数量异常,先把behavior和实际文件内容对照。不要删除旧缓存作为第一步,先备份并保留回滚文件。
第四层:DNS、fake-ip、IP规则和TUN导致的误判
如果日志中看到的是IP地址,而不是目标域名,域名规则可能无法按你预期工作;这不一定代表规则语法错误。重点区分以下情况:
- 域名规则未命中:先用
DOMAIN或DOMAIN-SUFFIX做最小测试,并确认应用实际访问的域名。有些应用会访问多个CDN或API域名,浏览器地址栏的域名不一定是连接详情中的唯一目标。 - IP-CIDR或GEOIP触发DNS解析:官方规则文档说明,目标IP类规则在域名匹配过程中可能触发DNS解析;加入
no-resolve会跳过该解析,但也可能使依赖解析结果的IP规则不再匹配。因此应以对照测试判断,不要机械添加。 - fake-ip与redir-host不同:DNS文档将
fake-ip和redir-host列为可选增强模式。fake-ip会为域名返回映射地址,某些应用、局域网域名或特殊过滤规则需要单独处理。 - TUN接管不完整:系统代理生效不代表所有应用都进入内核;反过来,TUN也可能被应用绕过、其他VPN、系统防火墙或权限策略影响。切换TUN前先保存原配置,并且每次只改变一个变量。
可采用以下对照顺序:保持同一域名不变,先在Rule模式测试;再只切到Global记录结果;最后只切到Direct记录结果。每次切换后关闭旧连接并重新访问。若Rule和Global都能建立代理连接,而Direct也表现相同,重点回到测试域名、应用缓存或实际出口核对;若只有Global有效,优先检查规则、策略组名称和规则集加载。
Mihomo官方DNS文档还说明,fake-ip-filter-mode支持blacklist、whitelist和rule,而规则模式下的过滤语法与路由规则逻辑相关。参考:DNS configuration。
第五层:确认策略组和节点本身没有把正确规则变成失败连接
规则命中不等于节点一定可用。检查连接详情中的最终策略组,再打开该组确认至少有一个可用成员。常见问题包括:
- 规则右侧写的是
PROXY,但配置中实际策略组叫Proxy或带有空格; - 策略组存在,但成员列表为空,或订阅节点尚未加载;
- 选择的是
DIRECT,导致误以为规则没有生效; - 节点能建立TCP连接,但目标应用使用UDP,而当前节点或配置不支持UDP;
- url-test或fallback组的健康检查目标可达,但不代表目标网站或应用业务连接一定可用。
如果策略组显示正确但最终连接失败,先在策略组中手动选择一个已知可用成员,再重新建立连接。若手动选择后恢复,问题更接近策略组选择或健康检查;若仍失败,转向节点、DNS、MTU、TUN或本地网络排查。不要因为单个节点失败就立即改写全部规则。
完成验证后回滚:关闭客户端或停止使用该配置,将备份文件恢复为原文件。Windows PowerShell可执行:$src = 'C:\path\to\config.yaml'; $bak = $src + '.before-rules'; Copy-Item -LiteralPath $bak -Destination $src -Force;macOS/Linux可执行:src='/path/to/config.yaml'; bak="$src.before-rules"; cp -- "$bak" "$src"。这些变量必须在同一个终端会话中重新定义,恢复后重新载入原配置并确认连接记录恢复正常。
一张速查卡:看到什么现象,就查什么
| 连接详情 | 最可能的层级 | 下一步 |
|---|---|---|
| 没有任何记录 | 流量入口 | 查系统代理、应用代理、TUN、其他VPN和绕过列表 |
| 命中MATCH | 规则顺序或语法 | 把测试规则放到MATCH之前,检查域名和最终配置 |
| 命中错误的DIRECT | 模式或策略组 | 确认Rule模式,核对右侧组名及组内选择 |
| RULE-SET更新报错 | 远程地址或权限 | 看timeout、403、permission denied和返回内容 |
| RULE-SET加载但规则数量异常 | behavior或format | 对照规则文件实际内容,不要只看扩展名 |
| 命中正确但打不开 | 节点、DNS、TUN或MTU | 固定规则不变,单独测试策略组成员和网络链路 |
最快的定位原则是:先问“有没有连接”,再问“命中哪条规则”,然后问“右侧策略组是否存在且可用”,最后才检查DNS、fake-ip、TUN和节点。这样可以避免把流量根本没有进入内核的问题,误判为规则格式问题。
常见问题
Mihomo规则命中了MATCH,说明规则完全失效了吗?
不一定。MATCH是兜底规则,通常说明它之前的规则没有匹配,也可能是客户端没有载入你修改的最终配置。先确认当前运行配置,再检查规则顺序、域名拼写、规则类型和策略组名称。
RULE-SET加载成功但为什么还是不命中?
重点核对RULE-SET名称是否与rule-providers键完全一致,behavior是否符合文件内容,format是否正确,以及规则文件是否真的包含目标域名。先用单条DOMAIN-SUFFIX规则验证流量入口,再单独验证规则集。
fake-ip会导致域名规则不生效吗?
可能造成误判,但不能直接认定是唯一原因。先在连接详情中确认实际目标是域名还是IP,再保持其他配置不变,对照测试fake-ip和redir-host。涉及IP-CIDR规则时,还要注意DNS解析和no-resolve的影响。
切换Global后能上网,是否说明Rule模式坏了?
这通常说明节点或基本流量入口可能可用,但不能单独证明Rule模式损坏。还需要查看Rule模式下的连接记录、命中规则和最终策略组;如果Global有效而Rule命中MATCH或DIRECT,应优先检查规则顺序、模式和策略组引用。