iOS 小火箭配置文件怎么写?从模板到规则生效
简答:先记住:Shadowrocket 的 .conf 是规则与运行设置文件,不等于节点订阅。最快做法是先用不含真实凭据的最小模板验证格式,再根据需求选择规则;导入后必须选中配置,并在 Home → Global Routing 中切换到 Config,最后用同一个域名复测。
定义:Shadowrocket 的 .conf 配置文件,是按 [General]、[Proxy Group]、[Rule] 等区块组织网络设置、策略引用和请求分流规则的纯文本文件。
先用最小模板验证格式:5分钟完成保存、导入、启用
如果你看到“文件已经导入,但规则没有生效”,先不要同时修改 DNS、节点和规则。本文是第三方使用指南,下面的示例只用于理解结构,不包含真实服务器地址、密码、Token 或私钥。
- 把模板复制到纯文本文件,保存为
test.conf,优先使用 UTF-8 编码。 - 打开 Shadowrocket 的 Config 页面,通过文件或 URL 导入;如果使用云盘,先确认文件已同步完成。
- 在 Config 中选中刚导入的文件,再进入 Home → Global Routing,选择 Config。
- 保持服务器和配置不变,访问同一个测试域名,并查看请求记录中的匹配规则与策略。
[General]
dns-server = system
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.net,PROXY
GEOIP,CN,DIRECT
FINAL,PROXYexample.com、example.net 只是文档示例,不代表可用服务。公开资料说明,PROXY 是规则策略,表示通过当前选中的代理服务器处理;它不是服务器地址,也不需要另外创建一个同名策略组。可查看Shadowrocket 设置、订阅导入与路由检查教程和Shadowrocket App Store 页面。
如果希望未匹配请求直连,可把最后一行改为 FINAL,DIRECT。规则从上到下检查,具体规则应放在宽泛规则前面,FINAL 通常放在末尾。
先分清服务器、订阅和 .conf 文件
配置文件写不对,很多时候不是逗号问题,而是把三类内容混在了一起。服务器记录描述“连接到哪里以及如何认证”;服务器订阅通常负责批量导入或更新这些记录;.conf 文件则描述请求应该匹配哪条规则、使用哪个策略,以及部分全局设置。
| 对象 | 主要作用 | 能否单独完成规则分流 |
|---|---|---|
| 服务器记录 | 保存地址、端口、协议和认证信息 | 通常不能,只提供连接入口 |
| 服务器订阅 | 批量导入或更新服务器记录 | 通常不能替代规则配置 |
| .conf 配置文件 | 组织全局设置、策略组和分流规则 | 可以描述分流,但不会自动提供真实凭据 |
公开说明也区分了服务器订阅与配置订阅:前者在添加服务器的位置使用,后者在 Config 页面管理配置文件。一个链接能打开,不代表它适合当前导入入口。需要进一步排查时,可参考站内的iPhone Shadowrocket 怎么设置代理。
四种常用需求模板速查
不要先复制一整套复杂配置。先确定你要的是全局代理、按地区分流、精确域名代理,还是简单拦截,再只添加对应规则。以下模板都不含真实节点信息。
| 需求 | 核心规则 | 适用说明 |
|---|---|---|
| 全局代理 | FINAL,PROXY | 前面没有匹配到的请求统一使用当前选中的代理策略。 |
| 国内直连、其他流量代理 | GEOIP,CN,DIRECT | 按目标 IP 的地区数据库结果匹配,不是按网站语言或域名后缀判断。 |
| 精确广告域名拦截 | DOMAIN-SUFFIX,ads.example,REJECT | 只示范对明确域名后缀进行拦截,不能把不确定的关键词直接照抄。 |
| 仅指定域名代理 | DOMAIN-SUFFIX,work.example,PROXY | 只有指定域名及其子域名走代理,其余请求直连。 |
GEOIP 依赖目标 IP 与地区数据库,分布式服务、DNS 结果和数据库更新都可能影响匹配。DOMAIN-KEYWORD 会在域名中查找字符串,范围通常比精确域名或域名后缀更宽,因此不建议把 ads 这类短词直接用于拦截;它可能误伤包含该字符串的正常域名。规则类型和匹配顺序可参考Shadowrocket 规则关键词与术语说明。
[General]、[Proxy Group] 和 [Rule] 怎么配合
[General]:全局设置,不是分流动作
[General] 常用 key = value 格式。下面只展示可核对的基础写法:
[General]
dns-server = system
bypass-system = true
ipv6 = false
skip-proxy = 192.168.0.0/16,10.0.0.0/8,localhost,*.localdns-server = system:示例表示使用系统 DNS;它不等于所有请求直连。bypass-system = true:涉及系统相关绕过行为,改变后可能影响多个请求类型,排查时不要和规则、服务器一起改。ipv6 = false:关闭 IPv6 相关处理的示例开关;是否适合你的网络需结合当前配置核对。skip-proxy:列出不经过代理处理的地址或域名范围。不要把办公域名、局域网段随意加入。
如果现有配置已经有同名字段,应修改原行,不要重复添加。不同版本或配置来源支持的字段可能不同,未列出的 General 字段需以当前应用界面和现有配置为准。
[Proxy Group]:自定义策略组
PROXY 不需要在这里重复定义,它通常表示当前首页选中的代理策略。只有当你需要一个自定义名称,例如 WorkRoute,才需要在 [Proxy Group] 中定义,并让 Rule 最后一列使用完全相同的名称。
[Proxy Group]
WorkRoute = select, PROXY, DIRECT
[Rule]
DOMAIN-SUFFIX,work.example,WorkRoute
FINAL,DIRECT这里的 WorkRoute 是策略组名称,PROXY 和 DIRECT 是组内可选策略。实际配置中,组内引用的节点或策略必须已经存在;名称大小写、空格和标点不一致,都可能导致引用失败。自定义策略组语法和字段支持可能随版本变化,导入前应以当前应用接受的格式为准。
[Rule]:按顺序决定请求动作
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,WorkRoute
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXYDOMAIN:匹配一个精确域名,不自动覆盖子域名。DOMAIN-SUFFIX:匹配域名及其子域名。IP-CIDR:匹配 IPv4 地址段;IPv6 需要另写IP-CIDR6规则。GEOIP:按目标 IP 的地区数据库结果匹配。DIRECT:直连;PROXY:使用当前代理策略;REJECT:拒绝请求。FINAL:前面的规则都未命中时使用的兜底动作。
no-resolve 只影响该 IP 规则是否为了匹配而主动触发域名解析,不是关闭全部 DNS。IPv4 规则也不会自动覆盖 IPv6。
导入后不生效:30秒自查卡
按照下面四项逐项勾选,先只改一个变量再复测同一个域名:
- □ 文件:Config 列表中是否选中了刚编辑的文件,而不是同名旧文件或远程文件?
- □ 模式:Home → Global Routing 是否为
Config?选择Proxy只能测试当前服务器的代理模式,选择Direct只能做直连对照,二者都不能证明 Rule 已执行。 - □ 策略:Rule 最后一列如果写的是
PROXY,它会使用首页当前选中的代理;如果写的是WorkRoute等自定义名称,则必须能在[Proxy Group]或现有配置中找到同名策略。 - □ 顺序:精确域名规则是否放在域名后缀、关键词规则和
FINAL之前?如果宽泛规则先命中,后面的规则不会再覆盖它。
接着保持服务器、文件和模式不变,访问同一个地址并查看请求记录。若“节点为空”,先确认导入的是服务器订阅还是配置文件;若“能连接但网页打不开”,分别检查服务器选择、Global Routing、DNS 和实际请求结果,不要一次更换所有参数。可继续阅读站内的Shadowrocket 规则不生效怎么办。
如果你要比较不同节点,不要只看一次延迟数值;应保持测试目标和网络环境一致,再结合真实访问结果。相关步骤可参考Shadowrocket 测速怎么选节点。
保存、导入和安全注意事项
- 编辑前复制一份原始配置,尤其是远程配置或订阅生成的文件。
- 使用半角方括号、英文逗号和等号;不要把中文解释直接写在规则行末尾。
- 保存为纯文本,文件扩展名使用
.conf;如果系统自动变成.conf.txt,需要重新检查文件名。 - 导入后分别确认“文件存在”“文件已选中”“Global Routing 为 Config”,这三个状态不是同一件事。
- 订阅链接可能包含访问凭据,不要公开发布完整 URL、密码、Token、私钥或完整配置截图。
- 远程配置更新可能覆盖本地修改,手动编辑前保留私有备份。
请在所在地法律法规允许的范围内使用网络配置与代理工具。核对日期:2026年11月15日。Shadowrocket 的界面、字段可选值、地区可见性和 App Store 信息可能随版本或地区变化;本文未核实具体版本号,不作版本承诺。
常见问题
PROXY 是不是需要在 [Proxy Group] 中自己创建?
通常不需要。PROXY 是规则策略,表示使用首页当前选中的代理服务器。只有自定义的 WorkRoute 等策略组,才需要在 [Proxy Group] 中定义,并在 Rule 中使用完全一致的名称。
配置文件导入成功,为什么规则还是不生效?
依次检查 Config 中是否选中了正确文件、Home → Global Routing 是否为 Config、Rule 是否引用了存在的策略,以及具体规则是否排在 FINAL 或宽泛规则之前。
GEOIP,CN,DIRECT 一定能准确判断国内网站吗?
不能保证。GEOIP 根据目标 IP 和地区数据库匹配,DNS 结果、CDN、分布式服务和数据库变化都可能影响结果;它不是按网站语言或域名后缀判断。
为什么不建议直接使用 DOMAIN-KEYWORD,ads,REJECT?
关键词规则会在域名中查找字符串,范围较宽,可能误伤包含该字符串的正常域名。对明确目标,优先使用 DOMAIN 或 DOMAIN-SUFFIX,并先验证实际命中结果。
只有 .conf 文件,没有节点订阅,能直接连接吗?
通常不能。配置文件主要描述规则和策略,服务器记录才包含连接地址、协议和认证信息。没有可用服务器记录时,PROXY 规则不会凭空生成连接服务。
[General] 里的 dns-server、bypass-system 和 skip-proxy 能随便改吗?
不建议。它们影响全局解析或绕过范围,改动可能同时改变多个请求的行为。先备份原文件,一次只改一项,并用同一个域名复测。
相关阅读
参考资料
- Shadowrocket App Store 页面
- Shadowrocket 设置、订阅导入与路由检查教程(shadowrocketdocs.com)
- Shadowrocket 规则关键词与术语说明(shadowrocketdocs.com)
- Shadowrocket 全局路由、规则与连接设置说明(shadow-official.com)
- Shadowrocket .conf 文件结构:General、Rule、Host 与 URL Rewrite(shadow-official.com)