代理规则不生效怎么办?一张表定位模式、顺序与 DNS 问题
简答:代理规则不生效时,先看连接面板:请求没出现,查系统代理、浏览器独立代理、终端变量或 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,单独修改分流规则可能看不到效果。
- 桌面客户端:确认系统代理已经开启,并记录 HTTP、SOCKS 或 mixed 端口。检查绕过列表是否排除了目标域名。
- 浏览器:确认浏览器没有单独设置另一组代理。浏览器扩展或内置代理可能不读取系统代理。
- 终端:用显式代理参数测试,不要先假设终端会自动继承系统代理。
- 游戏和不遵循系统代理的应用:检查 TUN 是否启用,以及 TUN 是否覆盖该应用的流量。
- 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 相关设置。
- 记录当前
enhanced-mode、fake-ip-range、IPv6 开关和fake-ip-filter。 - 刷新 DNS 缓存和 fake-ip 映射后,重复访问同一个域名。mihomo API 文档列出了 DNS 与 fake-ip 缓存刷新接口,可参考mihomo 官方 API 说明。
- 临时关闭 TUN,只保留系统代理测试;若恢复,重点查 TUN 路由、DNS 劫持、防火墙或应用纳入范围。
- 临时关闭系统代理,只保留 TUN 测试;若恢复,重点查系统代理端口、绕过列表或浏览器独立代理。
- 如果 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.commacOS:
nc -vz 127.0.0.1 7890
traceroute example.com
curl -x http://127.0.0.1:7890 -I https://example.comLinux:
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 配置授权、按应用规则和网络切换后的连接状态。确认流量进入客户端后,再检查域名规则。