本文速览

本文适合已经在 Shadowrocket(小火箭)中导入自有服务信息、准备编辑分流规则的用户。先确认当前使用的配置与 Global Routing,再区分域名条件、IP 条件与兜底条件;读完可以判断一条规则会覆盖哪些请求、应该放在什么位置,以及修改后应当检查哪一条连接记录。

一、先确认设备获取方式与规则入口

尚未安装时,先到全平台下载页选择设备:iPhone / iPad 从 App Store 获取,$2.99 一次性付费,开发者为 Shadow Launch Technology Limited,系统要求以 App Store 页面标注为准;Mac(Apple 芯片 / Intel)、Windows、安卓、Linux 版免费。本文只讲客户端规则,不提供、不销售、不推荐节点或订阅,以下操作以用户已有自己的服务商与订阅为前提。

分流规则位于配置文件的 [Rule] 段。Home 中选择的连接负责提供可用的代理出口,Config 中启用的配置负责组织分流条件;二者不是同一个选择。导入了服务信息,不等于某份规则配置已经启用,也不等于当前请求一定经过代理。

  1. 备份配置

    进入 Config,确认当前启用的配置,先保留一份副本。后续只修改副本中的 [Rule],保留原有连接参数和其他配置段,便于撤回。

  2. 确认出口

    返回 Home,确认自己的服务信息已经导入,所需代理出口可用。规则中的 PROXY 是处理策略,不会自动生成服务地址、端口或认证信息。

  3. 选择分流

    在 Home → Global Routing → Config 选择按配置处理。若当前选择 Proxy 或 Direct,不应仅凭访问结果判断 [Rule] 的某一行是否生效。

  4. 编辑并验证

    回到 Config,打开该配置的编辑入口,修改并保存规则,确认启用的仍是这份配置。随后发起新的请求,在连接记录中核对目标、命中规则与处理策略。

二、规则格式:条件在前,处理策略在后

常见规则使用英文半角逗号分隔字段。大多数条件规则写成 类型,匹配值,策略;FINAL 没有匹配值,直接写策略。域名匹配值不填写 https://、网页路径、查询参数或端口。访问 https://example.com:8443/docs 时,域名条件仍然填写 example.com,而不是整段网址。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-KEYWORD,example,REJECT
GEOIP,CN,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY

上面用于展示六种格式,不建议整段直接作为实际配置:同一请求可能同时符合其中几个条件,前面的规则会遮住后面的规则。192.0.2.0/24 是文档示例网段,不是可用服务地址;example.com 及其子域名仅用于说明语法。

6 类
本文说明的常用匹配关键字
3 种
示例策略:PROXY / DIRECT / REJECT
末行
FINAL 承接前面未命中的请求

判断顺序:先找命中行,再检查出口

修改规则后,先核对新请求命中了哪一行;若策略已经正确,再检查该策略对应的连接能力。不要用“网页能否打开”代替规则命中检查。

三、DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 的边界

这三类规则都依赖可用于匹配的目标域名,但覆盖范围不同。DOMAIN 做完整域名匹配;DOMAIN-SUFFIX 覆盖指定域名及其下级子域名;DOMAIN-KEYWORD 按域名中的字符串匹配,不以域名层级为边界。需求越具体,越应优先使用范围明确的写法。

相同示例域名下的三种匹配范围
规则示例会匹配边界说明
DOMAIN,example.com,PROXY example.com 不包含 api.example.com,需要另写规则。
DOMAIN-SUFFIX,example.com,DIRECT example.com、api.example.com、img.api.example.com 按域名边界匹配,不是任意字符串结尾比较。
DOMAIN-KEYWORD,api,REJECT api.example.com、myapi.example.com 关键词出现在域名任意位置即可,可能覆盖无关请求。

如果只想让一个接口域名走代理,使用 DOMAIN,api.example.com,PROXY 比关键词规则更容易检查。如果同一域名下的全部子域都应直连,可以使用 DOMAIN-SUFFIX,example.com,DIRECT。关键词适合确实需要跨域名层级匹配相同字符串的情况,不能把短词命中当成服务归属判断。

四、GEOIP 与 IP-CIDR:按目标 IP 判断

GEOIP,CN,DIRECT 表示依据目标 IP 的地域数据库结果进行匹配,其中 CN 是地区代码。它判断的不是网页内容、域名后缀、账号地区,也不是当前设备所在位置。CDN、不同 DNS 结果及数据库差异,都可能使同一个域名对应不同的 IP 判断结果。

IP-CIDR 则匹配明确的 IPv4 网段。192.0.2.0/24 的前 24 位为网络前缀,覆盖 192.0.2.0 到 192.0.2.255 这一地址范围;如果仅指定一个 IPv4 地址,可以使用 /32。掩码数字越大,匹配范围通常越小。不要把某次解析得到的单个 IP 当成一个网站永久不变的全部地址。

IP-CIDR,192.0.2.8/32,DIRECT,no-resolve
IP-CIDR,192.0.2.0/24,PROXY,no-resolve
GEOIP,CN,DIRECT

在这组独立示例里,目标为 192.0.2.8 时先命中单地址规则,目标为 192.0.2.20 时才会落入下面的网段规则。若把 /24 放在第一行,单地址例外就没有机会生效。是否使用 no-resolve 要根据分流设计决定,不能把它当作通用提速开关。

五、FINAL 与规则顺序:先例外,后范围,最后兜底

规则通常自上而下检查,第一条命中的规则决定后续处理,不会把所有命中结果汇总后再挑“最精确”的一条。因此,“精确规则优先”是编写顺序,而不是系统自动替用户排序。FINAL 承接前面没有命中的请求,应放在规则列表末尾。

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

这段示例体现的是“个别域名例外 → 域名范围 → IP 条件 → 兜底”的组织方式,不是所有环境都必须使用的固定模板。实际使用前,应确认自己是否确实需要地域直连,以及未命中的流量是否适合交给 PROXY。原配置如果使用策略组名称,必须保留并核对组的定义,不能随意换成不存在的名称。

  1. blocked.example.com 在第一行被 REJECT 拒绝,不再检查下面的域名后缀规则。
  2. api.example.com 在第二行交给 PROXY,不会因为同属 example.com 而再改为直连。
  3. www.example.com 命中第三行,由 DIRECT 使用当前网络直接连接。
  4. 其他没有命中域名或 IP 条件的请求,最终交给 FINAL,PROXY。

DIRECT 不表示一定能访问;它只是不用所选代理出口。PROXY 不表示目标一定可达;它仍依赖当前代理与远端服务。REJECT 则是主动拒绝匹配请求,如果浏览器因此报连接失败,需要先检查是否正是规则预期行为,而不是立即改协议参数。

六、规则没有按预期生效时的检查顺序

验证时一次只修改一个条件,并发起新连接。浏览器已有的长连接可能继续使用建立连接时确定的路径;保存规则后仅刷新界面,不一定能得到一次全新的连接判断。记录测试目标、当前 Global Routing、启用配置、命中行和最终策略,才便于区分语法问题与连接问题。

写了 DOMAIN,为什么子域名没有走代理?

核对请求目标是否为 api.example.com,而规则只写了 example.com。需要整个域名及子域时改用 DOMAIN-SUFFIX;只需要单个子域时新增对应的 DOMAIN,并放在宽泛规则之前。

已经添加规则,为什么所有请求还是直连?

先检查 Home → Global Routing,确认选择 Config 而不是 Direct;再到 Config 核对实际启用的文件。修改一个没有启用的副本,不会改变当前连接的分流。

订阅刷新以后,本地规则怎么变回去了?

先区分 Home 中的服务订阅更新与 Config 中的远程配置更新。前者主要维护服务条目,后者可能替换配置内容。需要长期保留本地规则时,先保存独立副本,并比较更新前后的 [Rule],不要直接在唯一副本上反复试改。

开了 On Demand,是否会自动使用规则?

Settings → On Demand 管理按条件触发连接的行为,不替代 Global Routing 的分流选择。连接被触发以后,仍应检查当前使用的模式和配置,不能把“已经连接”当成“已按某条规则处理”。

如果记录已经显示命中了预期规则,下一步才检查传输层。下面是连接诊断中可能出现的原始错误文本,不是 [Rule] 语法错误的固定提示;不同系统显示的措辞可能不同,应结合错误发生在直连目标还是代理出口来判断。

报错:Connection refused

原因:连接被目标主机或中间设备明确拒绝,可能是端口没有监听。解法:先确认命中策略,再核对自己的服务地址、端口与服务状态;若命中 DIRECT,则检查直连目标,而不是只修改代理参数。

报错:Operation timed out

原因:连接或读写在等待期限内没有完成,单凭这一行不能确定是规则、DNS 还是网络路径问题。解法:记录目标与命中策略,分别验证域名解析和所选出口,再核对服务端口;不要同时改动多条规则与协议设置。

七、保存配置前的最小检查清单

规则文件不是数量越多越容易维护。重复的后缀、过短的关键词和过早出现的兜底,都会让后续例外难以验证。完成修改后,至少选取“精确例外、同后缀其他子域、未命中域名”三类目标检查策略;涉及 IP 规则时,再单独检查目标地址与解析结果。

记忆时可以按三组区分:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 回答“域名是否符合条件”;GEOIP、IP-CIDR 回答“目标 IP 是否符合条件”;FINAL 回答“其余请求如何处理”。先把这三组职责与自上而下的顺序弄清楚,再扩展复杂策略,排查时就能定位到具体一行。