Shadowrocket 规则怎么写:DOMAIN-SUFFIX、GEOIP、IP-CIDR、FINAL 匹配逻辑入门

讲清 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 各自匹配什么,规则自上而下的命中顺序,以及 PROXY / DIRECT / REJECT 的写法。

本文速览

先在 Home → Global Routing 选择 Config,再检查当前配置文件的 [Rule]:规则自上而下检查,第一条命中就决定策略。本文适合已有配置、想新增域名例外或排查分流结果的读者。读完可按目标选规则类型,把窄范围例外放在宽范围规则之前,并用三组请求验证分流。

规则语法:匹配条件和策略分开写

在 [Rule] 段内,每行写一条规则。普通规则先写类型,再写匹配值和策略,用英文逗号分隔;FINAL 不需要匹配值,直接写策略。域名规则只填主机名或匹配片段,不填 https://、端口或路径。以下域名和地址用于演示写法,不用于验证连接是否可达。

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example-test,REJECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
3 种
本文对照的域名匹配类型
/24
保留 IPv4 地址的前 24 位作为网段前缀
2 个字段
FINAL 行只写类型和策略

改策略前,先确认是否命中

要让一个子域名直连,先确认请求的主机名,再把它的 DOMAIN 规则移到能覆盖它的 DOMAIN-SUFFIX 之前。不要先改 FINAL:已经被前序规则选中的请求不会走到末尾。

  • DIRECT:该请求直连目标,不经所选代理转发。
  • PROXY:该请求经代理转发;测试前在 Home 核对当前所选代理。命中这条规则不等于代理可用,也不等于目标已经响应。
  • REJECT:拒绝匹配到的请求。它不是把请求交给代理处理,也不是在连接失败后改走的线路。

域名匹配:DOMAIN、DOMAIN-SUFFIX 和 DOMAIN-KEYWORD

只处理一个确定的主机名时选 DOMAIN;要覆盖根域名和子域名时选 DOMAIN-SUFFIX;只有确实要匹配多个域名里的同一段字符时,才用 DOMAIN-KEYWORD。后缀匹配按域名标签边界判断,关键字匹配则不要求片段正好占一个标签。

条件匹配示例不匹配示例
DOMAIN,docs.example.comdocs.example.comcdn.docs.example.com、example.com
DOMAIN-SUFFIX,example.comexample.com、api.example.comnotexample.com、example.com.example.net
DOMAIN-KEYWORD,example-testcdn-example-test.example.netexampletest.example.net

表格只判断单条条件;实际策略还取决于规则位置。示例中的 docs.example.com 同时符合前两行条件,先遇到的是精确规则,所以走 DIRECT。如果把后缀规则调到前面,同一主机就会走 PROXY。Shadowrocket 不会先收集全部候选规则,再自动挑最具体的一条。

地址匹配:IP-CIDR、GEOIP 与 no-resolve

IP-CIDR 按目标 IPv4 地址所在的网段匹配,适合已知地址范围的目标。GEOIP 则根据 IP 数据库中的地区分类匹配目标地址;GEOIP,CN,DIRECT 不是按域名是否以 .cn 结尾判断,也不是按设备所在地区判断。域名的解析结果可能随网络或时间变化,因此想固定某个服务的分流策略时,优先写已知的域名规则。

  • 192.0.2.0/24 的匹配范围是 192.0.2.0 至 192.0.2.255。例如目标 IP 192.0.2.42 匹配该网段,192.0.3.42 不匹配。若只匹配前一个地址,可写 192.0.2.42/32。
  • 域名请求检查到地址规则时,如果还没有目标 IP,匹配可能需要先解析域名。示例中的 no-resolve 表示不为判断这条 IP-CIDR 规则而发起解析;若目标 IP 已可用,仍可按该地址判断。它不禁止后续规则或实际连接所需的 DNS 解析。
  • IP-CIDR 的这个 IPv4 网段不能覆盖 IPv6。如果同一主机在不同网络下表现不同,先核对连接实际使用的地址族和目标 IP,再判断是否是地址规则漏匹配。端口变了也不会改变这条网段规则的匹配范围。

把具体地址例外放在宽泛的 GEOIP 规则之前。若先写 GEOIP,CN,DIRECT,一个被数据库归入 CN 的目标可能已经选中 DIRECT,后面的网段例外就不会再检查。末尾的 FINAL 只处理尚未命中的请求,不会在前面的连接超时后重新分流。

在 Config 下验证首条命中

先写出每个测试目标的预期策略,再修改规则。需要模拟一条具体例外时,选自己能确认正常访问的目标;不要把文档保留网段当成可连通的服务。编辑前保留原配置,避免把规则顺序和连通性两个变量一起改动。

  1. 核对配置

    进入 Config,确认当前使用的配置文件。若要测试 PROXY,也在 Home 确认已选择自己已有的可用代理。

  2. 保存规则

    在当前配置的 [Rule] 段加入一条精确例外,让它排在可能覆盖该目标的后缀、关键字或地址规则之前,并把 FINAL 保留在末尾。

  3. 切到 Config

    在 Home → Global Routing 选择 Config。不要把 Proxy 或 Direct 模式下的结果当作规则验证;若原来用 Scene,先显式切到 Config,排除场景选择的影响。

  4. 新建请求

    分别请求精确例外、同后缀的另一主机,以及不满足前面任何条件的目标。按本文示例,预期分别是 DIRECT、PROXY、FINAL 指定的 PROXY。如第三个目标先命中 GEOIP,应另选目标来测试兜底。

  5. 比对结果

    查看新请求对应的连接记录,核对实际主机名、策略与可见的匹配信息。若页面只是从缓存显示,或者复用了旧连接,不能据此判断新规则是否生效;结束旧连接后再测。

规则不生效:区分策略、DNS 与连接错误

如果同一主机走错策略,先检查活动配置、Global Routing 和规则次序;如果策略正确但请求失败,再查 DNS 或连接。下面是 Chromium 浏览器可能显示的错误原文,不是 Shadowrocket 的规则校验提示。单凭浏览器报错不能认定是哪一行规则造成的。

报错: ERR_NAME_NOT_RESOLVED

原因:浏览器未能取得请求域名的可用解析结果。解法:先核对请求里的主机名是否拼错,再检查当前解析设置;不要先把 FINAL 改为另一种策略来验证拼写或 DNS。

报错: ERR_CONNECTION_TIMED_OUT

原因:连接在等待期限内未建立,目标或当前转发路径可能未响应。解法:先核对新请求是否走预期策略,再用同一策略测试一个已知可达的目标,区分单一目标超时和整条路径不可用。

如果两个目标最后都走 PROXY,单看策略名称无法区分是后缀规则命中还是 FINAL 兜底。优先看记录里的匹配信息;若当前记录不显示具体规则,可在测试副本中只调整待验证的那一条规则,对你能控制的测试目标发起新请求,比较改动前后的策略,再恢复原配置。

免费下载 Shadowrocket