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

逐段拆解 .conf 配置文件:General 管全局参数,Rule 管分流顺序,Host 管本地映射,URL Rewrite 管请求改写,并说明每段的书写格式与常见写错位置。

本文速览

本文适合已经能在 Home 建立连接、准备在 Config 阅读或修改 .conf 文件的用户。先区分连接资料与配置文件,再检查 General、Rule、Host、URL Rewrite 四段的语法和生效条件,最后用单项修改与回退步骤定位问题。示例使用保留域名和文档专用地址,不是可用线路配置。

先区分 .conf、连接资料与 Global Routing

Shadowrocket(小火箭)的 .conf 是文本配置文件,负责描述全局参数、分流规则和其他请求处理设置。它不等于服务器订阅:Home 中的连接资料决定如何连接服务端,Config 中当前启用的文件决定按什么条件处理流量。用户已有的订阅请从你的服务商处获取;本站不提供、不销售、不推荐节点或订阅。

排查“改了规则却没有变化”时,先检查 Home → Global Routing。Proxy、Direct、Config、Scene 是不同的路由姿态;验证本文的 Rule 示例时,应明确选择 Config,并确认 Config 中启用的文件就是刚编辑的文件。Proxy 不用于检验逐条分流规则,Direct 也不是验证代理策略的合适状态;使用 Scene 时,还需核对该场景实际采用的设置。

4 段
本文范围:General、Rule、Host、URL Rewrite
4 种
Global Routing:Proxy / Direct / Config / Scene
/32
IPv4 CIDR 中仅匹配一个地址的前缀长度

可以把阅读配置的检查过程拆成下面五步。这是排查顺序,不代表客户端内部所有处理模块的固定执行顺序;尤其不能由此推断 URL Rewrite 与 DNS、规则匹配之间存在一条适用于全部请求的简单流水线。

确认连接资料 确认路由姿态 确认启用文件 检查配置段落 验证请求结果

.conf 基本结构:段名、等号与英文分隔符

段名放在英文方括号内,例如 [General]。General 和 Host 常用 键 = 值,Rule 使用英文逗号分隔规则类型、匹配内容与策略,URL Rewrite 则使用规则自身的空格分隔格式。不能把一种段落的写法直接搬到另一段。

下面是一份用于阅读结构的最小示例。它把 example.com 交给 PROXY,其余请求交给 DIRECT,并在 Host 中加入一条文档地址映射。PROXY 仍需已有可用的连接资料;192.0.2.10 是文档专用地址,不能拿该映射验证公共网站是否可访问。正式使用前应移除这条 Host 演示记录。

# Structure example; documentation addresses only.

[General]
dns-server = system

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

[Host]
demo.example.com = 192.0.2.10

[URL Rewrite]
# Add rewrite rules only when needed.

General:全局参数不是服务器参数

[General] 用于配置全局行为,例如 DNS 解析相关设置。示例中的 dns-server = system 表示使用系统 DNS 设置,并不指定代理服务器,也不保证 DNS 查询会经过某条代理连接。实际解析路径还与连接方式、其他 DNS 选项及请求是否由应用自行解析有关。

先保留少量已理解的参数,再根据故障现象增加设置。把一整段陌生 General 参数覆盖进现有文件,可能同时改变解析、IPv6 和流量排除行为,使原本单一的问题难以复现。服务器密码、WireGuard 密钥或 TLS 相关连接参数也不应因为“全局”二字就被填入此段。

General 阅读卡

段名
[General]
字段格式
键 = 值
DNS 示例
dns-server = system
检查重点
字段拼写、重复键、已有 DNS 设置

一次只改一个全局选项,并记录修改前的值。

Rule 阅读卡

段名
[Rule]
域名规则
DOMAIN-SUFFIX,example.com,PROXY
兜底规则
FINAL,DIRECT
检查重点
从上往下的顺序与末尾策略

规则类型决定匹配条件,末尾策略决定处理方式。

还要区分连接触发与请求分流:Settings → On Demand 用于设置按需连接条件,不等于 General 中的一条分流规则。出现“手动断开后又连接”的现象,应检查 On Demand 条件及系统 VPN 状态,而不是反复改 FINAL。

Rule:从上到下匹配,FINAL 放在最后

[Rule] 是最常修改的部分。规则按照从上到下的顺序判断,命中后采用对应策略,不会为了寻找“更精确”的条目继续遍历。因此,具体域名和明确的地址规则通常放在较宽泛规则之前,FINAL 作为兜底放在末尾。

关键字示例匹配含义
DOMAIN-SUFFIXDOMAIN-SUFFIX,example.com,PROXY匹配 example.com 及其子域名,不是任意包含该字符串的域名。
IP-CIDRIP-CIDR,192.0.2.0/24,DIRECT,no-resolve匹配指定 IPv4 网段;no-resolve 表示不为这条匹配主动发起域名解析。
GEOIPGEOIP,CN,DIRECT依据地址数据库判断目标 IP 的地区,不依据网页语言或域名文字。
FINALFINAL,PROXY前面的规则都未命中时,采用 PROXY 策略。

例如,下面把特定域名放在地址与地区规则之前。DIRECT 表示直接连接,PROXY 使用相应代理选择;它们不是 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard 之类的协议名称。不要把协议名直接当成通用策略填写。

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

no-resolve 不是“关闭全部 DNS”。它只约束相关 IP 规则在匹配时是否主动解析域名;如果请求本来就是 IP 地址,或目标地址已经可用,仍可能命中地址规则。反过来,若客户端只看到目标 IP 而没有域名信息,不能期待所有 DOMAIN-SUFFIX 都按浏览器地址栏文字命中。

  1. 先在 Config 确认启用的文件,再到 Home → Global Routing 选择 Config。
  2. 把待验证的精确条件放到较宽泛条件前,保持 FINAL 只有一个且位于末尾。
  3. 重新发起目标请求,查看请求记录中的目标、匹配规则与实际策略;不要只看连接开关是否开启。
  4. 若域名规则未命中,先核对实际请求域名,包括跳转后的域名,再检查顺序和解析信息。

Host:本地解析映射不等于请求改写

[Host] 可以把指定主机名映射到指定 IP。常见写法是左侧域名、右侧地址,例如 demo.example.com = 192.0.2.10。此处不要写 https://、URL 路径或 :443;它描述的是主机名与地址的映射,不是一条完整访问 URL。

[Host]
demo.example.com = 192.0.2.10
api.example.com = 198.51.100.20

上面两个地址均用于文档演示。实际配置应填写你有权使用、且确实提供目标服务的地址。Host 不会把浏览器地址栏的域名替换成 IP,也不会自动改变 HTTP Host 或 TLS SNI;如果映射后的服务器没有对应域名的证书,HTTPS 仍可能出现证书错误。

URL Rewrite:匹配 URL 后执行改写动作

[URL Rewrite] 处理的是请求 URL,不是域名到 IP 的映射。以下示例用正则表达式匹配一个 HTTP 地址,将 /old/ 开头的路径重定向到 /new/。行内依次是匹配表达式、目标地址和 302,字段之间用空格分隔。

[URL Rewrite]
^http://example\.com/old/(.*)$ http://example.com/new/$1 302

在表达式中,^ 限定开头,$ 限定结尾,\. 表示域名中的字面点号,(.*) 捕获后续内容,目标中的 $1 引用第一组捕获结果。按这条规则,http://example.com/old/help 的目标地址应为 http://example.com/new/help。这只是语法推演,不代表该演示站点提供对应页面。

重定向还可能改变后续请求行为。涉及登录、支付、上传或 API 请求时,不能把 302 当作对所有请求方法都透明的替换。先在自己控制的测试地址验证匹配范围、目标 URL、查询参数和请求方法,再考虑用于实际场景。

在 Config 中安全修改:备份、启用、复测

远程配置、连接订阅和本地副本要分别管理。更新连接订阅通常是更新 Home 中的连接资料;更新远程 .conf 则可能替换配置文件中的内容。不要假定手动写入远程文件的规则能在下一次更新后自动保留。

  1. 保存基线:在 Config 找到当前启用的文件,先保留一份完整副本,并记录当前 Global Routing 姿态。备份文件可能含敏感参数,不要公开上传。
  2. 定位段落:通过文件对应的编辑入口进入文本编辑,确认修改的是 General、Rule、Host 或 URL Rewrite 中正确的一段。
  3. 单项修改:一次只添加一条规则或修改一个键。先用较小的匹配范围验证,不要同时变更 DNS、路由和改写。
  4. 保存并启用:回到 Config 确认该文件已被选中;如界面提示重新载入或重连,按提示操作,再到 Home 核对 Global Routing。
  5. 复测与回退:重新建立目标请求,记录匹配规则、错误类型与目标地址。异常时切回备份文件,用同一请求复测。

测试记录应写具体事实,例如“目标为 api.example.com,预期命中 DOMAIN-SUFFIX,实际落到 FINAL”,而不是只写“网络不行”。若所有目标都连接失败,应先检查 Home 中所选连接与服务商资料;若只有一类域名异常,再检查 Rule、DNS 与 Host;若只有某个路径发生跳转,优先检查 URL Rewrite。

常见问题:文件能保存,为什么结果不符合预期?

已经改了 Rule,为什么还是全部走同一种策略?

先到 Home → Global Routing 检查是否为 Config,再回 Config 确认启用文件。然后查看 Rule 中是否有过早出现的 FINAL,或一个更宽泛的规则排在目标规则前面。保存文件本身不代表已切换到该文件。

Host 填了地址,为什么 HTTPS 提示证书不匹配?

检查映射地址上的服务器是否为原域名提供有效证书。Host 不改变 TLS 校验所使用的域名,也不负责配置服务器证书。先移除该条映射并重新发起连接,确认异常是否随映射消失。

URL Rewrite 没反应,是不是少加了一条代理规则?

先核对真实 URL 的协议、主机名、路径和查询参数是否符合表达式。HTTPS 路径还受加密可见性与 MITM 条件影响,新增 PROXY 规则不能代替这些条件。先用受控的 HTTP 测试地址验证表达式。

更新以后,自定义规则为什么消失了?

先区分更新的是 Home 中的连接订阅,还是 Config 中的远程文件。若远程配置被整体替换,应从备份恢复到本地副本,再重新应用必要修改;后续更新前比较差异,不要直接覆盖已验证的本地文件。

阅读 .conf 的核心是分清职责:General 设置全局行为,Rule 按顺序选择策略,Host 提供本地映射,URL Rewrite 处理匹配的 URL。把修改范围缩小到一段、一个字段、一条请求,才能判断结果来自哪项设置,而不是靠反复导入整份配置试错。

Shadowrocket 下载与配置教程

iPhone / iPad 版从 App Store 获取,$2.99 一次性付费;Mac(Apple 芯片 / Intel)、Windows、安卓、Linux 版免费。iPhone / iPad 系统要求以 App Store 页面标注为准。客户端获取与线路服务分别处理,订阅请从你的服务商处获取。

下载 Shadowrocket