Shadowrocket 配置文件 .conf 结构详解:General、Rule、Host、URL Rewrite 各管什么

逐段拆解 .conf:General 管全局参数,Rule 管分流顺序,Host 管本地解析,URL Rewrite 管请求改写,每段都配真实片段。

本文速览

改出站看 [Rule],改域名解析结果看 [Host],改请求地址看 [URL Rewrite],改 DNS 等全局参数看 [General]。本文适合已经在 Shadowrocket 中使用配置文件、准备核对或修改条目的用户;界面操作以 iPhone / iPad 为例,其他平台可按配置段名对照。

先确认生效文件,再判断该改哪一段

.conf 用方括号标题划分配置段。从一个段标题到下一个段标题之间的条目属于同一段。四段不是固定的请求处理顺序:把 [Host] 挪到 [Rule] 前面,不等于让解析条目获得更高的分流优先级。真正需要关注行序的是 [Rule] 段内部。

4 段
本文对照 General、Rule、Host、URL Rewrite
1 条
Rule 采用首条命中的策略
302
本文改写示例使用的临时重定向状态码

先核对 Home → Global Routing

在 Config 确认选中的文件,然后到 Home → Global Routing 选择 Config 再验证分流。若当前是 Proxy 或 Direct,先不要根据连接结果调整规则行序。

下方流程仅说明 Config 模式下如何选出分流策略,不表示 DNS 查询和 URL 改写总在同一时点执行。Scene 用于按场景选择路由方式;排查单条规则时可先切到 Config,减少场景切换造成的干扰。

应用请求目标识别规则匹配策略执行
  1. 先保留原配置,在副本中修改。若原文件由远程地址更新,单独保存本地修改,避免下次更新时被覆盖。
  2. 每轮只改一处,用相同设备、网络和目标重测。先记下改动前的现象,避免把网络切换或缓存变化误判为配置生效。

General:设置 DNS 等全局参数

[General] 使用 键 = 值 形式。这里的设置不是为某个域名逐条指定出站策略。下面两行分别指定系统 DNS 和 IPv6 设置;实际修改时,不需要为了测试 DNS 一并改动 IPv6。

[General]
dns-server = system
ipv6 = false
  • dns-server = system:使用系统配置的 DNS。若同一域名只在某个 Wi-Fi 下解析异常,先在该网络下确认系统是否能正常解析,再对照移动网络或另一条已知正常的网络。不同网络的系统 DNS 不一定相同。
  • ipv6 = false:关闭配置中的 IPv6 支持,用于隔离 IPv6 路径的影响;这不是系统级开关,也不保证目标一定有 IPv4 地址。测试结束后按原配置恢复,再决定是否保留改动。

如果只有一个域名解析到了不正确的地址,先检查 [Host] 是否已有同名条目,不要先换全局 DNS。如果域名能正常解析,但走错了出站,再去看 [Rule]。更多参数见配置字段说明。

Rule:按行匹配,首条命中决定策略

[Rule] 的常见格式是 类型,匹配值,策略,FINAL 不带匹配值。下例将精确域名例外放在后缀规则之前,不满足前面条件的请求由 FINAL 处理。PROXY 使用已选择的代理,DIRECT 表示直连,REJECT 表示拒绝该请求。其中域名和网段仅用于说明匹配,不代表可用的服务地址。

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

域名匹配

DOMAIN
精确匹配 lab.example.com,不包括它的子域名。
DOMAIN-SUFFIX
匹配 example.com 及其子域名。
FINAL
前面都不命中时选用 DIRECT。

如果把后缀规则移到精确规则前,两个条件都符合时将先选中 PROXY。

IP 匹配

IP-CIDR
匹配指定的 IP 网段;例如字面 IP 192.0.2.10 属于 192.0.2.0/24。
no-resolve
不为尝试这条 IP 规则而主动解析域名。
GEOIP
按目标 IP 的地理分类匹配,例如 GEOIP,CN,DIRECT,而不是按域名后缀判断。

把 GEOIP 加入配置时,放在 FINAL 之前,并确认上方是否已有规则提前命中。

验证行序时,要区分「规则选中了某个策略」和「目标服务能打开」。例如请求目标被识别为 lab.example.com 时,第一行匹配 DIRECT,即使服务本身不可达,也不会因此改用第二行的 PROXY。排查时应先确认匹配结果,再检查服务可达性。

Host:覆盖指定域名的解析结果

[Host] 可以在配置内把一个域名映射到指定地址。下面使用文档保留地址 192.0.2.10 演示语法。实际验证时,换成自己控制的测试域名及当前网络可访问的地址,并确保该连接确实使用了受配置影响的解析路径。

[Host]
lab.example.com = 192.0.2.10
  1. 先用原配置访问测试域名,记录能否连接及服务端收到请求的位置。启用带有映射的副本后,使用同一个域名发起一次新连接,避免旧连接或 DNS 缓存影响判断。
  2. 若每次仍连到原地址,检查是否选中了副本,以及目标应用是否复用了旧连接或使用了自己的 DNS。系统解析工具的输出不一定反映该应用经 Shadowrocket 连接时的解析结果。
  3. 若连接到了指定地址却出现 HTTPS 证书错误,检查目标服务是否为原域名配置了有效证书。[Host] 改的是解析地址,不会替换 URL 中的域名,也不会让不匹配的证书变为有效。

如果需求是「访问同一个域名,但由另一台服务器应答」,检查 [Host];如果需求是「访问一个路径后跳到另一个路径」,检查 [URL Rewrite]。仅更换 IP 不会让浏览器地址栏从 /old 变成 /new。

URL Rewrite:按 URL 模式返回重定向

[URL Rewrite] 的下例依次写入匹配表达式、目标 URL 和动作码 302,字段以空格分隔。它只匹配完整的 HTTP 地址 http://lab.example.com/old。域名中的点用反斜杠转义,^ 和 $ 限定匹配范围,所以 /old/ 或带查询参数的地址不会命中这条表达式。

[URL Rewrite]
^http://lab\.example\.com/old$ http://lab.example.com/new 302
  • 测试时换成自己管理、允许明文 HTTP 的测试域名,不发送账号或其他敏感信息。确认请求仍为 http://:若浏览器先将它升级到 HTTPS,就不符合示例中的匹配条件。
  • 预期现象是原请求收到 302,响应的 Location 指向 /new 的完整 URL;跟随跳转的客户端随后会发起新请求。若地址栏已到 /new 但显示找不到页面,先确认服务器上确实存在目标路径。
  • HTTPS 的路径和查询参数在加密内容中。若 Shadowrocket 看不到请求里的完整 URL,仅把表达式中的 http 改成 https 不会让路径匹配生效。先用受控的 HTTP 示例验证表达式,不要把 HTTPS 未命中直接归因于 [Rule]。

常见问题:改完配置后从哪里查

明明加了域名规则,怎么还是走原来的策略?

先在 Config 对照文件名,再确认 Home → Global Routing 设为 Config。在 [Rule] 里从上往下检查,尤其留意更早出现的 DOMAIN-SUFFIX。只在明确例外范围后,把精确匹配移到对应的宽泛规则之前。

为什么直接访问 IP 和输入域名,结果不一样?

先分开记录两个请求的目标。输入域名可能先命中域名规则,直接输入 IP 则没有同样的域名可供匹配。即便两次访问到达相同地址,服务端仍可能按域名选择站点,直接用 IP 访问也可能遇到证书不匹配。

改写后一直在跳转,先删哪一行?

先在副本中移除本轮新增的改写并重试。如果循环消失,检查目标 URL 是否也匹配原表达式,或目标页面是否又重定向到原地址。把表达式收窄到确切的源路径,并分别测试源地址和目标地址。

更新配置后,本地加的条目找不到了怎么办?

先在 Config 确认当前是远程配置还是本地副本。若远程内容已经替换了本地改动,从保留的副本找回条目,按段合并到新的副本;合并后检查规则行序和重复的域名映射,再逐项重测。

下载 Shadowrocket