小火箭配置文件详解:.conf 中 General、Rule、Host、URL Rewrite 各段的作用

拆解 Shadowrocket .conf 配置文件的分段结构,说明 [General]、[Rule]、[Host]、[URL Rewrite] 各自负责什么,以及规则从上到下的匹配顺序。

本文速览

本文适合正在阅读或修改 Shadowrocket 本地配置的用户。先确认当前启用的文件和 Global Routing,再根据现象找对应分段:连接走错路径看 [Rule],域名解析到错误地址看 [Host] 和 [General],需要按 URL 路径重定向才看 [URL Rewrite]。

.conf 分段与写法

方括号里的段名决定后续行按什么语法读取,一直到下一个段名为止。[General] 和 [Host] 都可以看到等号,但等号左边的含义不同:前者是设置项,后者是主机名。[Rule] 通常用英文逗号分隔类型、匹配值和策略;[URL Rewrite] 的重定向条目则用空白分隔匹配表达式、目标 URL 和动作。

4 段
本文涉及的配置段
3 字段
示例 DOMAIN 规则:类型、域名、策略
2 字段
FINAL 规则:关键字、策略

给现有文件增加一条规则时,先找到原来的 [Rule] 段,再决定插入位置。不要把整段示例追加到文件末尾:末尾可能属于另一个分段,即使新行看起来像规则,也没有放在读取规则的位置。

在 Config 中编辑并启用文件

配置列表中能看到某个文件,不表示当前连接就在使用它。下面以 iPhone / iPad 的界面词为例。第一次修改时只动一行,保留修改前的文件副本,以便按同一测试条件恢复验证。

  1. 核对文件

    打开 Config,确认要编辑的文件名,先保存一份未修改的副本。远程配置如果会更新,测试时使用本地副本,避免刷新后覆盖改动。

  2. 编辑原文

    在 Config 点文件名,选择 Edit Plain Text。找到目标段,只添加或调整一条配置,保留原来的英文标点和分隔符,然后保存。

  3. 启用配置

    返回 Config,点编辑后的文件名并选择 Use Config。核对启用的是编辑后的文件,而不是用于回退的副本。

  4. 重新发起请求

    进入 Home → Global Routing → Config。用同一个目标重新建立连接;如果应用复用了旧连接,先结束原来的连接再测。

Config 既是配置页面的名称,也是 Global Routing 下的一种模式。前者用来选文件,后者决定是否按该文件的规则分流。排查 [Rule] 时,两个位置都要核对。

Config

推荐

按所选配置中的规则决定连接策略。例外条目、后缀条目和 FINAL 的顺序会影响结果。

适合:验证已启用配置的规则是否命中。

Direct

使用直连模式。直连成功只能说明当前网络下目标可直连,不能证明配置里某一条 DIRECT 规则已命中。

适合:用同一目标单独检查直连是否可用。

Proxy

对客户端处理的连接使用代理模式。测试前确认 Home 已选中自己的服务,再用同一目标发起新连接。

适合:在不依赖分流规则的情况下检查代理路径。

[General] 与 [Host]:解析设置和单域名映射

[General] 存放配置级设置,例如 dns-server = system 指定使用系统 DNS。[Host] 可以为某个主机名指定地址。前者回答通常使用什么解析设置,后者回答由 Shadowrocket 处理解析时,这个名称是否有单独的映射。两者都不能代替 [Rule] 选择连接策略。

[General]
dns-server = system

[Host]
docs.example.com = 192.0.2.10

192.0.2.10 是文档示例地址,不用于连通性测试。上面的映射只写了 docs.example.com,没有写 api.example.com。验证映射时,仍用原来的主机名发起请求,不要把浏览器地址改成 IP;那会改变请求使用的主机名,HTTPS 的证书校验条件也可能随之改变。

按故障范围选择检查项

多个域名解析异常
  • 检查 [General] 中的 dns-server,记录问题是否只在某个网络出现。
  • 用相同配置分别在两个网络发起新请求,确认现象是否随系统 DNS 所处的网络变化。
只有一个主机名异常
  • 检查 [Host] 是否写了该完整主机名,尤其留意 www 和其他子域名。
  • 在副本中移除该映射后重试同一名称,排除旧连接或缓存造成的干扰。

先分清是名称解析错了,还是地址正确但连接失败;两种现象对应的检查项不同。

[Rule]:从上到下匹配,首条命中生效

规则不会自动把更精确的条目排在前面。要让一个主机名成为后缀规则的例外,先写该主机名的 DOMAIN,再写覆盖范围较大的 DOMAIN-SUFFIX。未命中前序条目的连接交给末尾的 FINAL。

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

把前两条交换后,docs.example.com 会先命中 DOMAIN-SUFFIX,后面的精确条目便没有机会生效。示例中的 FINAL,DIRECT 只是这个配置的兜底选择。修改已有文件时,应先确认原来的兜底策略,不要为插入一条例外顺带改变其余连接的走向。

IP-CIDR 按目标 IP 所在的网段匹配,例如 IP-CIDR,192.0.2.0/24,DIRECT;GEOIP 按 IP 的地理归属信息匹配,不是按域名后缀判断。排查域名请求时,先检查上方是否已有域名规则命中,再检查 IP 类规则是否拿到了可用于匹配的目标地址。

[URL Rewrite]:按 URL 路径重定向

[Rule] 决定连接如何走,[URL Rewrite] 则匹配客户端能够处理的 HTTP 请求 URL。如下例同时限定协议、主机名和路径,并用 302 指向新地址。它只演示语法,不依赖示例域名提供页面。

[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302

HTTPS 请求的路径位于加密内容中,仅知道目标主机名不足以匹配路径。如果测试工具在发送前已把 HTTP 升级成 HTTPS,上面的表达式就不会按原样命中。先确认实际发出的协议和 URL,再决定是否需要修改表达式。

保存后不生效的常见原因

明明写了 DIRECT,为什么还走代理?

先查 Home → Global Routing 是否为 Config,再检查当前启用文件的 [Rule]。如果上方已有覆盖该主机名的 DOMAIN-SUFFIX,把精确的 DOMAIN 例外移到它之前,重新建立连接验证。

能把新规则直接贴在 FINAL 下面吗?

不要把普通规则放在兜底之后。若已有 FINAL,将新规则插入它之前,再检查更上方有无覆盖该目标的条目。保存后用一个应命中的目标和一个应落到兜底的目标各测一次。

Host 改了地址,为什么浏览器地址栏没变?

[Host] 改的是主机名对应的地址,地址栏继续显示原来的 URL 是正常现象。要验证映射,使用自己控制的目标服务检查新连接是否抵达预期地址;若要把 /old 改到 /new,检查的是重定向而不是主机映射。

切回原文件后,怎么判断是哪次改动有问题?

在同一网络上,用原文件和改动后的副本分别发起同一请求,保持 Global Routing 与所选服务不变。若只有副本出现问题,就从最近改过的段开始逐行恢复,每次只改一处、重试一次,直到找到触发现象的条目。

Shadowrocket 全平台下载