本文速览

修改前先在 Config 确认当前配置,再到 Home 核对 Global Routing。本文以 iPhone / iPad 界面为例,适合已经能建立连接、需要调整分流或排查规则未命中的读者。按段修改并保留原配置,可分别验证出站策略、域名解析和 URL 重定向。

先确认 .conf 文件和路由模式

.conf 是按段组织的配置文件。方括号中的名称决定下一组条目由哪一段读取:[General] 和 [Host] 的示例用等号赋值,[Rule] 用逗号分隔字段,[URL Rewrite] 的重定向示例用空格分隔字段。不能只移动一行而不核对新段的语法。

当前配置路由模式目标匹配出站策略连接记录

在 Config 确认使用的是准备测试的文件,而不只是打开了某份文件的编辑界面。保存副本后,回到 Home,把 Global Routing 设为 Config 再测分流。Proxy 和 Direct 是不同的全局路由选项,不适合用来判断一条 [Rule] 是否命中。Settings 中的 On Demand 管何时自动建立连接,也不能替代这一步。

4 段
本文分别检查 General、Rule、Host、URL Rewrite
2 个逗号
基础 DOMAIN-SUFFIX 行分隔类型、域名和策略
302
本文 URL Rewrite 示例的 HTTP 重定向状态码

先看命中结果,再判断线路

同一个页面能打开,并不能证明流量走了预期出站。先用一个已知目标发起新连接,在应用的连接记录中核对策略;策略正确但请求仍失败,再检查解析结果或相应出站是否可用。

General:配置全局 DNS 参数

[General] 放置整份配置共用的参数。以 dns-server 为例,值设为 system 表示使用系统 DNS,而不是在这一行指定固定的 DNS 服务器。切换 Wi-Fi 或蜂窝网络后,系统提供的解析环境可能变化,因此对比修改前后的结果时,应先保持接入网络不变。

[General]
dns-server = system
  • 在现有 [General] 内修改对应键,不要为了试一行参数再追加一个同名段,也不要保留两条互相冲突的 dns-server。
  • 用同一个原本可访问的域名做修改前后的对照,并确认测试请求确实发起了新连接。复用旧连接或读到缓存时,刷新页面并不一定会重新解析。
  • 把解析和出站分开判断。能得到目标地址,不表示该地址可经当前策略访问;反过来,一个已有连接仍能传输,也不表示新的 DNS 查询一定成功。

Rule:从具体规则到 FINAL 兜底

[Rule] 按书写顺序匹配,先命中的规则决定策略。把单个域名的例外放在覆盖它的后缀之前,把 FINAL 放在末尾。下面的文档域名与地址只用于阅读匹配关系,不代表实际服务;在自己的配置中使用 PROXY 前,先在 Home 确认已有可用的代理服务器。

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,DIRECT

假设应用拿到了请求的域名,docs.example.com 先命中第一行,而同一后缀下的 img.example.com 命中第二行。若交换前两行,docs.example.com 会先被后缀规则覆盖。第三行匹配指定的 IPv4 网段;用 IP 字面量发起请求时,不应期望它命中域名规则。没有命中前面各行的请求才落到 FINAL。

按域名匹配

DOMAIN
匹配完整域名,例如 docs.example.com。
DOMAIN-SUFFIX
匹配 example.com 及其子域名,不匹配 notexample.com。
常见误写
域名字段不带 https://、端口或路径。

同一后缀里有例外时,把完整域名写在后缀规则上方。

按地址匹配与兜底

IP-CIDR
按 IPv4 地址范围匹配,例如 192.0.2.0/24。
GEOIP
按目标 IP 的地理归类匹配,例如 GEOIP,CN,DIRECT。
FINAL
指定未命中前序规则时的策略,例如 FINAL,DIRECT。

IP 类规则依据目标地址,不按域名后缀或设备所在地区判断。

不要只为测试一条域名规则而替换现有的 FINAL。那会同时改变所有未命中流量的出站,让结果难以归因。先保留原兜底,只新增一条明确的例外,再用一个应命中的域名和一个不应命中的域名做对照。

Host:把域名映射到指定 IP

[Host] 的左侧是要解析的域名,右侧是映射地址。它适合在 Shadowrocket 处理该域名的解析时,把请求指向一个指定地址。它不替代 [Rule],不负责选择 DIRECT 或 PROXY,也不会把地址栏里的域名改成另一个域名。

[Host]
staging.example.com = 192.0.2.10

192.0.2.10 是文档示例地址,不用于验证服务可达性。实际验证时,应换成自己管理的测试域名和当前网络可达的服务地址。继续用域名发起请求;直接输入 IP 会跳过这条域名映射,也可能让服务器按另一个站点处理请求。

  1. 先确认请求走的是由 Shadowrocket 处理的解析路径。应用缓存、已建立连接或由远端执行的解析,都可能使本地映射暂时看不出效果。
  2. 检查目标服务是否在所用端口监听。http:// 默认使用 80,https:// 默认使用 443;映射行不负责修改端口。
  3. 使用 HTTPS 时,服务端仍须提供与原域名匹配的证书。地址变成指定 IP 后出现证书错误,应先核对服务端证书和站点配置,不要把证书错误当成映射未命中。

URL Rewrite:按 URL 匹配并返回重定向

[URL Rewrite] 的 302 写法针对可识别的 HTTP 请求 URL。规则匹配后返回重定向响应,由发起请求的客户端决定是否跟随。它不是 DNS 映射,也不会把目标 IP 改写成规则右侧的值。下面用明文 HTTP 演示,只匹配一个完整的旧地址:

[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302
  • 第一个字段是正则表达式。\. 匹配字面上的点,开头的 ^ 和末尾的 $ 限定整条 URL,避免把别的主机或相似路径也纳入规则。
  • 第二个字段是重定向目标。按本例,/old/ 或带查询参数的 /old?ref=test 不匹配;/new 也不匹配原规则,因此不会由这一行再次跳转。
  • 第三个字段是动作 302。验证时分别检查原请求是否收到 302、Location 是否指向预期目标,以及新请求是否成功。新地址返回错误,不等于原重定向没有发生。

验证应使用自己控制的测试站点。若客户端在发出请求前就把 HTTP 升级成 HTTPS,这条以 http:// 开头的正则不会命中。HTTPS 的路径和查询参数受 TLS 保护,仅知道主机名不足以做路径级改写;不要把修改正则或添加 [Host] 当作解决方案。

配置不生效:按文件、策略和请求逐项排查

我在 Config 里改完了,为什么请求还走旧策略?

先确认改动已经保存,并且当前使用的正是该文件;再核对 Home 中的 Global Routing 是否为 Config。让测试应用重新建立连接,然后查看这次请求的出站策略,不要用修改前的记录作判断。

规则写了 DIRECT,为什么它仍然走 PROXY?

向上查找更早出现的后缀规则或其他能覆盖该目标的规则。把针对完整域名的 DOMAIN 例外移到覆盖规则之前,再分别验证例外域名和同后缀的另一个域名。

Host 指到了测试机,为什么打开的还是原站点?

先确认请求仍以测试域名发起,再检查测试服务是否收到了新请求。若没有收到,排除旧连接、缓存和远端解析;若已经收到但返回了原站内容,则检查测试机是否为该域名配置了正确的站点。

加了 302,为什么浏览器没有跳转?

用实际发出的 URL 对照正则,特别检查协议、末尾斜杠和查询参数。若已收到 302,继续核对 Location 和新请求,而不是反复修改原匹配式。把这条规则暂时撤回后再测一次,可以区分配置重定向与服务端原有的跳转。