iPhone
适合从 Home 完成已有连接信息的添加、选择与验证。购买前展开商店的兼容性说明，确认当前系统满足要求。首次开启连接时，系统会请求添加 VPN 配置；应核对应用名称并理解授权用途后再继续。
安装完成只代表客户端已就绪。请先准备自己的订阅或服务器信息，确认地址、端口与认证字段完整，再按教程导入；不要把商店购买成功当作连接已经可用的依据。
前往 iPhone 获取说明 →Shadowrocket 使用说明 小火箭订阅导入与规则分流
面向 iOS / iPadOS 的规则代理客户端；核对 App Store 正版与一次性买断信息后，导入已有订阅，再验证规则与连接。
Rules
On Demand
Config
Protocols参数参考 →
- Shadowsocks
- VMess
- VLESS
- Trojan
- Hysteria2
- WireGuard
App Store核验 →
- Developer
- Shadow Launch Technology Limited
- App ID
- 932747118
Global Routing模式说明 →
- Config
- Proxy
- Direct
- Scenario
先理解 Config / Proxy / Direct 三种基本姿态；Scenario 用于按场景组织选择，具体行为应在应用内核对。
App Store / Devices
设备兼容性与商店入口
先确认设备与购买账号，再进入 App Store 产品页。系统要求、兼容性与通用购买均以 App Store 页面标注为准。
iPad
已购买时，先使用购买应用时使用的 Apple ID 查看 App Store 已购项目；两种设备的通用购买适用性以商店页标注为准。横屏下列表与编辑区域的排列可能不同，操作时应按 Home、Config、Settings 等界面词定位。
购买记录与应用配置是两件事。在另一台设备重新获取应用后，仍需检查本机服务器列表、当前 Config 与系统授权。即使使用 iCloud 同步，也应实际打开配置核对，而不是仅凭文件名称判断内容一致。
前往 iPad 获取说明 →Mac / Apple TV 也可在同一 App Store 获取，以商店页兼容性标注为准。
商店是否显示可购买、显示何种货币以及已购记录是否可用，应在当前购买账号对应的店面核对。若搜索结果与预期不符，先使用下方产品页入口，再检查开发者、图标与应用 ID。
Capabilities
规则配置与连接管理
按任务查找能力：Rules 决定请求路径，Protocols 对应连接参数，Subscribe 维护导入来源。On Demand 与 Diagnostics 分别处理自动触发和结果检查，不能替代服务器参数本身。
Rules：按条件选择策略
规则分流用于区分哪些请求经过代理、哪些直接连接，以及哪些需要拒绝。在 Config 中检查 Rule 分段，并在 Global Routing 使用 Config 时验证效果。规则通常按从上到下的顺序匹配，具体条件应放在宽泛条件之前，FINAL 放在末尾兜底。DOMAIN-SUFFIX 检查域名后缀，IP-CIDR 检查目标地址网段；修改前先保留原配置，再确认策略名称与当前可用选择一致。
- 核对规则顺序与匹配范围
- 区分 PROXY、DIRECT、REJECT
- 用实际请求确认命中结果
On Demand：检查自动触发条件
On Demand 用于按网络等条件触发连接行为，不等于所有请求都采用同一条路由。在 Settings 中进入 On Demand，先确认连接本身可用，再逐项设置需要的条件。按 Wi-Fi、Cellular 或域名组织条件时，应同时考虑条件的适用范围与顺序，避免多个条件互相覆盖。保存后分别在目标网络与其他网络验证；若出现意外重连，先检查自动触发设置，再判断是否属于服务器连接故障。
- 先用手动连接确认基础配置
- 分别验证 Wi-Fi 与 Cellular 条件
- 把触发行为与路由策略分开检查
Protocols：按已有信息选择 Type
多协议支持意味着可以按服务器配置选择相应 Type，并不意味着不同协议的字段能够混用。在 Add Server 中先核对 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 或 Hysteria2 等类型，再填写 Host、Port 与对应认证信息。涉及 TLS、传输方式或密钥时，应逐项遵照已有配置。协议名称相同也可能存在参数差异；不要仅更换 Type 后沿用原有字段，应重新检查整组连接信息。
- Type 必须与服务器端对应
- 核对认证、TLS 与传输参数
- 不把一次测试结果当作协议排名
Subscribe：导入并维护已有订阅
订阅用于集中导入和更新服务器条目，前提是用户已持有自己的有效订阅。在 Add Server 中按导入方式填写完整链接，保存后检查来源分组与条目是否出现。更新失败时，先区分链接无法访问、返回内容不兼容和条目参数不完整，再逐项排查。订阅更新可能调整服务器列表，但不能据此推断当前 Config 也已改变。链接可能包含访问凭据，分享诊断信息时应隐藏相关内容，避免公开完整地址。
- 保留来源标识，便于分组管理
- 更新后核对新增与失效条目
- 分开维护 Subscribe 与 Config
Config：确认当前生效文件
Config 保存规则及相关设置，编辑某个文件并不必然意味着它已成为当前使用的配置。在 Config 页面确认选中项，再检查 General、Rule、Hosts 等分段。需要使用 iCloud 同步时，应在 Settings 核对相关设置与系统 iCloud 状态，并在另一台设备检查实际内容。同步文件不等同于同步全部运行状态；切换配置前保留可用副本，修改后回到 Home 确认 Global Routing，再测试受影响的请求。
- 区分编辑文件与选中配置
- 更改前保存可恢复的副本
- 同步后检查内容与本机选择
Diagnostics：用结果定位故障范围
连接开关、Connectivity Test 与实际请求反映的是不同层面的结果，应结合观察。在 Home 先测试选中的服务器，再在 Settings 的 Diagnostics 中查看诊断信息；通过 Data 观察流量变化时，还应区分统计范围与观察时段。延迟测试成功不能证明所有目标都可访问，流量计数也不能直接证明规则正确。先检查本地网络和服务器参数，再核对 DNS 与规则命中；每次只改一类设置，保留修改前后的结果便于比较。
- 区分测试可达与实际请求成功
- 检查 Data 的统计范围和时段
- 提供诊断信息前隐藏凭据
先核对输入与条件。再验证连接与规则结果。
Global Routing 与协议类型分开选择
Config 按当前配置中的规则决定请求路径；Proxy 用于让请求采用代理姿态；Direct 用于直接连接。协议类型则描述客户端如何与服务器通信。改变 Global Routing 不会修正错误的密码、密钥或端口，切换协议类型也不会自动补全缺失的规则。
统计、同步与自动连接分别验证
Data 用于观察统计，iCloud 用于相关配置同步，On Demand 用于按条件触发。三者解决不同问题。排查时先明确是“没有触发连接”“配置没有同步”还是“请求没有按预期路由”，再进入对应界面检查，避免同时修改多项设置而失去判断依据。
Home → Global Routing → Verify
首次连接的三个步骤
已经从 App Store 安装应用，并准备好自己的订阅或服务器信息后，再按以下顺序操作。先完成一组可验证的基础配置，再添加更细的分流规则和自动触发条件。
添加已有连接信息
在 Home 进入 Add Server。手动填写时先选 Type，再核对 Host、Port 及认证字段；导入订阅时使用自己的完整链接，并在保存后确认 SERVER 分组中已有条目。通过 Scan QR Code 导入后，也应打开条目检查参数。
若保存后列表为空，先检查导入内容与链接是否完整，不要反复创建同名条目。先保留一条来源明确的连接进行测试；协议包含 TLS 或额外传输字段时，应与服务商提供的信息逐项一致，而不是凭字段名称猜测填写。
选择姿态与当前配置
回到 Home 选择需要测试的服务器，再核对 Global Routing。准备按规则分流时使用 Config，并到 Config 页面确认当前选中的配置文件；需要临时区分规则问题与服务器问题时，再结合 Proxy、Direct 的用途进行对照。
配置文件存在不等于已经选中，文件名称相同也不等于内容相同。尤其在另一台设备导入或同步后，应检查 Rule 分段与 FINAL 的策略。首次测试尽量保留简单、可解释的规则，确认结果之后再逐步增加条件。
开启连接并验证请求
打开连接开关，按系统提示处理 VPN 配置授权。随后运行 Connectivity Test，并访问自己需要使用的目标，结合请求记录和规则命中判断结果。系统出现连接标识，只说明相关连接状态，不应作为目标请求已成功的唯一依据。
若测试超时，先确认本地网络正常，再核对地址、端口、认证与系统时间；若只有部分目标异常，再检查 DNS 和规则。每次修改后重新测试同一个目标，记录结果差异。涉及订阅地址和诊断记录时，先隐藏凭据再分享。
Developer / Artwork / App ID
正版核验与购买事实
Shadowrocket 是闭源商业应用，唯一获取入口是 App Store。本站为 Shadowrocket中文官网与官方手册；购买、兼容性和更新信息以 App Store 产品页为核对依据。
核对开发者、官方图标与应用 ID
从商店入口打开产品页后，先确认名称为 Shadowrocket，再查看开发者是否为 Shadow Launch Technology Limited。接着对照本站展示的官方图标，最后检查产品页链接中的应用 ID 是否为 932747118。名称只能用于初步定位，三项信息应一起核对。
搜索结果可能包含相似名称或图标的应用，因此不宜只按搜索排序或名称中的单个词判断。若从搜索结果进入的页面与上述信息不一致，应返回本站下载说明页重新打开指定产品页。购买确认前再检查一次应用名称与账号，避免在信息尚未确认时完成付款。
官方图标用于辨认产品身份，并不替代商店里的开发者信息和产品链接。核验完成后，系统要求、兼容设备以及购买适用性仍应以该产品页当前显示的内容为准。
查看三要素核验步骤 →价格、店面与购买范围
Shadowrocket 为一次性买断，美区定价约 2.99 美元，实际金额以 App Store 页面为准；其他店面按当地货币显示。页面语言、设备语言与购买账号所在店面不是同一个概念，应在当前账号打开的商店中确认价格、付款条件与可购买状态。
一次性买断描述客户端的付费方式，不表示连接服务已包含在购买中，也不能作为已有订阅长期有效的依据。应用购买、服务器认证和订阅有效性属于不同事项：商店处理应用获取，已有连接信息的可用性则需要在客户端导入后测试。
同一 Apple ID 在 iPhone 与 iPad 上使用已购项目时，通用购买适用性以商店页标注为准。家人共享等购买相关条件也应查看产品页和系统实际提示，不应仅凭另一台设备已安装就推断当前账号拥有购买记录。
查看价格与买断说明 →重新获取应用与恢复配置
换机或重新安装时，先使用购买应用时使用的 Apple ID 在 App Store 的已购项目中查找 Shadowrocket。若显示的购买状态与预期不同，先核对账号与店面信息，再查看购买记录，避免把重新获取应用与重新购买混为一谈。是否可在当前设备获取，仍应检查兼容性。
恢复购买记录不会自动补全全部连接参数。重新打开应用后，应分别核对服务器列表、订阅来源、当前 Config 和 VPN 配置授权。准备使用 iCloud 同步时，检查系统与应用内相关设置，并在本机确认文件内容已经到位。
删除应用前，应先确认必要配置已有妥善保存。尤其是手动添加的服务器信息、用户修改过的规则和未同步的本地文件，需要单独确认恢复方式；不要把“已购可重新获取”理解为“本地配置一定能恢复”。
查看已购恢复说明 →通过 App Store 更新与复查
应用更新通过 App Store 进行，可在系统允许的情况下使用自动更新，或进入商店检查更新记录。系统要求与兼容性可能变化，应在操作前查看产品页当前标注；本页不列具体版本号和更新日期，避免把静态说明误当作实时状态。
更新后如果发现界面排列不同，先按 Home、Config、Settings 等界面词寻找入口，再核对相关设置是否仍符合预期。若连接行为改变，应先查看当前选中的服务器与 Config，而不是立即删除所有配置。原本可用的参数和测试结果可以作为复查依据。
记录问题时，可说明操作步骤、网络环境、所选协议与错误现象，但应隐藏订阅链接中的凭据、密码及私钥。用于排查的信息越能区分“连接失败”和“规则结果异常”，后续检查就越容易保持单一变量。
查看导入与连接排查 →购买与首次使用常见问题
已经购买，为什么还需要导入连接信息？
购买获得的是客户端使用资格。请使用自己已有的订阅或服务器信息，在 Add Server 完成导入后再选择条目测试；应用购买与连接服务是两件事。可按首次使用教程逐步检查。
订阅已经更新，为什么规则没有跟着变化？
Subscribe 与 Config 维护的内容不同。先确认服务器分组是否更新，再检查当前选中的 Config 与 Global Routing；不要把服务器条目变化当作规则文件已替换。参见订阅更新检查。
Connectivity Test 成功，是否代表分流已正确？
测试成功反映所选测试方式下的可达性，不足以证明每个目标都按预期策略处理。还应访问实际目标，结合 DNS、规则命中与 Data 观察结果。参见DNS 设置检查。
Technical Notes
配置细节与技术笔记
以下笔记按单一任务展开：先了解字段或触发条件的含义，再回到自己的配置核对。涉及服务器参数时，以用户已有的信息为输入，不根据协议名称推断服务端设置。
Shadowrocket On Demand 按需连接规则：按 Wi-Fi、蜂窝网络与域名自动触发
介绍 On Demand 的触发条件写法：按指定 Wi-Fi SSID、蜂窝网络或访问域名自动连接与断开，以及规则优先级与常见误配。先验证手动连接，再逐项增加自动触发条件。
阅读笔记 →小火箭多个订阅怎么管理：分组、排序、删除与重复节点清理
同时添加多个已有订阅后，如何按来源分组、调整节点排序、删除失效订阅，并避免同一节点重复出现在列表里。清理前保留来源标识，区分删除单个条目与移除订阅来源。
阅读笔记 →Shadowrocket WireGuard 配置参数详解：PrivateKey、PublicKey、Address 与 MTU
说明在 Shadowrocket 中添加 WireGuard 类型节点时各字段的含义与填写来源，以及 MTU、DNS、保活间隔对连接稳定性的影响。参数应与已有配置对应，私钥不应作为排查截图的公开内容。
阅读笔记 →