全球网络加速服务|低延迟海外网络连接|Oumei.tat 欧米伽

代理规则不生效怎么办?一张表定位模式、顺序与 DNS 问题

更新于 2026-11-15 · huaguoshan.buzz

简答:代理规则不生效时,先看连接面板:请求没出现,查系统代理、浏览器独立代理、终端变量或 TUN;请求出现但走错出口,查 Rule 模式、规则顺序、规则类型和策略组名称;若出现 DNS 异常,再核对 fake-ip、IPv6 与 DNS 设置。

定义:代理规则不生效,是指流量未进入代理客户端、未命中预期规则,或命中后仍使用了错误出口。

先看这张表:五分钟判断卡在哪里

不要先重装客户端或大范围改配置。打开客户端的“连接”“日志”或“Connections”页面,访问一个明确的测试域名,再按下面的现象分流。不同图形客户端的菜单名称可能不同,以下内容以 mihomo 内核的规则、DNS 和 TUN 逻辑为准,具体入口以本机界面显示为准。

代理规则不生效的四类常见现象与下一步
现象优先判断下一步
连接记录完全没有目标请求流量没有进入当前客户端检查 Rule 模式、系统代理、浏览器独立代理、终端变量或 TUN
请求出现,但命中 DIRECT 或错误规则规则顺序、类型或域名写法不匹配核对 DOMAIN、DOMAIN-SUFFIX、IP-CIDR、RULE-SET 和 MATCH 的先后关系
命中目标策略组,但连接失败策略组名称、节点或当前选择有问题检查 proxy-groups 是否存在,组内是否有可用出口
解析结果异常、访问超时或只在 TUN 开启时失败DNS、fake-ip、IPv6 或 TUN 路由影响记录当前 DNS 模式,分别对比 TUN 开关和 fake-ip 配置

mihomo 的路由规则按配置顺序匹配,因此应先确认实际命中的规则,再修改 YAML。可参考mihomo 官方路由规则说明核对规则类型和优先级。

第一步:确认模式和流量入口没有选错

先把运行模式切到 Rule。Global 通常按统一代理策略处理流量,Direct 则可能绕过代理规则;如果当前不是 Rule,单独修改分流规则可能看不到效果。

  1. 桌面客户端:确认系统代理已经开启,并记录 HTTP、SOCKS 或 mixed 端口。检查绕过列表是否排除了目标域名。
  2. 浏览器:确认浏览器没有单独设置另一组代理。浏览器扩展或内置代理可能不读取系统代理。
  3. 终端:用显式代理参数测试,不要先假设终端会自动继承系统代理。
  4. 游戏和不遵循系统代理的应用:检查 TUN 是否启用,以及 TUN 是否覆盖该应用的流量。
  5. iOS 与 Android:检查 VPN 权限、分应用代理、系统私人 DNS 或专用 DNS 设置;如果连接面板没有请求,先确认 VPN 图标和客户端授权状态。

mihomo 的 TUN 配置包含 auto-route、dns-mode、dns-hijack、MTU、include-package 和 exclude-package 等选项,说明不同系统和应用可能需要单独排除或纳入路由。可查看mihomo 官方 TUN 配置说明。

跨平台显式验证:

Windows PowerShell:
curl.exe -x http://127.0.0.1:7890 -I https://example.com

macOS:
curl -x http://127.0.0.1:7890 -I https://example.com

Linux:
curl -x http://127.0.0.1:7890 -I https://example.com

上面是脱敏示例,7890 需替换为客户端实际的 HTTP 或 mixed 端口。curl 官方命令说明中,-x 或 --proxy 会显式指定代理;使用环境变量时,curl 不读取大写的 HTTP_PROXY,应检查小写 http_proxy。HTTPS_PROXY、https_proxy以及 NO_PROXY、no_proxy也要一并核对,后两者可能把目标域名排除在代理之外。详见curl 官方命令与代理参数说明。

第二步:修正规则顺序、类型和策略组引用

精确域名例外要放在后缀规则之前。下面是包含代理占位定义的脱敏示例;其中服务器地址、端口和认证信息仅用于展示字段结构,不能直接作为可用节点使用。

proxies:
  - name: node-example
    type: http
    server: proxy.example.test
    port: 443

proxy-groups:
  - name: ProxyGroup
    type: select
    proxies:
      - node-example
      - DIRECT

rules:
  - DOMAIN,api.example.test,DIRECT
  - DOMAIN-SUFFIX,example.test,ProxyGroup
  - MATCH,DIRECT

这个顺序表示:只有完整匹配 api.example.test 时走 DIRECT;其他 example.test 及其子域名再进入 ProxyGroup。如果把两条规则颠倒,后缀规则会先命中,后面的精确域名例外不会生效。

规则目标名称必须与 proxy-groups 中的 name 完全一致,组内引用的代理名称也必须出现在 proxies、代理提供者或可用内置目标中。可对照mihomo 官方策略组配置说明检查名称、类型和代理列表。

规则类型选择与常见改法
规则类型适合场景错误可改进
DOMAIN只匹配一个完整域名想覆盖所有子域名却只写主机名改为 DOMAIN-SUFFIX,example.test,ProxyGroup
DOMAIN-SUFFIX匹配主域名及其子域名把普通关键词误当作域名后缀需要按关键词匹配时改为 DOMAIN-KEYWORD
IP-CIDR日志中已出现目标 IP 时忽略 DNS 解析行为按需求增加 no-resolve,并结合日志确认
PROCESS-NAME按进程名分流客户端或当前模式不支持进程识别先确认运行平台、TUN 和内核支持情况
RULE-SET集中引用规则集合provider 未定义或加载失败先定义 rule-providers,再引用对应名称

如果规则来自订阅,手动编辑生成文件可能在更新后被覆盖。优先使用客户端提供的覆写、Merge、Override 或脚本入口;Clash Verge Rev、Mihomo Party 等图形客户端的入口名称和支持范围可能不同,应以本机界面为准。

第三步:看日志证据,不要只看网页能不能打开

日志排查要回答三个问题:目标请求有没有出现、命中了哪条规则、最终使用哪个策略组。mihomo 面板中可能看到类似下面的连接记录,具体字段和措辞会随内核版本、客户端封装和日志级别变化:

--> api.example.test:443 match DOMAIN(api.example.test) using DIRECT
--> cdn.example.test:443 match DOMAIN-SUFFIX(example.test) using ProxyGroup[node-example]

上面是日志格式示意,不是固定逐字输出。看到 match、规则类型、目标内容、策略组和节点,通常可以判断请求是否按预期分流;若只看到启动失败、配置解析失败或连接拒绝,则应先处理内核或出口问题。

  • 没有目标请求:查流量入口,重点看系统代理、浏览器代理、终端环境变量、VPN 权限和 TUN。
  • 命中错误规则:查前方是否有更早的 DOMAIN、DOMAIN-SUFFIX、RULE-SET 或 MATCH。
  • 命中正确规则但超时:查策略组当前节点、端口、节点协议、防火墙、DNS 和 MTU。
  • 出现配置解析错误:检查 YAML 缩进、列表层级、字段拼写以及策略组和代理名称。
  • 订阅更新后恢复旧状态:检查手动规则是否写入了会被覆盖的生成文件,并改用覆写或 Merge 入口。

如果使用官方控制面板,项目说明区分了 Clash 日志和内核进程日志:前者用于观察代理决策、规则匹配和 DNS,后者用于启动信息、崩溃和配置解析错误。可查看MetaCubeX 控制面板官方说明。

第四步:区分 fake-ip、DNS 和 TUN 的影响

fake-ip 模式下,DNS 查询可能返回映射地址。mihomo DNS 文档给出的 fake-ip-range 默认 IPv4 示例是 198.18.0.1/16,但该范围可以由配置修改。因此看到 198.18 开头的结果时,先查看自己的 fake-ip-range,不要只凭地址段判断 DNS 故障。

应把 DNS 查询结果与连接面板中的原始域名、命中规则和最终出口一起看。可参考mihomo 官方 DNS 配置说明了解 fake-ip、redir-host、fake-ip-filter 和 IPv6 相关设置。

  1. 记录当前 enhanced-mode、fake-ip-range、IPv6 开关和 fake-ip-filter。
  2. 刷新 DNS 缓存和 fake-ip 映射后,重复访问同一个域名。mihomo API 文档列出了 DNS 与 fake-ip 缓存刷新接口,可参考mihomo 官方 API 说明。
  3. 临时关闭 TUN,只保留系统代理测试;若恢复,重点查 TUN 路由、DNS 劫持、防火墙或应用纳入范围。
  4. 临时关闭系统代理,只保留 TUN 测试;若恢复,重点查系统代理端口、绕过列表或浏览器独立代理。
  5. 如果 WiFi 可用而蜂窝网络不可用,对比 IPv4、IPv6、TCP、UDP 和端口;运营商网络限制因地区和网络环境而异,需以本地自测为准。

DNS 解析、规则匹配和代理连接不是同一层。TUN 场景下,DNS 处理还可能受到 fake-ip 模式影响;可结合mihomo 官方 DNS 处理流程判断请求是在解析、匹配还是连接阶段失败。

Windows、macOS、Linux 与移动端的核验命令

以下命令主要验证本机代理端口和路径,不代表远端节点一定可用。tracert 或 traceroute 在 TUN、fake-ip 或 DNS 劫持环境下可能显示映射地址或不完整路径,不宜单独用来判定规则是否生效。

Windows PowerShell:

Test-NetConnection 127.0.0.1 -Port 7890
tracert example.com
curl.exe -x http://127.0.0.1:7890 -I https://example.com

macOS:

nc -vz 127.0.0.1 7890
traceroute example.com
curl -x http://127.0.0.1:7890 -I https://example.com

Linux:

nc -vz 127.0.0.1 7890
traceroute example.com
curl -x http://127.0.0.1:7890 -I https://example.com

如果端口连接失败,检查客户端是否运行、端口是否被改动或被其他程序占用;如果端口成功但连接面板没有请求,检查应用是否使用了另一代理入口。若终端中 http:// 请求不走代理而 https:// 正常,重点检查是否只设置了大写 HTTP_PROXY,以及 NO_PROXY 是否排除了目标域名。

Android 重点检查 VPN 权限、分应用代理、私人 DNS 和电池后台限制;iOS 重点检查 VPN 配置授权、按应用规则和当前网络切换后的重新连接状态。移动端没有连接记录时,优先处理 VPN 权限和应用是否被排除,不要先改域名规则。

验证完成标准:满足四项再结束排查

把修正后的结果按下面清单复核:

  • 连接面板能看到目标请求,而不是只看到浏览器缓存页面。
  • 日志显示了预期的规则类型、匹配内容和策略组。
  • 策略组名称存在,组内有可用出口,且当前选择没有处于失败状态。
  • 关闭代理、仅开系统代理、仅开 TUN 三种状态的结果差异符合预期。

四项都满足后,才适合恢复其他订阅规则或规则集。每次只恢复一组,并保留可以回滚的最小配置,这样更容易定位后续冲突。

常见问题

规则写对了,为什么还是走直连?

先看连接面板是否出现目标请求。没有请求时,先查系统代理、浏览器独立代理、终端变量、VPN 权限或 TUN;请求出现但命中 DIRECT 时,再查更早的规则、规则类型和当前是否为 Rule 模式。

DOMAIN 和 DOMAIN-SUFFIX 应该怎么选?

DOMAIN 用于一个完整域名,例如 api.example.test;DOMAIN-SUFFIX 用于主域名及其子域名。需要设置精确域名例外时,把 DOMAIN 放在 DOMAIN-SUFFIX 前面。

策略组名称存在,为什么规则仍然不生效?

检查规则目标名称是否与 proxy-groups 的 name 完全一致,并确认组内代理名称已经在 proxies、代理提供者或可用内置目标中定义。还要检查当前模式是否为 Rule,以及订阅更新是否覆盖了手动修改。

fake-ip 返回 198.18 开头的地址是不是 DNS 故障?

不一定。mihomo 文档中的默认 fake-ip-range 示例为 198.18.0.1/16,但该范围可配置。请先查看自己的 fake-ip-range,再结合原始域名、命中规则和最终出口判断。

为什么浏览器能走规则,终端却直连?

浏览器可能读取系统代理或使用独立代理,而终端需要单独设置。先使用 curl 的显式 -x 参数测试,再检查小写 http_proxy、HTTPS_PROXY、NO_PROXY 和 no_proxy,避免环境变量排除目标域名。

手机连接面板没有请求,应该先改规则吗?

不建议。Android 先查 VPN 权限、分应用代理、私人 DNS 和后台限制;iOS 先查 VPN 配置授权、按应用规则和网络切换后的连接状态。确认流量进入客户端后,再检查域名规则。

相关阅读

参考资料

  1. mihomo 官方路由规则说明
  2. mihomo 官方策略组配置说明
  3. mihomo 官方 TUN 配置说明
  4. mihomo 官方 DNS 配置说明
  5. mihomo 官方 DNS 处理流程
  6. mihomo 官方 API 说明
  7. curl 官方命令与代理参数说明
  8. MetaCubeX 控制面板官方说明