Shadowrocket 配置文件 .conf 结构详解:General、Rule、Host、URL Rewrite 各段作用

逐段拆解 Shadowrocket 的 .conf 配置文件,说明 [General]、[Rule]、[Host]、[URL Rewrite] 各自管什么、改动后如何生效。

本文速览

Shadowrocket(小火箭)的 .conf 是文本配置,不是订阅地址,也不是连接凭据的替代品。本文面向已经持有自己服务信息的用户,按配置分段说明运行参数、分流规则、域名映射和 URL 重定向的区别,并给出备份、编辑、启用与回退步骤。先用最小规则验证,再逐项恢复其他设置,可以避免把 DNS、规则顺序与连接故障混在一起排查。

1. .conf 分段结构与配置边界

配置文件以方括号标记分段,例如 [General]。段名下面的内容由该段自己的语法解释,直到遇到下一个段名。[General] 常见形式是 键 = 值,而 [Rule] 使用逗号分隔的规则行;不能把同一种写法套到所有段落。编辑时使用英文半角方括号、逗号和等号,不要让中文输入法替换这些符号。

分段负责什么不负责什么
[General]DNS 等基础运行参数不替代逐条网站分流规则
[Rule]按条件选择 DIRECT、PROXY 等策略不修改请求 URL
[Host]为特定域名指定解析结果不单独决定是否使用代理
[URL Rewrite]按正则表达式处理匹配的 URL不等于 DNS 映射或路由规则

这四段不是必须全部出现。仅做网站分流时,可以先保留必要的基础参数和 [Rule],暂不添加 Host 或 URL Rewrite。配置也可能包含其他受支持的分段,不能因为本文没有展开就直接删除。不要把其他格式的配置只改扩展名为 .conf 后使用。

2. [General]:先确认 DNS 基线,再改其他参数

[General] 适合从少量、明确支持的设置开始。下面的示例使用 dns-server = system,表示采用系统 DNS 作为此处的解析来源;它不是“所有网络都能解析成功”的保证,实际结果仍与当前网络、缓存和其他 DNS 设置有关。

[General]
dns-server = system

如果原配置已有 DNS 参数,先记录原值,再做对照测试。更换解析来源可能改变域名获得的 IP,进而影响 GEOIP 或 IP-CIDR 的命中结果。因此,排查一个网站时,不要同时更换 DNS、调整规则顺序和切换连接条目,否则无法确定是哪一项改变了结果。

基础参数核对

分段
[General]
示例键
dns-server
示例值
system
书写形式
键 = 值

先保留可工作的基线,未知参数不要凭名称推测后添加。

解析问题核对

测试对象
同一个完整域名
固定条件
同一网络、同一连接条目
记录内容
解析结果、命中规则、连接错误
恢复动作
还原原值并建立新连接

域名能解析不代表目标端口可连接,需分别核对。

3. [Rule]:匹配顺序、策略与 FINAL 兜底

[Rule] 的关键是从上到下匹配,先命中的规则决定这次请求采用的策略。下面是“example.com 及其子域名使用 PROXY,其余使用 DIRECT”的教学片段。它只展示分流逻辑,不包含可用的连接信息;使用 PROXY 前,需要在 Home 准备并选择自己的可用连接条目。

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

DOMAIN-SUFFIX,example.com,PROXY 会匹配 example.com 和 www.example.com,不是对 URL 路径做字符串搜索。不要写入 https://、端口或 /path。FINAL 是前面条件都未命中时的兜底,应放在规则末尾;把它放在前面,会让后面的规则失去被匹配的机会。

规则示例判断依据核对点
DOMAIN-SUFFIX,example.com,PROXY域名后缀适合明确指定一组相关域名
GEOIP,CN,DIRECT目标 IP 的地理归属数据库结果不是按网页语言或域名后缀判断
IP-CIDR,192.0.2.0/24,DIRECT,no-resolveIPv4 地址所属网段no-resolve 避免仅为此条匹配主动解析域名
FINAL,DIRECT其他规则均未命中最后一条,明确剩余请求的去向

表格中的条目分别解释语法,不要求全部加入同一份配置。192.0.2.0/24 是文档示例网段,不是实际服务地址。若需要添加 GEOIP 这类覆盖面较大的规则,应放在更具体的网站例外之后,并在 FINAL 之前;否则一个宽泛条件可能先接走本应由后续规则处理的请求。

4. [Host]:域名映射不等于流量直连

[Host] 可以为特定域名设置静态解析结果。下面把保留测试域名映射到文档示例地址,只用于说明格式,不对应真实服务。左侧是域名,不含协议和路径;右侧是指定地址。

[Host]
lab.example.test = 192.0.2.10

Host 解决的是“域名指向哪个地址”,Rule 解决的是“请求使用哪种策略”。即使写了 Host,也不能据此断定请求会使用 DIRECT。仍需检查命中的规则、当前 Global Routing 姿态,以及连接记录中实际使用的目标和策略。

按问题选择修改位置

目标地址需要固定
  • 在 Host 中配置明确的域名与地址映射。
  • 检查目标服务器是否仍接受该域名的请求。
  • HTTPS 仍需匹配原域名的有效证书。
请求策略需要改变
  • 在 Rule 中添加域名或 IP 条件。
  • 确认例外规则位于宽泛规则之前。
  • 使用 Config 姿态验证实际命中策略。

地址映射与路由选择应分别验证;固定 IP 不能修复证书不匹配,也不能保证服务长期可用。

5. [URL Rewrite]:匹配 URL,而不是替代 Rule

[URL Rewrite] 根据 URL 的正则表达式执行相应操作。下面的示例把一个 HTTP 根地址重定向到 HTTPS 根地址,末尾的 302 表示临时重定向。示例只覆盖根路径,不覆盖该域名下所有页面,便于缩小测试范围。

[URL Rewrite]
^http://example\.com/$ https://example.com/ 302

普通 HTTPS 请求的完整路径受到加密保护,不能因为添加一段 URL Rewrite 就假定能够匹配其中的路径。涉及 HTTPS 内容处理时,还存在解密范围与证书信任等前提;本文的基础配置验证不要求启用这些功能。不要为测试一条重定向而扩大对所有域名的处理范围。

6. 编辑后如何启用:保存、选中与重建连接

保存文件只是第一步,还要确认 Config 中选中的就是刚才编辑的配置,并在 Home → Global Routing 中使用 Config。下面以 iPhone/iPad 的 Home、Config、Settings 结构说明操作;其他平台按对应功能核对,不将某个界面位置视为所有平台完全相同。

  1. 备份原件

    进入 Config,打开当前配置的操作菜单,导出原配置并保留独立副本。记录当前配置名称,以及 Home → Global Routing 的原姿态。

  2. 单项编辑

    在 Config 中打开目标配置的文本编辑入口,每轮只修改一个分段。先检查段名、半角标点和 FINAL 位置,再保存。

  3. 选中配置

    回到 Config 列表,确认目标文件处于选中状态。编辑的是副本时,需要明确切换到该副本,不能继续使用原文件测试。

  4. 切换姿态

    进入 Home → Global Routing,选择 Config。若 Settings → On Demand 已启用,先记录其设置,测试期间避免自动连接动作干扰手动切换。

  5. 重建并验证

    断开后重新连接,再发起新的测试请求。核对连接记录中的域名、命中规则与策略;失败时切回备份配置,并用相同请求复测。

已有连接可能继续沿用建立时的状态,浏览器也可能保留连接或缓存。修改配置后只刷新一次旧页面,不足以证明新配置已生效。测试时关闭相关旧连接,使用新请求,并保持网络和连接条目不变;必要时分别测试域名解析与目标服务连接。

7. Global Routing 姿态对配置验证的影响

“规则写了却没反应”应先检查 Global Routing,而不是立即继续改文件。Config 用于按当前配置执行分流;Proxy 与 Direct 可用于缩小问题范围,但不能用它们的测试结果代替规则命中验证。

Config

推荐

按当前配置的规则决定请求策略。验证 DOMAIN-SUFFIX 与 FINAL 时,应在此姿态下观察实际命中结果。

适合:日常规则分流、配置改动验收。

Proxy

以代理方式处理流量,用于对照当前连接是否可用。即使页面能够打开,也不能据此认定某条 Rule 已经命中。

适合:区分连接条目故障与规则选择问题。

Direct

以直连方式处理流量,可与代理路径对照。停留在此姿态时,不应期待新增的 PROXY 分流规则按 Config 方式工作。

适合:核对当前网络本身能否访问目标。

Scene

依据已经配置的场景设置决定运行方式。排查时需先查看场景条件与动作,避免场景切换使测试条件发生变化。

适合:已有明确场景配置的网络环境切换。

8. 常见配置故障与回退核对

保存了 .conf,为什么还是走原来的策略?

依次检查 Config 中选中的文件、Home → Global Routing → Config,以及目标规则是否位于 FINAL 之前。然后重建连接发起新请求。文件内容正确,但编辑对象不是当前配置,是需要优先排除的情况。

加了 Host 后,为什么 HTTPS 提示证书错误?

Host 只改变地址映射,不改变请求域名和证书校验要求。先移除新增映射并复测,再确认指定服务器是否确实为该域名提供服务。不要用忽略证书错误替代地址与证书配置修正。

更新订阅后,为什么规则没有一起更新?

连接条目订阅与远程配置是不同对象。先确认更新的是 Home 中的服务信息,还是 Config 中的远程配置。更新前保留本地副本;远程配置重新获取后,也要核对是否覆盖了自行编辑的规则。

改完无法连接,要重新导入所有内容吗?

先切回已备份的配置,保持原连接条目不变,再重新连接。如果恢复正常,逐项比较最近修改的分段;若仍失败,再检查服务地址、端口与认证信息。不要直接删除全部配置和订阅,以免失去对照基线。

验收时至少记录四项:当前选中的配置、Global Routing 姿态、测试域名、实际命中的策略。对比前后结果时,一次只改变一个变量。这样可以区分语法错误、规则覆盖、解析差异与服务不可达,而不是反复叠加设置。

Shadowrocket 官方下载