官网与官方手册

Shadowrocket 使用说明全平台下载与规则分流

Shadowrocket 是全平台规则代理客户端:导入已有的服务器或订阅,按规则分流;iPhone / iPad 在 App Store $2.99 一次性买断,Mac、Windows、安卓、Linux 版免费。

当前安装包版本 v2.2.92 · iPhone / iPad $2.99 一次性;Mac、Windows、安卓、Linux 版免费。

查看首次使用教程

Global Routing Shadowsocks On Demand

规则匹配

将条件与策略写在同一行。

RULE

订阅地址

使用已有链接;下方为假值。

SUBSCRIBE

按需连接

连接时机与流量策略分开设置。

ON DEMAND

CONFIGURATION

分流、连接与配置管理

先区分三个对象:服务器信息决定连接到哪里,配置文件决定请求走哪条路径,连接开关决定客户端是否接管流量。遇到故障时,按这个顺序逐项核对,比同时修改多个设置更容易确定原因。

RULE ROUTING

按规则决定请求路径

在 Home 的 Global Routing 选择 Config 后,客户端按当前配置文件逐条检查规则。具体域名的例外应写在更宽泛的规则之前,未命中前序条件的请求再交给末尾的 FINAL。临时比较连接行为时,可以切换到 Proxy 或 Direct,分别对照代理与直连的结果。对照结束后切回 Config,再确认当前选中的文件;否则即使规则已经保存,测试的也不是这份规则。

DOMAIN-SUFFIX,example.com,PROXY GEOIP,CN,DIRECT FINAL,PROXY

ON DEMAND

按网络条件启动连接

在 Settings 打开 On Demand,核对希望触发连接的网络条件。按需连接解决的是何时启动,不能代替 Global Routing 决定请求经代理还是直连。建议先在当前网络手动连通,再切换到需要测试的网络,观察触发结果。如果手动可连而自动连接不符合预期,先查看条件是否覆盖当前网络,并确认系统里实际启用的是哪份 VPN 配置,不要先改服务器参数。

On Demand Global Routing

PROTOCOLS

按已有服务器选择协议

在 Add Server 先设置 Type,再按已有服务器信息填写 Host、Port 和所选协议要求的字段。不同类型需要的身份验证信息不同;某个字段在切换类型后消失,不表示信息丢失,而是当前类型可能用不到它。若复制后不能连接,逐项核对协议、主机、端口与凭据,并检查首尾有没有多余空格。不要用反复切换协议的方式猜测服务端配置。

Shadowsocks VMess VLESS Trojan HTTP/SOCKS5 WireGuard Hysteria2

SUBSCRIBE

导入已有订阅并核对更新

已有订阅地址时,在 Add Server 选择 Subscribe,完整粘贴从服务商处取得的地址并保存。回到 Home 检查对应分组是否出现,以及准备使用的条目是否仍在列表中。订阅更新成功只说明客户端取到了列表,不代表每台服务器都可达。若更新失败,先分别检查地址是否完整、当前网络是否可用、链接是否已被替换。分享故障截图前,遮住地址中的查询参数和凭据。

Add Server → Subscribe https://example.com/sub?token=xxxx

CONFIG & DIAGNOSTICS

核对生效文件与流量记录

在 Config 确认选中的配置文件,编辑前保留一份可恢复的原配置。有多台设备时,可按应用中的 iCloud 设置核对可同步的项目,不把同步当作配置备份。连接异常时,在 Home 用 Connectivity Test 检查服务器,再看 Data 的流量统计和 Settings 中的 Diagnostics。流量增加只说明有请求经过客户端,不能据此判断某个目标命中了哪条规则。

Config Data Diagnostics

按现象核对设置

先看 Global Routing 是否为 Config,再看 Config 里的当前选中项。若两处正确,记录实际访问的主机名,不要只看地址栏最后显示的域名;页面内容可能来自其他主机。检查目标规则之前有没有更宽的匹配条件,以及未匹配时交给了哪项策略。每次只改一处,用同一网络和同一目标复测,确认变化来自规则而不是网络切换。

PLATFORM DOWNLOADS

按设备选择下载方式

iPhone / iPad 在 App Store $2.99 一次性;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费,安装包通过本站下载页的 /dl/shadowrocket/ 路径获取。以下入口先显示对应设备的选项,不会在点开卡片时直接启动安装。

FIRST CONNECTION

首次连接的三个步骤

以下步骤以 iPhone / iPad 的界面为例。先准备已有的服务器参数或订阅地址,并确认设备在未开启代理时能正常联网。这样如果首次连接失败,就能先排除设备本身没有接入网络的情况。

一、添加服务器或导入订阅

只有一台服务器的参数时,从 Home 进入 Add Server,核对 Type 后逐项填写,再保存并返回列表。有订阅地址时,则用 Subscribe 导入,让列表由订阅内容生成。两种方式都不需要重复添加同一条记录。保存后查看 SERVER 分组,确认选中的是这次准备用于测试的服务器,而不是上一次保留的条目。手动添加与订阅条目可能显示相近的名称,可以先按来源确认自己的选择;检查页面时不必把地址或凭据贴到公开位置。

二、选定 Global Routing 模式

需要按规则处理请求时,先在 Config 确认当前文件,再回到 Home 把 Global Routing 设为 Config。要判断故障是否与规则有关,可以在同一网络上选用 Proxy 和 Direct 进行对照。测试期间只改模式,不同时换服务器、配置文件或网络;若只有规则模式下的结果不同,就优先检查文件与匹配顺序。记录测试前采用的模式,结束后恢复日常设置,避免把临时选项当作之前的配置结果。

三、打开开关并验证实际访问

回到 Home 打开连接开关。首次出现系统 VPN 配置请求时,先确认请求来自当前打开的 Shadowrocket,再按系统提示授权。连接状态变化后,先做一次 Connectivity Test,再访问一个预期直连的目标和一个预期经过代理的目标。某项结果与预期不符时,记录网络类型、当前模式、配置文件和错误提示;不要把连接开关已打开当作业务验证通过。若两个目标都失败,可以暂时断开后复测同一目标,先判断基本网络是否也受影响。

查看完整教程

STORE VERIFICATION

正版核对、购买记录与更新

开发者 Shadow Launch Technology Limited 应用 ID 932747118 2 档获取

看开发者、图标和应用 ID

打开 Shadowrocket 的 App Store 产品页,先核对开发者是 Shadow Launch Technology Limited,再对照白底、蓝紫描边的官方图标,最后检查产品页链接里的 id932747118。搜索结果中的名称和图标可能相似,中文别称「小火箭」也不能作为购买凭据。核对时以产品详情为准,不只看列表摘要。开发者名与应用 ID 应来自同一个产品页;有任一项对不上,就不要把该条目当成本手册所述的应用。

在 App Store核对 Shadowrocket 产品页

区分商店地区与系统地区

应用是否显示与当前账号使用的 App Store 店面有关,不应只看设备的语言或系统地区。搜索不到时,先通过产品页核对是否有店面可用性提示,再打开 Apple 账号的「媒体与购买项目」,检查当前用于获取应用的账号与国家或地区。中国大陆店面不提供该条目;打开美区产品页仅用于核对,不会自动改变账号的店面。若店面可用但无法下载,再检查设备限制与兼容性;iPhone / iPad 的系统要求以 App Store 页面标注为准。需要进一步区分提示时,参见App Store 指南。

用原购买记录在另一台设备获取

iPhone / iPad 在 App Store 美区 $2.99 一次性买断,各店面以当地显示为准;Mac、Windows、安卓、Linux 版免费。同一笔购买可供 iPhone 和 iPad 使用,不需要按设备分别购买。换机或重装时,用原购买账号打开 App Store,进入已购项目,找到 Shadowrocket 后重新下载。若出现价格而不是重新下载入口,先核对购买账号与店面,不必立即下单。重新下载恢复的是应用本身;已有订阅、手动添加的服务器和本地规则仍需按各自的同步或备份状态核对。

区分客户端与已有线路

因此,应用可以正常打开,并不说明已有服务器仍可用;反过来,订阅一时无法更新,也不能据此判断购买记录有问题。遇到连接异常时,先分清是在获取应用、导入资料,还是访问目标时出现提示。应用获取问题看商店或安装入口;已有服务的信息变动按原服务记录核对;模式和规则问题回到 Home 与 Config 逐项检查。

按原获取渠道更新

iPhone 和 iPad 在 App Store 查看更新,可沿用系统的自动更新设置。Mac、Windows、安卓和 Linux 从本站下载页重新获取对应安装包,不必以文件名相似作为版本或来源判断。更新前记下正在使用的模式和配置文件,保留必要的本地备份;更新后先手动连接一次,再核对订阅更新、规则分流和 On Demand 是否仍按预期工作。若系统弹出安装提示,先核对下载来源,再查看下载页对应平台的安装说明,不要对来源不明的文件放行。

READING NOTES

近期使用日志

按当前问题选读:域名偶发打不开,先看解析路径;拿到链接却不知道放在哪里,先辨认链接类型;只有分流结果不符时,再查规则的匹配条件和顺序。

免费下载 Shadowrocket