iPhone
在 App Store 核对产品后购买并安装。首次建立连接时,系统会请求添加 VPN 配置;确认应用名称与操作来源后再授权。安装完成不代表服务器信息已经就绪,仍需导入你已有的订阅或填写服务器参数。
建议先完成一次手动连接与网页访问检查,再设置 On Demand。这样遇到问题时,可以区分是基础连接未建立,还是自动连接条件没有满足,避免同时修改多个选项而难以判断原因。
查看 iPhone 获取步骤01 / App Store
Shadowrocket(小火箭)仅通过 App Store 发行。先确认购买账号与设备兼容性,再进行首次设置;系统要求与购买适用范围均以 App Store 页面标注为准。
在 App Store 核对产品后购买并安装。首次建立连接时,系统会请求添加 VPN 配置;确认应用名称与操作来源后再授权。安装完成不代表服务器信息已经就绪,仍需导入你已有的订阅或填写服务器参数。
建议先完成一次手动连接与网页访问检查,再设置 On Demand。这样遇到问题时,可以区分是基础连接未建立,还是自动连接条件没有满足,避免同时修改多个选项而难以判断原因。
查看 iPhone 获取步骤使用购买时的同一 Apple ID,在 App Store 已购项目中检查 Shadowrocket。iPhone 与 iPad 的购买适用范围以 App Store 页面标注为准;界面会随屏幕尺寸调整,导入订阅、选择 Config 和授权连接的基本顺序一致。
应用购买记录与客户端配置是两件事。另一台设备能够安装应用,并不表示服务器条目和配置文件已经恢复。开始连接前,应核对当前选中的服务器、配置文件以及订阅更新结果。
查看 iPad 获取步骤Mac / Apple TV 也可在同一 App Store 获取,系统要求及兼容性以 App Store 页面标注为准。
查看获取步骤02 / Configuration
先区分服务器、订阅和 Config:服务器提供连接参数,订阅用于更新服务器条目,Config 决定规则与相关设置。选中服务器不等于选定所有流量的走向,还需要检查 Global Routing。
在 Config 中查看或编辑 Rule,并将 Global Routing 设为 Config,流量才按所选配置逐条匹配。DOMAIN-SUFFIX 匹配域名后缀,IP-CIDR 匹配地址范围,DIRECT 表示直连,PROXY 表示交给代理策略。规则顺序会影响结果,应把更具体的条件放在宽泛条件之前,再用 FINAL 处理剩余请求。修改后保存并确认使用的是该配置;不要把示例片段直接当作适合所有网络的完整配置。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
阅读规则与功能说明
On Demand 用于按已设置的网络条件请求连接,入口位于 Settings。应先确认手动连接可用,再逐项设置触发条件,分别在常用网络下观察结果。它管理的是何时连接,而不是连接后每个请求使用什么策略,因此不能代替 Rule 或 Global Routing。调整条件后,检查系统中的 VPN 状态与实际访问结果;若需要临时停止自动连接,应同时检查 On Demand 设置,避免仅关闭主开关后又被条件触发。
Settings → On Demand
查看按需连接说明
Shadowrocket 支持 Shadowsocks、VMess、VLESS、Trojan、WireGuard 等协议。手动添加时,从 Add Server 的 Type 选择与已有服务器信息一致的类型,再核对 Host、Port 以及该类型所需的认证、传输和 TLS 参数。不同协议的字段不能互相套用,名称相似也不意味着可以省略参数。遇到导入后无法连接,应先检查链接是否完整、字段是否被正确识别,再确认服务端要求,而不是仅凭协议名称反复切换类型。
Shadowsocks · VMess · VLESS
Trojan · WireGuard · Hysteria2
查看服务器字段说明
已有订阅链接时,在 Add Server 中选择 Subscribe,填写地址并保存,再检查更新结果。链接应从你的服务商处获取,复制时保留完整参数,避免夹带空格、换行或说明文字。订阅负责集中维护服务器条目,不会自动替你决定所有规则策略。更新失败时,先确认链接是否有效、返回内容是否为客户端支持的格式,以及当前网络能否访问订阅地址。订阅链接可能包含访问凭据,不应公开粘贴到截图、文章评论或诊断记录中。
Add Server → Type → Subscribe
查看订阅更新策略
Config 用于管理配置文件,常见分节包括 General、Rule 和 Hosts。编辑之前先保留可用副本,每次只调整一类设置,保存后确认当前选中的文件。Global Routing 的 Config、Proxy、Direct 分别用于按配置分流、统一交给代理策略和直连,临时切换后应记得恢复。若使用 iCloud 同步,应检查同步范围与设备上的实际文件;应用购买记录、配置文件和订阅内容分别管理,换机后仍需逐项核对。
[General]
dns-server = system
[Rule]
FINAL,PROXY
理解 Global Routing 三种姿态
Home 中的 Connectivity Test 可辅助检查服务器响应,Settings 中的 Diagnostics 用于进一步定位问题。测试结果受测试方法、当前网络和目标响应影响,有延迟数值不等于实际网页一定可访问。应结合连接状态、请求记录和 DNS 解析结果判断,并在 Data 中观察流量变化。Data 反映客户端统计,不等于服务商账户的剩余额度。排查时先保留错误提示,再依次检查服务器参数、路由姿态与 DNS,避免一次改动多处。
Home → Connectivity Test
Settings → Diagnostics
Data
查看连接检查顺序
03 / Purchase & verification
本站是 Shadowrocket 官网与官方手册。应用身份以 App Store 产品页为核验依据,购买记录由 App Store 管理;本手册说明设置方法,购买前仍应阅读商店当前显示的信息。
打开 App Store 产品页后,先确认名称为 Shadowrocket,再查看开发者是否为 Shadow Launch Technology Limited。将商店图标与本站页头使用的官方图标进行对照,并检查产品页地址中的应用 ID 是否为 932747118。名称、图标、开发者和应用 ID 应一起核对,不要仅凭搜索列表中的简称或相似图案作决定。
若搜索结果较多,可以先进入本页的商店说明,再打开指定产品页。浏览器中的介绍文字不能替代购买确认页:实际扣款前,应再次看清应用名称、价格和当前使用的 Apple ID。Shadowrocket 是闭源商业应用,购买、安装与后续更新均通过 App Store 完成。
App Store 内容会受账号所属店面与设备兼容性影响。搜索不到应用时,先检查当前登录的购买账号、商店地区以及产品页提示,而不是把搜索结果缺失直接理解为客户端故障。系统要求一律以 App Store 页面标注为准,兼容性栏也应在准备安装的设备上核对。
价格会按店面使用的货币显示,美区参考价格为 2.99 美元,一次性付费,实际支付金额以购买时的商店页面为准。若页面出现需要确认账户信息的提示,应按 App Store 自身流程处理。手册中的设置操作不会改变账号的购买资格、地区条件或商店可见性。
换机或重装后,先使用原购买账号进入 App Store 的已购项目,查找 Shadowrocket 并重新下载。应用是否可在另一台设备上使用、是否适用通用购买或家人共享,以 App Store 页面标注为准。如果商店仍显示购买价格,应先核对账号与历史订单,不要急于重复付款。
恢复应用购买不等于恢复客户端数据。准备换机时,应分别检查配置文件备份、订阅地址和服务器信息;若启用 iCloud 同步,也要确认新设备实际出现了需要的文件。恢复后先选择配置和服务器,再进行一次手动连接测试。订阅内容已经变化时,以重新更新后的条目为准,旧备份不能证明服务器仍然有效。
查看已购项目恢复说明应用更新通过 App Store 进行,可在商店中检查更新记录及自动更新设置。订阅更新则发生在客户端内,用于重新获取已有订阅中的服务器条目。这两类更新互相独立:更新应用不会延长连接服务的有效期,刷新订阅也不会改变已经安装的应用。
调整配置或进行较大范围的服务器整理前,先备份当前可用设置。更新订阅后,核对选中服务器是否仍存在、名称是否改变,以及原有排序是否需要调整。不要为了恢复某个已失效条目而反复覆盖当前配置;先确认服务端状态,再决定是更新订阅、修正字段,还是恢复备份中的配置文件。
阅读订阅更新与整理方法先确认服务器条目已生成并选中其中一项,再检查 Global Routing 与当前 Config。完成系统 VPN 配置授权后开启连接,使用实际网页请求验证结果。不要仅凭条目数量或开关状态判断设置完成。按教程逐步检查
延迟测试与网页访问可能使用不同的目标和路径。先记录具体错误,再检查 DNS、规则命中与服务器参数;若近期刚修改配置,优先与备份比较差异。每次只改一项并重复相同测试,才能判断改动是否有效。查看 DNS 排查说明
先确认文件或链接是否包含认证字段、服务器地址或访问凭据,再决定保存与分享范围。排查问题时只提供必要的错误信息,并遮去订阅参数和认证内容。导入陌生配置前应阅读规则与相关设置,保留原有可用副本以便恢复。查看导入与备份手册
04 / Field notes
将容易混淆的设置单独展开:先辨认问题发生在解析、规则还是连接阶段,再按对应步骤验证。阅读时保留当前可用配置,不必为了尝试某个选项同时重设所有参数。
延迟测试有结果,实际请求却失败时,如何区分 DNS 解析、服务器连接与规则策略的问题。说明 dns-server 的含义,以及系统 DNS 与自定义设置的检查顺序,先定位再修改。
阅读说明配置、代理、直连分别对应 Config、Proxy、Direct。理解三种姿态的流量走向,确认什么时候规则参与匹配,并在临时测试结束后恢复原有设置,避免把路由选择误判为服务器异常。
阅读说明从域名与 IP 匹配理解 REJECT 的生效范围,说明规则顺序与目标识别如何影响结果。同一域名承载多类内容时,简单拒绝可能影响正常请求,应先验证匹配对象再决定保留规则。
阅读说明