Shadowrocket 规则语法入门:DOMAIN-SUFFIX、GEOIP、IP-CIDR 与 FINAL 匹配逻辑

逐条拆解 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 各自匹配什么、按什么顺序生效,并配上可直接照写的规则示例。

本文速览

本文适合已经在 Shadowrocket(小火箭)中导入自己已有服务、准备编辑 Config 的用户。先区分 Global Routing 与规则策略,再认识域名、IP 和兜底规则,最后用最小规则片段验证匹配结果。重点是“请求符合哪一行条件、这一行指定哪个策略”,不是按目标网站名称猜测线路。

1. 先确认 Global Routing 是否使用 Config

规则文本存在,并不表示当前连接正在使用它。Home 管理已有连接和订阅,Config 管理配置文件,Settings 管理应用设置。开始排查前,在 Home 打开 Global Routing,确认使用的是 Config,并在 Config 中核对当前启用的文件。下面的步骤以 iPhone/iPad 界面为例。

Global Routing 选项检查重点
Proxy按全局代理姿态处理流量,不用它验证 Config 中的逐条分流结果。
Direct按全局直连姿态处理流量;修改规则不能代替切回 Config。
Config依据当前配置的规则确定连接策略,是本文规则测试的前提。
Scene按已设置的场景切换路由行为;排错时先确认当前场景实际采用的设置。

Settings → On Demand 控制的是按条件建立 VPN 连接,不是某个域名选择 DIRECT 还是 PROXY 的规则。测试时应先确认连接已建立,再判断规则命中情况;否则容易把“隧道没有连接”误判成“FINAL 没有生效”。

请求进入隧道 提取目标信息 按序检查规则 选择匹配策略 建立目标连接

2. 一条规则由类型、条件与策略组成

常见规则使用英文逗号分隔。前三项通常是规则类型、匹配条件、执行策略,部分规则还接受附加参数。FINAL 是例外:它没有独立的匹配条件,后面直接写策略。不要使用中文逗号,也不要把浏览器地址栏里的完整 URL 原样当成域名条件。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

这里的 [Rule] 是配置中的规则段。若当前文件已经有这一段,应把规则放入原有规则段,而不是在文件末尾不断新增同名段。上面的内容是规则片段,不包含完整配置的其他设置,也不会自动创建代理连接。

3. DOMAIN、DOMAIN-SUFFIX 与 DOMAIN-KEYWORD 的边界

域名规则检查目标主机名,不检查 URL 的路径或查询参数。例如访问 https://api.example.com:443/v1/status 时,域名条件写 api.example.com,不带 https://、端口 443 或 /v1/status。端口不是这三种域名规则的匹配字段。

规则示例匹配范围边界示例
DOMAIN,api.example.com,PROXY只匹配完整主机名 api.example.com。不匹配 www.example.com,也不匹配 x.api.example.com。
DOMAIN-SUFFIX,example.com,PROXY匹配 example.com 本身及其子域名。匹配 api.example.com;不匹配 notexample.com。
DOMAIN-KEYWORD,example,PROXY检查主机名中是否包含 example 这段字符。可能匹配 notexample.com;范围比后缀规则宽。

需要“主域名及其全部子域名”时,通常应选 DOMAIN-SUFFIX,不必写 *.example.com。星号不是这里表达子域名范围的必要语法。需要只对一个 API 主机作例外处理时,先写 DOMAIN,再写覆盖范围更大的 DOMAIN-SUFFIX。

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

在这个顺序中,api.example.com 先命中第一行并使用 PROXY;www.example.com 未命中第一行,继续命中第二行并使用 DIRECT。如果把第二行移到最前面,api.example.com 也会先匹配到 DIRECT,后面的精确规则不会再替它改选策略。

4. IP-CIDR、GEOIP 与 no-resolve 的作用

IP-CIDR 根据地址所属的网段匹配,GEOIP 根据 IP 地理数据库中的地区归属匹配。它们处理的是 IP 信息,不是网页语言、账号地区或域名注册地。一个域名可能解析出多个地址,也可能使用跨地区的内容分发节点,因此 GEOIP 结果不能简单等同于网站所属地区。

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

当目标是域名且当前没有可用于该判断的 IP 时,带 no-resolve 的 IP 规则不会为了自身匹配而要求额外解析。因此,“域名最后解析到了内网地址”和“这条带 no-resolve 的规则一定提前命中”不是同一件事。需要稳定处理已知内部域名时,可以在 IP 规则之前增加明确的 DOMAIN 或 DOMAIN-SUFFIX 条件。

5. 从上到下首次命中,FINAL 放最后

在 Config 的常规规则处理中,规则按顺序检查,首条匹配规则决定策略。不要把列表理解成“精确度更高的规则自动优先”:DOMAIN 不会因为比 DOMAIN-SUFFIX 精确,就越过写在它前面的后缀规则。顺序必须由配置作者明确安排。

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

这组片段依次表达精确例外、域名范围、明确拒绝目标、局域网地址、地区 IP 和最终兜底。它只是顺序示例,不是适用于所有网络的推荐配置。若已有服务或本地资源需要不同策略,应保留自己的条件,并逐项检查覆盖关系。

测试目标预期匹配结果说明
api.example.com第一条 DOMAINPROXY;不再检查后面的 example.com 后缀规则。
www.example.com第二条 DOMAIN-SUFFIXDIRECT;不需要等到 GEOIP 作决定。
blocked.example.net第三条 DOMAIN-SUFFIXREJECT;此时连接被拒绝符合规则意图。
192.168.1.20第四条 IP-CIDRDIRECT;目标本身就是该网段内的 IP。
前面均未匹配的目标FINALPROXY;不表示前面的规则发生错误。

FINAL 应放在规则列表末尾。若把它放到前面,后续规则就没有正常参与匹配的机会。修改现有配置时,应先找到已有 FINAL,把新增规则插在它前面;不必为了每一类规则再追加一条 FINAL。

6. 按最小改动验证规则是否生效

不要同时修改 DNS、连接参数、策略组和大量规则,否则出现问题时难以确定原因。先保留原配置副本,再只加入一条容易辨认的域名规则。规则决定出站策略;Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议的连接参数仍由已有服务配置决定,不能用修改规则补齐缺失参数。

  1. 备份当前配置

    进入 Config,先保留当前配置副本或导出备份,再编辑正在使用的文件。不要把只有 [Rule] 的示例片段当成完整配置覆盖原文件。

  2. 插入单条规则

    在 [Rule] 内、已有 FINAL 之前添加目标规则。例如测试一个主机时使用 DOMAIN,条件只写主机名;同时检查它前面是否已有覆盖相同域名的规则。

  3. 核对当前姿态

    保存后在 Config 确认该文件已启用,再到 Home → Global Routing → Config。若原先使用 Scene,先退出场景自动切换的影响,再做单次验证。

  4. 建立新的连接

    关闭目标页面或应用后重新访问,必要时断开再连接 VPN。已有长连接可能继续沿用建立时的策略,不能仅靠刷新同一页面判断全部规则已经重新匹配。

  5. 核对连接记录

    结合连接记录核对目标主机、目标 IP、匹配规则与最终策略。先确认是否命中预期规则,再检查所选连接能否访问目标,不要只依据网页是否打开作判断。

Home 中更新 Subscribe,主要更新已有订阅提供的连接信息;它不等于把当前 Config 的规则自动改成你刚写的内容。相反,重新下载远程配置可能替换该配置文本。编辑前应先区分自己操作的是订阅、远程配置还是本地配置副本。

7. 区分连接报错与规则问题

下面是连接日志中可能出现的网络错误原文,不是规则解析器的固定提示。先检查记录中的最终策略:命中 REJECT、代理服务连接失败、目标服务器拒绝连接,处理方向各不相同。报错本身不足以证明 DOMAIN-SUFFIX 的写法有问题。

报错:Connection refused

原因与解法:连接被对端拒绝,常见于对应地址的端口没有服务监听。先按记录确认被拒绝的是代理服务器还是目标服务器,再核对自己已有服务的地址和端口;把域名规则改成 GEOIP 不能修复错误端口。

报错:Operation timed out

原因与解法:连接在等待期限内没有完成,可能涉及所选出站、目标服务或当前网络。先核对命中策略,再在相同目标和网络条件下只切换一个变量测试;不要一次重排整份规则。

写了 DOMAIN,为什么子域名没跟着走?

DOMAIN 只匹配完整主机名。若需要同时覆盖 example.com 与 api.example.com,改用 DOMAIN-SUFFIX,example.com,PROXY;再检查前面是否存在先命中的规则。

规则放在最下面,为什么一直没用?

打开当前 Config 的 [Rule],找到 FINAL。把需要参与匹配的规则移到 FINAL 之前,再检查更靠前的 DOMAIN-SUFFIX 或 DOMAIN-KEYWORD 是否已经覆盖同一目标。

切到 Proxy 就能访问,是规则写错了吗?

这只能说明两种姿态的出站结果不同。回到 Home → Global Routing → Config,查看目标是否命中 DIRECT 或 REJECT;如果命中了错误条件,再调整该条件或顺序,而不是直接删除所有直连规则。

更新订阅后,规则为何没有变化?

先区分 Home 中的 Subscribe 与 Config 中的配置文件。回到 Config 核对启用文件及其 [Rule] 内容;连接订阅的更新不等于规则文件的更新,也不自动把全局姿态切换成 Config。

获取 Shadowrocket 与基础教程

iPhone / iPad 在 App Store 一次性 $2.99,开发者为 Shadow Launch Technology Limited,系统要求以 App Store 页面标注为准;Mac(Apple 芯片 / Intel)/ Windows / 安卓 / Linux 版免费。下载页按平台列出获取方式,基础教程说明已有服务的导入与连接检查。

Shadowrocket 全平台下载