先在 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
改策略前,先确认是否命中
要让一个子域名直连,先确认请求的主机名,再把它的 DOMAIN 规则移到能覆盖它的 DOMAIN-SUFFIX 之前。不要先改 FINAL:已经被前序规则选中的请求不会走到末尾。
DIRECT:该请求直连目标,不经所选代理转发。PROXY:该请求经代理转发;测试前在 Home 核对当前所选代理。命中这条规则不等于代理可用,也不等于目标已经响应。REJECT:拒绝匹配到的请求。它不是把请求交给代理处理,也不是在连接失败后改走的线路。
域名匹配:DOMAIN、DOMAIN-SUFFIX 和 DOMAIN-KEYWORD
只处理一个确定的主机名时选 DOMAIN;要覆盖根域名和子域名时选 DOMAIN-SUFFIX;只有确实要匹配多个域名里的同一段字符时,才用 DOMAIN-KEYWORD。后缀匹配按域名标签边界判断,关键字匹配则不要求片段正好占一个标签。
| 条件 | 匹配示例 | 不匹配示例 |
|---|---|---|
DOMAIN,docs.example.com | docs.example.com | cdn.docs.example.com、example.com |
DOMAIN-SUFFIX,example.com | example.com、api.example.com | notexample.com、example.com.example.net |
DOMAIN-KEYWORD,example-test | cdn-example-test.example.net | exampletest.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。例如目标 IP192.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 下验证首条命中
先写出每个测试目标的预期策略,再修改规则。需要模拟一条具体例外时,选自己能确认正常访问的目标;不要把文档保留网段当成可连通的服务。编辑前保留原配置,避免把规则顺序和连通性两个变量一起改动。
核对配置
进入 Config,确认当前使用的配置文件。若要测试
PROXY,也在 Home 确认已选择自己已有的可用代理。保存规则
在当前配置的
[Rule]段加入一条精确例外,让它排在可能覆盖该目标的后缀、关键字或地址规则之前,并把FINAL保留在末尾。切到 Config
在 Home → Global Routing 选择 Config。不要把 Proxy 或 Direct 模式下的结果当作规则验证;若原来用 Scene,先显式切到 Config,排除场景选择的影响。
新建请求
分别请求精确例外、同后缀的另一主机,以及不满足前面任何条件的目标。按本文示例,预期分别是
DIRECT、PROXY、FINAL指定的PROXY。如第三个目标先命中GEOIP,应另选目标来测试兜底。比对结果
查看新请求对应的连接记录,核对实际主机名、策略与可见的匹配信息。若页面只是从缓存显示,或者复用了旧连接,不能据此判断新规则是否生效;结束旧连接后再测。
规则不生效:区分策略、DNS 与连接错误
如果同一主机走错策略,先检查活动配置、Global Routing 和规则次序;如果策略正确但请求失败,再查 DNS 或连接。下面是 Chromium 浏览器可能显示的错误原文,不是 Shadowrocket 的规则校验提示。单凭浏览器报错不能认定是哪一行规则造成的。
报错: ERR_NAME_NOT_RESOLVED
原因:浏览器未能取得请求域名的可用解析结果。解法:先核对请求里的主机名是否拼错,再检查当前解析设置;不要先把 FINAL 改为另一种策略来验证拼写或 DNS。
报错: ERR_CONNECTION_TIMED_OUT
原因:连接在等待期限内未建立,目标或当前转发路径可能未响应。解法:先核对新请求是否走预期策略,再用同一策略测试一个已知可达的目标,区分单一目标超时和整条路径不可用。
如果两个目标最后都走 PROXY,单看策略名称无法区分是后缀规则命中还是 FINAL 兜底。优先看记录里的匹配信息;若当前记录不显示具体规则,可在测试副本中只调整待验证的那一条规则,对你能控制的测试目标发起新请求,比较改动前后的策略,再恢复原配置。