本文适合已经导入自己已有服务信息、准备在 Shadowrocket(小火箭)中调整分流的用户。先确认 Home → Global Routing 使用 Config,再理解规则顺序、域名与 IP 条件以及 FINAL 的位置,最后用单条请求核对实际命中结果。示例域名与地址仅用于说明语法,不能作为可用服务信息。
先确认 Config 分流是否启用
规则写入文件并不等于规则已经参与当前连接。Home 管理连接与服务选择,Config 管理配置文件,Settings 管理应用设置。排查前需要分别确认“当前启用哪份配置”和“当前使用哪种 Global Routing 姿态”,不要只看文件里有没有刚添加的一行。
Global Routing 下的 Proxy、Direct、Config、Scene 是连接采用的工作姿态;规则行中的大写 PROXY、DIRECT、REJECT 则是匹配后的策略。两组词所处层级不同。本文讨论的是 Config 姿态下,当前生效配置中 Rule 列表的顺序。
| Global Routing | 检查重点 | 与本文规则的关系 |
|---|---|---|
| Config | 确认 Config 中当前启用的文件 | 按配置中的规则执行分流,是本文验证使用的姿态。 |
| Proxy | 确认当前选择的代理服务可用 | 以代理姿态处理连接,不能用它验证完整的 Config 分流顺序。 |
| Direct | 确认设备当前网络能否直接访问目标 | 以直连姿态处理连接,不用于验证规则中的 PROXY 是否命中。 |
| Scene | 检查当前生效的场景及其设置 | 先确认场景实际采用的行为,再分析配置规则,不能只看 Scene 名称推断结果。 |
Settings → On Demand 处理按需连接条件,不负责把一条域名规则提到另一条前面。测试期间应保持连接状态稳定,避免网络切换触发连接变化后,把连接状态问题误判为规则不生效。
匹配优先级:第一条命中即停止
Rule 列表不是按“域名一定比 IP 优先”或“越长的规则自动优先”排序。对于能够判断匹配条件的请求,Shadowrocket 从上往下检查规则,第一条命中后采用该行策略,不再让后面的普通规则覆盖它。因此,具体例外通常需要放在宽泛条件之前。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
当请求的域名是 api.example.com 时,第一行域名规则已经命中,结果是 DIRECT。访问 www.example.com 时,第一条不匹配,第二条后缀规则命中,结果是 PROXY。访问 example.net 且前面均不匹配时,才会落到 FINAL。
如果把上例第二行移到第一行之前,api.example.com 也会先命中后缀规则,后面的精确域名规则便失去作用。这就是“规则存在但没有生效”的常见原因:不是语法错误,而是请求已经被上方条件接走。
规则写法:域名、地址段与地区条件
普通规则通常按“类型、匹配内容、策略”书写,使用英文逗号分隔,一行一条。不要用中文逗号,也不要把多个域名用空格塞进同一个匹配字段。FINAL 是例外,它没有域名或地址条件,直接跟策略。
域名与兜底
- DOMAIN
- api.example.com,DIRECT
- DOMAIN-SUFFIX
- example.com,PROXY
- FINAL
- PROXY
以上为关键字与后续字段的对应关系;写入文件时用英文逗号连接。
IP 条件与解析
- IP-CIDR
- 192.0.2.0/24,DIRECT,no-resolve
- GEOIP
- CN,DIRECT
- no-resolve
- 不为这条 IP 规则主动触发域名解析
192.0.2.0/24 是文档示例地址段,不代表实际应直连的服务网络。
- DOMAIN-SUFFIX:
DOMAIN-SUFFIX,example.com,PROXY匹配example.com以及它的子域名。字段里不写https://、路径或端口,也不需要写成*.example.com。 - IP-CIDR:
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve按 IPv4 地址段匹配。/24表示前缀长度,不是端口。IPv6 地址段应使用相应的IP-CIDR6类型。 - GEOIP:
GEOIP,CN,DIRECT按 IP 地区数据库判断,不能根据网站界面语言、域名后缀或公司注册地推断一定命中。 - FINAL:
FINAL,PROXY接住前面均未命中的请求,不应写成FINAL,example.com,PROXY。
域名规则需要匹配时能获得相应域名信息;IP 规则需要可用于判断的目标地址。对域名请求,是否触发解析还与规则选项及 DNS 设置有关。添加 no-resolve 可以避免该条 IP 规则主动要求解析,但不能据此推断所有域名请求都能命中该地址段。遇到不同访问方式结果不同,应先检查记录里的实际目标是域名还是 IP。
PROXY、DIRECT、REJECT 与 FINAL 的组合
PROXY 表示交给代理策略处理,具体出口取决于当前服务选择或配置中引用的策略设置;DIRECT 表示直接连接目标;REJECT 表示拒绝请求。它们都不是“自动修复连接”的按钮:PROXY 不能让错误的服务参数变正确,DIRECT 也不能保证当前网络可以到达所有目标。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,blocked.example.net,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
此片段只演示 Rule 段,不是完整配置。已有文件包含 [Rule] 时,应把需要的规则合入原段,不要机械地再粘贴一个同名段。示例把精确域名放在较宽的后缀条件前,再放地址与地区条件,最后保留 FINAL。真实顺序应服从用户自己的访问要求,而不是把示例当成通用策略。
FINAL 的两种兜底选择
FINAL,PROXY
- 前面明确列出需要 DIRECT 或 REJECT 的目标。
- 其余未匹配请求交给代理策略。
- 应确认当前选择的代理服务及协议参数可用。
FINAL,DIRECT
- 前面明确列出需要 PROXY 或 REJECT 的目标。
- 其余未匹配请求使用设备当前网络直连。
- 新目标未加入规则时,不会自动走代理策略。
两种写法改变的是未匹配流量的去向;选择其中一种,并将 FINAL 放在普通匹配规则之后。
FINAL 本身没有条件。如果它出现在列表中间,走到这一行的请求就已经确定策略,后面的普通规则没有机会再处理这些请求。若文件存在多条 FINAL,先清理为一条明确的末尾兜底,再继续排查其他规则。
修改与验证:一次只改变一个条件
以下操作以 Home、Config、Settings 的页面结构为参照;不同平台的编辑控件位置可能不同,应以当前页面实际提供的文件操作为准。验证前保留原文件副本,记录测试目标、预期策略和实际结果,避免一次改动多个条件后无法定位原因。
-
保留副本
进入 Config,找到当前使用的配置文件,先通过文件操作保存副本或导出备份。远程配置宜保留一份独立的本地测试副本,避免后续更新覆盖实验内容。
-
编辑规则
在 Config 打开目标文件的编辑功能,定位
[Rule]。把一条具体域名规则放到宽泛后缀规则之前,检查英文逗号、策略拼写及末尾 FINAL,然后保存。 -
确认启用
在 Config 确认刚保存的文件处于启用状态,再到 Home → Global Routing 选择 Config。仅编辑副本而未启用副本,不会改变正在使用的配置。
-
重新建连
结束测试应用对目标的旧连接,必要时关闭后重新打开 Shadowrocket 的连接开关,再发起一次新请求。已有连接可能继续沿用建立时的策略,不能只刷新一个复用连接的页面就下结论。
-
核对记录
查看应用提供的连接记录或日志,按测试时间定位目标域名或 IP,核对实际策略及可见的匹配信息。若请求发生重定向,应分别检查原域名与跳转后的域名。
验证标准应是“指定目标的新连接是否采用预期策略”,不是网页是否恰好打开。例如新连接已显示 PROXY 但握手失败,应转向检查用户已有服务的连接参数;新连接显示 DIRECT 且命中上方宽规则,则应先调整规则顺序。两种现象的排查方向不同。
规则不生效时的具体检查项
已经加了 DIRECT,为什么还是 PROXY?
先在 Home → Global Routing 确认 Config,再到 Config 核对启用文件。随后搜索目标域名,检查上方是否存在更宽的 DOMAIN-SUFFIX 或提前出现的 FINAL。将具体例外移到宽规则前,保存后使用新连接复测。
同一个网站,为什么有的请求走了别的策略?
查看连接记录中的完整域名。主页面、图片、登录接口可能使用不同域名;匹配 example.com 的规则不会自动涵盖独立的 example.net。按实际请求补充必要条件,不要只根据浏览器地址栏判断全部流量。
为什么 IP-CIDR 没有拦到域名请求?
检查记录中的目标地址是否属于该网段、是否使用 IPv6,以及该条是否带 no-resolve。域名解析可能返回多个地址;不要用另一次解析得到的单个地址推断当前连接。目标稳定为域名时,可以先用精确 DOMAIN 规则验证。
更新后自定义规则怎么消失了?
先区分更新的是 Home 中已有服务订阅,还是 Config 中的远程配置。前者与 Rule 文件不是同一对象;后者可能重新拉取文件内容。检查当前文件来源及启用状态,恢复本地备份后,决定继续维护独立配置还是采用该远程配置提供的更新方式。