2026-10-24 · 规则进阶 · 约 8 分钟

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

逐条说明 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 各自匹配什么、按什么顺序生效,以及如何配合 PROXY / DIRECT / REJECT 写出第一条规则。

本文速览

适合已经安装 Shadowrocket、想在现有 Config 中增加一条分流规则的读者。先区分域名规则和目的 IP 规则,把例外放在宽泛规则之前,再用连接记录核对命中项与最终策略。文中的域名和地址用于解释语法,不需要导入订阅即可阅读和核对。

规则顺序:从上往下,首条命中生效

在 Home 将 Global Routing 设为 Config 后,进入 Shadowrocket 的连接才按当前配置中的规则分流。配置文本的 [Rule] 段通常每行写一条规则,格式为 类型,匹配值,策略。FINAL 是例外:它不填匹配值,直接写成 FINAL,策略。

应用发起连接读取目标信息顺序核对规则选用首条策略执行连接处理

系统不会自动把精确的 DOMAIN 提到前面。如果某条 DOMAIN-SUFFIX 已经命中,写在下面的精确域名例外就不会生效。同理,如果把 FINAL 放在中间,走到这里的连接会被兜底策略处理,后面的规则便失去了匹配机会。

域名规则:整名、后缀与包含字符串

域名规则检查主机名,不检查完整 URL。以 https://docs.example.com:443/guide 为例,填进规则的是 docs.example.com,不带 https://、端口 443 或路径 /guide。要让同一主机上的两个网页路径走不同策略,不能靠下面三种域名规则区分。

类型与匹配值命中示例不会命中的示例
DOMAIN,example.comexample.comdocs.example.com:不是同一个主机名。
DOMAIN-SUFFIX,example.comexample.com、docs.example.comnotexample.com:没有标签边界。
DOMAIN-KEYWORD,exampleexample.com、notexample.netsample.net:不包含指定字符串。

DOMAIN-SUFFIX 直接填 example.com,不需要写 *.example.com。如果只改一个主机,优先写 DOMAIN;如果主域和子域都采用同一策略,再用 DOMAIN-SUFFIX。DOMAIN-KEYWORD 的范围最容易超出预期,尤其是短词:它不要求对应一整个域名标签,也不要求词出现在域名开头。

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,REJECT
FINAL,DIRECT

按上面的示例,docs.example.com 命中首行规则走 DIRECT,www.example.com 命中后缀规则走 PROXY,notexample.net 则会被关键词规则拒绝。这里的关键词规则专门用于展示误匹配范围,不建议照搬到日常配置。把前两条互换后,docs.example.com 会先命中后缀规则,这就是精确例外需要写在前面的原因。

IP 规则:IP-CIDR、GEOIP 与兜底

域名没有命中时,可以继续用目的地址判断连接策略。IP-CIDR 检查目的 IPv4 地址是否落在指定网段;GEOIP 根据目的 IP 在地理地址库中的归类判断,不看域名后缀,也不判断手机所在的位置。有特定域名需要例外处理时,把对应的域名规则放在宽泛的 IP 规则之前。

[Rule]
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

添加第一条规则并验证

第一次修改时只新增一条范围明确的规则,不同时改 DNS、代理线路和兜底策略。以下用 DOMAIN,example.com,DIRECT 说明操作;若站点在当前网络上不能直连,请改用一个已确认能直连的测试主机。

  1. 备份当前配置

    在 Config 确认当前使用的文件,先留一份副本。若文件会从远程更新,在自用的本地副本中修改,避免下次更新将改动覆盖。

  2. 添加精确规则

    进入 Config,打开要编辑的配置详情,在 Rules 中添加 DOMAIN,匹配值填 example.com,策略选 DIRECT。若用文本编辑,把对应规则行写入 [Rule]。

  3. 检查位置与模式

    将新规则放在可能覆盖它的后缀规则、关键词规则及 FINAL 之前。保存并确认使用修改过的文件,然后在 Home → Global Routing 选择 Config,打开连接开关。

  4. 发起新连接验证

    关闭原测试页后重新发起请求,避免沿用浏览器已有的连接。到 Data 查看这次请求对应的记录,用主机名和时间定位,核对策略是否为 DIRECT。如果页面跳转或加载了其他主机的资源,分别查看记录。

验证失败:区分 DNS、目标端口和规则命中

页面打不开不等于规则没有生效。先用 Data 核对失败连接的目标与策略。有匹配记录但页面仍失败时,再看浏览器报错;下列报错是 Chromium 的提示,不是 Shadowrocket 的规则名称。

报错:ERR_NAME_NOT_RESOLVED

原因:浏览器没有取得目标主机的可用解析结果,可能是主机名拼错或所用 DNS 无法解析。解法:核对地址栏里的实际主机名,再在同一网络测试一个已知可解析的域名;先确认解析正常,不要靠移动 FINAL 来排除 DNS 问题。

报错:ERR_CONNECTION_REFUSED

原因:连接尝试被拒绝,例如 HTTPS 目标没有在预期的 TCP 443 端口接受连接。解法:先核对实际策略是否为 REJECT,再核对 URL 的协议和端口;若测试的是自管服务,确认服务正在对应端口监听。

常见问题:规则没命中时先检查什么

为什么加了 DIRECT,记录里还是 PROXY?

先在 Home → Global Routing 确认是 Config,再回 Config 检查启用的文件是否就是刚修改的那份。随后从 [Rule] 的第一行往下看,找出是否有后缀或关键词规则更早命中;找到后再把精确例外移到那条规则之前。

为什么同一张网页出现几种不同的策略?

页面正文、图片和脚本可能来自不同主机,也可能有跳转。到 Data 对照发起时间和每条连接的目标主机,不要只看标签页标题。要给另一个资源主机设置同样的策略,先为该主机添加精确规则,不要直接扩大成一个关键词。

Connectivity Test 通过,为什么站点还是打不开?

Connectivity Test 验证的是测试目标,不代表当前网页命中了预期策略,也不代表网页的所有资源都可达。重新打开目标页面,再到 Data 找该站点的记录;若实际走 DIRECT,先排查本地网络到该站点的连通性,若走 PROXY,再检查所选线路。

Global Routing 里的 Scene 可以代替 Config 吗?

验证单条规则时先固定为 Config。Proxy 和 Direct 是全局路由模式,不用于验证逐条规则;Scene 会按场景设置选择路由方式,场景变化可能改变结果。先在 Config 下确认同一目标的命中情况,再切回平时使用的 Scene 复核。

下载 Shadowrocket 与查看教程

iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准。Mac(Apple 芯片 / Intel)、Windows、安卓、Linux 版免费,安装包从本站下载页获取。

下载 Shadowrocket