Shadowrocket 规则怎么写:DOMAIN-SUFFIX、GEOIP、FINAL 等关键字匹配逻辑

逐个说明 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 匹配什么、按什么顺序生效,以及 PROXY / DIRECT / REJECT 的写法。

本文速览

Shadowrocket(小火箭)的规则应按“具体例外在前、宽泛条件在后、FINAL 收尾”编排,并在 Global Routing 选择 Config 后验证。本文适合已有自己的服务商与订阅、准备修改配置文件的用户:先辨认规则字段与策略,再用域名和 IP 示例核对匹配结果,最后区分规则未命中、DNS 失败和出站连接失败。

一、先启用 Config,再判断规则是否生效

写对规则不等于正在使用规则。先在 Config 中确认选中的配置文件,再回到 Home 检查 Global Routing。需要按配置文件分流时,选择 Config;如果仍处于 Proxy 或 Direct,不能用访问结果判断某一条配置规则是否正确。

6 类
本文范围:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL
4 项
Global Routing:Proxy / Direct / Config / Scene
1 条
建议配置末尾保留一条 FINAL 兜底规则

Settings → On Demand 控制按条件自动连接,并不代替规则匹配。若断开后又自动连接,应先核对 On Demand,而不是删除 FINAL。测试期间固定网络、配置文件与路由姿态,每次只改一个条件,才容易复现问题。

二、规则语法:匹配条件与处理策略分开看

普通规则通常由“类型、匹配值、策略”组成,字段使用英文逗号。FINAL 不需要匹配值,只有类型与策略。规则写在配置的 [Rule] 段中,不要把它们添加到 [General] 或代理条目所在的段落。

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
策略写法处理含义需要核对
DIRECT直接连接目标,不经过代理出站。当前网络是否能直接访问目标。
REJECT拒绝匹配的连接。匹配范围是否过宽,是否误伤页面依赖的域名。
PROXY交给名为 PROXY 的策略处理。同名策略是否存在,策略组当前选择的出站是否可用。

规则名称与代理协议不是同一个概念。已有出站使用 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard,不改变 DOMAIN-SUFFIX 的匹配含义;协议负责连接,规则负责决定把连接交给哪个策略。订阅导入与更新也应区分“出站列表更新”和“配置规则更新”,不能把两者视为同一件事。

三、DOMAIN 系列:精确域名、后缀与关键字

域名规则不填写 https://、网页路径或端口。要处理 https://api.example.com:8443/account,DOMAIN 的匹配值应是 api.example.com,不是整条地址。路径 /account 与端口 8443 都不属于这个域名字段。

规则会匹配不会匹配
DOMAIN,example.com,DIRECTexample.comwww.example.com
DOMAIN-SUFFIX,example.com,DIRECTexample.com、api.example.comnotexample.com、example.com.other.test
DOMAIN-KEYWORD,example,PROXYexample.com、myexample.net域名中不含 example 的请求,即使网页路径包含该词。

DOMAIN-SUFFIX 按域名层级匹配,并非任意字符串结尾匹配。因此 example.com 可以覆盖其子域名,却不会覆盖 notexample.com。如果只想让一个登录接口走代理,优先使用 DOMAIN;确认整个域及其子域都需要同一策略时,再使用 DOMAIN-SUFFIX。

[Rule]
DOMAIN,login.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY

在这段顺序中,登录域名先命中第一条,其他同域子域名才会落到第二条。若将后缀规则放到最前面,登录域名也会被 DIRECT 提前接走。DOMAIN-KEYWORD 的范围通常更难控制,添加前应列出可能包含同一字符串的无关域名,避免将公共关键字直接设为 REJECT。

四、IP-CIDR 与 GEOIP:按 IP 地址和网段匹配

IP-CIDR 判断目标 IPv4 地址是否属于指定网段。192.168.0.0/16 覆盖从 192.168.0.0 到 192.168.255.255 的地址,而 192.168.1.10/32 只匹配单个地址。IPv6 网段应使用对应的 IP-CIDR6 规则,不要直接塞进 IPv4 示例。

[Rule]
IP-CIDR,192.168.1.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

域名请求要参与地址类规则判断,通常需要可用的目标 IP 信息。DNS 故障可能使后续 IP 判断无法按预期完成,因此不能把所有未命中都归结为 GEOIP 数据不准。同一域名使用 CDN、不同 DNS 响应或不同地址族时,实际目标 IP 也可能不同。

五、从上到下匹配:FINAL 必须放在最后

在普通规则链中,请求自上而下检查,遇到第一条命中的规则便采用其策略,不会继续寻找“更精确”的后续规则。精确规则之所以优先,是因为人为把它写在前面,而不是软件自动按精度重新排序。

请求进入 读取配置 顺序匹配 采用策略 建立连接
  1. 先放必须优先处理的精确域名、单个 IP 与明确拒绝项。
  2. 再放域名后缀、经过评估的关键字及目标网段。
  3. 之后放 GEOIP 等覆盖面较广的条件;它与其他规则的前后关系仍按实际需求决定。
  4. 最后放一条 FINAL,明确剩余请求的处理方式。

FINAL 不再检查域名或 IP,因此若将 FINAL,PROXY 写在开头,后面的普通规则就没有匹配机会。它不是“出现错误后重试”的规则:前面某条已命中但连接失败,不会自动跳到 FINAL 改走另一条线路。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

按这份示例,api.example.com 走 PROXY,www.example.com 走 DIRECT,其他包含 tracking 的域名被 REJECT。先命中域名规则的请求,不会因为目标 IP 又符合 GEOIP 而改走另一策略。最后仍未匹配的请求才交给 FINAL。

六、规则不生效:按配置、命中、出站三个层次排查

修改前先保存当前配置副本。修改后在 Config 确认所选文件,回到 Home 确认 Global Routing 为 Config,再重新建立测试连接。已存在的长连接可能仍沿用原有连接状态,不宜只刷新一个保持连接的页面就断言规则未生效。

  1. 核对文件:确认修改的是当前使用的配置,而不是同名备份;更新远程配置后,重新检查手动修改是否仍保留。
  2. 核对语法:检查英文逗号、规则段落和策略名称,尤其是 PROXY 是否在当前配置内确实存在。
  3. 核对目标:查看请求记录中的真实域名或 IP。页面常同时访问登录、图片和接口域名,浏览器地址栏只显示其中一个。
  4. 核对命中:对照记录中的策略与规则信息,寻找是否有更靠前的 DOMAIN-SUFFIX、GEOIP 或 FINAL 提前匹配。
  5. 核对出站:已命中预期策略后仍失败,再检查 DNS、目标端口及已有服务的连接参数,不要继续扩大域名规则范围。

报错:Connection refused

原因与解法:连接可能被目标或中间设备主动拒绝,不等于规则语法错误。先从记录核对实际策略,再检查目标地址、监听端口及已有出站的配置;局域网服务还要确认该端口已启动。

报错:Connection timed out

原因与解法:连接未在时限内完成,可能涉及网络路径、目标不可达或出站故障。先确认命中策略,再在同一网络下检查已有服务的连通性,避免把超时直接解释成 DOMAIN-SUFFIX 写错。

上述是连接层可能出现的错误文本,不是每次失败都会显示的固定提示。若命中 REJECT 后请求被阻止,应先判断是否符合原本的拒绝意图;若误伤,添加范围更窄的例外并放到拒绝规则之前,而不是把所有流量改为 DIRECT。

七、常见问题与修改后的核对项

为什么加了 DOMAIN-SUFFIX,某个子域名还是走代理?

先在 Home 确认 Global Routing 为 Config,再到 Config 核对当前文件。随后检查该子域名是否已被更前面的 DOMAIN 或其他规则命中,同时确认记录中的真实请求域名确实属于该后缀。

FINAL 应该写 DIRECT 还是 PROXY?

取决于未分类流量的预期去向。希望剩余流量走已有代理策略,可用 FINAL,PROXY;希望直连则用 FINAL,DIRECT。前者要确认 PROXY 存在且可用,两者都应放在规则末尾。

更新订阅后,手写规则会不会消失?

先分清更新对象。出站订阅更新与远程配置更新并不相同;若重新获取了整份远程配置,本地修改可能被替换。更新前保存副本,更新后在 Config 重新检查规则段和策略名称。

规则能不能只让同一个域名的 443 端口走代理?

DOMAIN 与 DOMAIN-SUFFIX 本身不区分端口,把 :443 附加到域名后面不是正确写法。本文示例按域名或地址分流;若要做端口条件,应另行核对相应规则能力与语法,不能靠修改域名字段实现。

下载 Shadowrocket