本文适合已经在 Shadowrocket(小火箭)中导入自有服务信息、准备编辑分流规则的用户。先确认当前使用的配置与 Global Routing,再区分域名条件、IP 条件与兜底条件;读完可以判断一条规则会覆盖哪些请求、应该放在什么位置,以及修改后应当检查哪一条连接记录。
一、先确认设备获取方式与规则入口
尚未安装时,先到全平台下载页选择设备:iPhone / iPad 从 App Store 获取,$2.99 一次性付费,开发者为 Shadow Launch Technology Limited,系统要求以 App Store 页面标注为准;Mac(Apple 芯片 / Intel)、Windows、安卓、Linux 版免费。本文只讲客户端规则,不提供、不销售、不推荐节点或订阅,以下操作以用户已有自己的服务商与订阅为前提。
分流规则位于配置文件的 [Rule] 段。Home 中选择的连接负责提供可用的代理出口,Config 中启用的配置负责组织分流条件;二者不是同一个选择。导入了服务信息,不等于某份规则配置已经启用,也不等于当前请求一定经过代理。
-
备份配置
进入 Config,确认当前启用的配置,先保留一份副本。后续只修改副本中的
[Rule],保留原有连接参数和其他配置段,便于撤回。 -
确认出口
返回 Home,确认自己的服务信息已经导入,所需代理出口可用。规则中的
PROXY是处理策略,不会自动生成服务地址、端口或认证信息。 -
选择分流
在 Home → Global Routing → Config 选择按配置处理。若当前选择 Proxy 或 Direct,不应仅凭访问结果判断
[Rule]的某一行是否生效。 -
编辑并验证
回到 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 及其子域名仅用于说明语法。
判断顺序:先找命中行,再检查出口
修改规则后,先核对新请求命中了哪一行;若策略已经正确,再检查该策略对应的连接能力。不要用“网页能否打开”代替规则命中检查。
三、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:请求目标本来就是 IP 时,不需要域名解析即可判断它是否属于相应网段。
- 通过域名访问:IP 类规则可能需要先获得解析结果,才能判断目标地址是否匹配;这与前面的域名规则是不同阶段的条件。
no-resolve:附在支持该参数的 IP 类规则后,表示不为匹配这条规则主动触发域名解析;已有目标 IP 时仍可进行判断。它不是“关闭全部 DNS”。- IPv6:本文的
IP-CIDR示例是 IPv4 写法,不能直接拿 IPv6 地址替换后照抄;处理 IPv6 时应使用对应的规则类型与地址前缀。
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。原配置如果使用策略组名称,必须保留并核对组的定义,不能随意换成不存在的名称。
blocked.example.com在第一行被REJECT拒绝,不再检查下面的域名后缀规则。api.example.com在第二行交给PROXY,不会因为同属example.com而再改为直连。www.example.com命中第三行,由DIRECT使用当前网络直接连接。- 其他没有命中域名或 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 规则时,再单独检查目标地址与解析结果。
- 检查
[Rule]段与英文半角逗号,确认FINAL,PROXY这类兜底规则没有多填一个匹配值。 - 检查域名字段没有协议头、路径、端口或多余的前后空白。
- 把需要保留的精确例外放在
DOMAIN-SUFFIX、关键词和网段范围规则之前。 - 确认
REJECT的范围足够明确,避免用一个常见短词覆盖大量无关域名。 - 保存原配置与修改副本,记录每次变更目的;向他人求助前移除认证信息和完整订阅链接。
- 确认 Config 中启用的是修改后的文件,Home → Global Routing 使用 Config,然后用新连接复核结果。
记忆时可以按三组区分:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 回答“域名是否符合条件”;GEOIP、IP-CIDR 回答“目标 IP 是否符合条件”;FINAL 回答“其余请求如何处理”。先把这三组职责与自上而下的顺序弄清楚,再扩展复杂策略,排查时就能定位到具体一行。