iPhone
在 iPhone 的 App Store 打开产品页，核对购买所用的 Apple ID 与设备兼容性。安装后先导入已有配置，再按系统提示允许添加 VPN 配置；完成授权并不等于连接已经验证成功。
查看 iPhone 获取说明 →
官方手册 · App Store 正版
Shadowrocket使用说明与规则配置
面向 iPhone / iPad 的规则代理客户端，支持规则分流与多协议连接；应用在 App Store 一次性买断，连接前需准备用户已有的订阅或服务器信息。
- Shadowsocks
- Trojan
- Hysteria2
- Global Routing
APP STORE / APPLE DEVICES
设备与 App Store 获取入口
先在商店核对官方图标、开发者与应用 ID，再确认设备兼容性及购买状态。Shadowrocket 的唯一获取入口是 App Store，系统要求以 App Store 页面标注为准。
在 App Store下载 ShadowrocketiPad
在 iPad 上使用购买时的 Apple ID 查看已购项目，再进入产品页确认可用状态。iPhone 与 iPad 的通用购买适用情况以 App Store 页面标注为准；服务器、订阅与配置仍需在设备上核对。
查看 iPad 获取说明 →Mac / Apple TV 也可在同一 App Store 获取，兼容性、系统要求及通用购买适用情况以 App Store 页面标注为准。
CAPABILITY INDEX
从 Global Routing 到连接诊断
先区分服务器参数、配置文件与全局姿态，再调整具体功能。左侧目录说明操作位置，右侧列出需要核对的真实关键字与设置项；语法片段用于阅读，不是可直接套用的完整配置。
在 Home 打开 Global Routing，选择 Config 后，请求按照当前配置的规则匹配；选择 Proxy 时使用代理姿态，选择 Direct 时使用直连姿态。需要按域名或地址分流时，先在 Config 核对正在使用的配置，再检查 Rule 的先后顺序与策略名称。规则通常从上向下匹配，过宽的条件可能提前命中，导致后面的精确条件没有机会生效。先用一个已知域名验证结果，再逐条增加规则，比同时修改多个条件更便于定位问题。
- DOMAIN-SUFFIX
- GEOIP
- FINAL
在 Settings 查看 On Demand，先确认已有服务器能够手动连接，再设置需要触发连接的条件。On Demand 控制的是符合条件时如何建立连接，不代替 Global Routing 对请求去向的判断。修改后应分别检查当前网络、切换网络以及手动断开后的表现；如果连接在断开后再次建立，先检查是否仍有条件命中。排查时可以暂时停用 On Demand，恢复为手动连接，待基础连接与规则都验证通过后，再逐项启用所需条件。
- On Demand
- Settings
- Global Routing
在 Add Server 先选择 Type，再依据用户已有的服务器资料填写地址、端口与认证字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard 和 Hysteria2 的参数结构不同，不能仅替换类型后保留其余内容。涉及 TLS 时还要核对服务端要求的名称与证书设置，不能把关闭校验当作通用修复方式。保存前逐项对照原始资料；保存后先测试单个服务器，确认连接成立，再接入订阅管理或规则分流，避免把协议错误误判成规则问题。
- Shadowsocks
- Trojan / WireGuard
- Hysteria2
导入前先确认手中内容是服务器订阅、单个服务器分享链接，还是配置文件地址，再使用对应的 Subscribe 或导入入口。用户已有的订阅通常包含一组服务器信息，更新后内容可能随来源变化；配置文件则还可能包含规则与解析设置，两者不能只按链接外观区分。更新前记录当前可用服务器与手动修改项，更新后检查分组、所选服务器和连接结果。订阅地址可能包含访问凭据，排查截图和日志中应先遮去完整链接及敏感参数。
- Subscribe
- Add Server
- Scan QR Code
在 Config 先确认当前选用的配置，再查看 General、Rule 与 Hosts 等分段。编辑规则前保留可恢复的副本，修改后确认文件已保存并被选中；仅把文件加入列表，并不表示正在使用它。需要跨设备维护时，可按应用提供的 iCloud 同步选项检查同步范围与状态，但仍应在另一台设备重新核对配置选择和服务器参数。同步不能替代备份，也不能假设所有敏感字段都会以相同方式迁移；排查前先保留一份已验证可用的配置更稳妥。
- General / Rule
- Hosts
- iCloud
连接异常时先在 Home 检查开关与所选服务器，再运行 Connectivity Test，并结合 Settings 中的 Diagnostics 查看线索。Data 的流量记录用于观察请求活动，不应单独当作目标网站可访问的证明；测试成功也不代表所有域名、协议与规则路径都已验证。按基础网络、服务器参数、Global Routing、DNS 与规则命中的顺序逐项检查，每次只改变一个变量。提交问题前记录触发步骤与错误文本，并遮去订阅地址、密码和密钥，保留必要的时间与操作上下文。
- Connectivity Test
- Data
- Diagnostics
条件、顺序与策略
这条规则把匹配 example.com 及其子域名的请求交给 PROXY。后者是策略引用，需要与当前配置中存在的名称一致；它不是服务器地址，也不能单靠这一行建立连接。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY示例用于说明语法结构。GEOIP 涉及地址归属判断，FINAL 处理前面未命中的请求；实际去向还需结合解析结果、规则顺序与所选策略检查。
阅读 Global Routing 与规则说明 →先手动验证，再启用条件
从 Settings 的 On Demand 开始检查。先保持手动连接，确认服务器与配置可用，再启用条件并观察系统建立连接的时机。条件匹配与规则分流属于不同层次，应分开验证。
Settings
On Demand
Home
Global Routing
Connectivity Test出现重复连接时，记录当时的网络环境与开关操作，不要同时更换配置和服务器。先缩小触发条件的范围，再判断是否需要调整规则。
查看设置与日常维护章节 →Type 决定参数结构
Type 选择后再核对对应字段。相同地址与端口不代表协议兼容；密码、密钥、传输设置和 TLS 条件都需要与服务器资料一致，不能用协议名称推测缺失参数。
- Shadowsocks / VMess / VLESS
- Trojan / HTTP / SOCKS5
- WireGuard / Hysteria2
手动填写适合逐项核对，二维码与分享链接适合减少录入。无论采用哪种方式，导入后都要检查 Type 和关键字段，再运行连接测试。
查看协议术语 →先识别内容，再选择入口
订阅导入后应检查条目是否完整、原先选择是否仍然存在，以及参数是否随更新变化。不要把“列表出现服务器”当作验证完成；仍需选择一个条目并测试实际请求。
Subscribe
Add Server
Scan QR Code
Import from Cloud JSON上述入口处理的内容形式不同。遇到识别失败时，先确认来源给出的格式和所用入口，再检查复制过程中是否夹带空格或换行，不要公开粘贴含凭据的完整地址。
按教程导入已有订阅 →保存、选中与恢复
配置编辑后需要确认保存结果和当前选择。General 用于整体参数，Rule 用于请求匹配，Hosts 用于指定名称解析；不同分段的内容不能随意交换位置。
[General]
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[Hosts]这是分段阅读示例，不是完整连接配置。更改前保留副本，跨设备同步后再核对文件内容；若结果与预期不同，先恢复已知可用状态，再逐项比较改动。
阅读配置管理章节 →测试结果与实际请求分开看
先确认设备基础网络正常，再核对服务器认证与连接测试。若测试通过而目标请求失败，继续检查 Global Routing、DNS 与规则，不要直接认定是同一种故障。
Home → Connectivity Test
Data
Settings → DiagnosticsData 有流量只说明存在请求活动。比较不同目标和不同网络时，应保留相同的配置与服务器选择，记录错误文本；一次只改一个变量，才能把结果对应到具体变化。
阅读连接故障排查 →FIRST CONNECTION
首次连接的三个步骤
以下顺序以用户已经持有自己的订阅或服务器信息为前提。把“导入完成”“系统授权”和“请求验证”分开处理，可以避免在尚未具备连接条件时反复调整规则。
-
添加服务器或导入已有订阅
打开 Home，按资料类型使用 Add Server、扫码或相应订阅入口。手填时先选 Type，再逐项填写参数；导入时先核对来源与内容格式，完成后检查服务器列表和实际选择。不要把配置文件地址直接当作服务器地址填写，也不要把订阅中的认证参数发布到公开页面。若导入失败，回到原始资料核对格式，比反复修改端口更有针对性。
-
选择 Global Routing 姿态
需要按配置分流时选择 Config，并确认 Config 中已选中所需文件。Proxy 与 Direct 可用于理解不同请求路径，但不能代替检查配置本身；切换姿态会改变流量去向，测试结束后应恢复日常使用的选择。第一次验证建议保留简单、可读的规则，先理解命中条件，再逐步增加例外，避免多个规则同时变化后难以判断原因。
-
打开连接开关并验证请求
打开 Home 的连接开关，首次添加 VPN 配置时阅读并确认系统授权提示。随后运行 Connectivity Test，再访问一个明确的测试目标，并结合 Data 或诊断信息观察结果。若出现异常，先记录错误文本，按基础网络、参数、姿态和规则的顺序排查。系统显示已连接只代表连接状态，不能据此推断所有目标或每条规则都已经正常工作。
PRODUCT VERIFICATION
正版核对、买断与购买恢复
Shadowrocket 是闭源商业应用。本站是 Shadowrocket苹果版官网与官方手册，购买与兼容性事实以 App Store 产品页为准，操作说明以应用中的实际界面词为依据。
- 开发者Shadow Launch Technology Limited
- 应用 ID932747118
- App Store 独占发售
在产品页核对三个位置
打开 App Store 产品页，先对照本站所用的官方图标，再查看开发者是否为 Shadow Launch Technology Limited，最后确认产品链接中的应用 ID 为 932747118。同名或近似名称不能替代这些核对步骤；只凭搜索结果的标题判断，容易忽略开发者和具体产品的差异。三项核对后，再阅读价格、兼容性与购买按钮状态。
商店是否显示某个产品，与当前 Apple ID 的店面和商店可用状态有关。如果搜索结果与预期不同，应先检查当前店面与产品页，而不是把搜索缺失当作设备故障。系统要求、设备兼容性及通用购买适用情况均以 App Store 页面标注为准，本站不以固定系统数字代替商店说明。
区分应用购买与连接资料
客户端买断 ≠ 线路套餐。美区定价约 2.99 美元，一次性付费，各店面按当地货币显示，实际金额以购买确认页为准。付款取得的是应用的使用资格；服务器地址、认证参数与订阅内容需要来自用户自己已有的服务。本站不提供、不销售、不推荐节点或订阅，也不替用户选择服务来源。
买断并不意味着任意服务器都能连接，也不表示应用会自动生成有效配置。第一次打开时，应先准备完整资料，再按教程导入。遇到连接失败时，分别检查应用购买状态与服务器可用状态：前者影响能否获取应用，后者影响能否建立预期连接，两类问题的处理位置不同。
在已购项目中恢复应用
换机或重新安装时，在 App Store 使用购买时的 Apple ID 查看已购项目，再进入 Shadowrocket 产品页确认获取状态。iPhone 与 iPad 共用购买的适用情况以 App Store 页面标注为准；如果页面仍显示购买金额，先检查账户、店面与购买记录，不要仅根据设备上曾经出现过应用图标判断已经完成购买。
应用恢复和配置恢复是两件事。重新获取应用后，还需要核对原有服务器资料、配置文件和同步状态；不要假设购买记录会一并恢复全部连接内容。涉及 iCloud 同步时，按实际启用的同步范围检查，首次连接前再次确认选中的配置与服务器，必要时从自己保留的副本恢复。
通过 App Store 管理更新
在 App Store 的应用更新入口查看 Shadowrocket，按设备上的自动更新设置或手动更新操作维护应用。阅读产品页提供的说明后，再核对更新后的关键设置。页面不列具体版本号和更新日期；排查时应以设备当前安装情况与商店可见信息为准，避免用过期记录判断功能是否存在。
日常维护建议分开进行：先保留可恢复的配置，再处理应用更新，最后检查已有订阅的内容变化。应用更新、订阅更新和规则编辑并不是同一次操作；若同时进行，异常出现时很难判断来自哪里。每次完成一项改动后测试一个已知目标，并记录结果，能够为后续诊断保留清楚的比较依据。
常见问题精选
先用下面的区别判断问题所在，再进入相应教程或术语条目。
订阅已经导入，为什么还需要检查 Config？
服务器订阅主要提供连接条目，配置文件还可能定义请求规则。导入服务器不等于已经选中正确配置，使用 Config 姿态时仍要检查当前文件与策略引用。可先阅读订阅与配置术语。
Connectivity Test 成功，是否代表所有请求都正常？
测试只反映相应测试路径的结果。实际目标还可能受域名解析、规则命中与协议差异影响，应结合 Data 和 Diagnostics 继续验证。参见连接诊断说明。
Global Routing 与 On Demand 分别控制什么？
Global Routing 控制请求采用的路由姿态，On Demand 控制符合条件时如何触发连接。应先手动验证连接，再设置自动触发条件，避免把建立连接与选择路径混为一谈。参见界面与开关术语。
重新获取应用后，原来的服务器会自动回来吗？
购买恢复不等于配置恢复。需要根据原先的备份与 iCloud 同步范围检查，不能假设所有内容都会迁移；恢复后仍应核对认证字段并测试连接。参见已购恢复说明。
TECHNICAL NOTES
协议、DNS 与参数技术笔记
完成首次连接后，再按问题阅读专题。先辨认协议和参数用途，再决定是否调整；技术笔记只解释用户已有资料的填写与验证方式，不替代来源提供的完整配置。
Shadowrocket DNS 设置怎么选：系统 DNS、自定义 DNS 与 DNS over HTTPS
从域名解析异常开始，比较三种 DNS 取向，解释解析结果如何影响规则判断，并按顺序检查解析、连接与目标请求，避免一出现访问失败就更换服务器。
小火箭支持哪些协议：Shadowsocks、VMess、VLESS、Trojan 到 Hysteria2
按传输与认证特点辨认协议，说明在 Add Server 中为何要先选 Type。对照用户已有的服务器资料选择类型，而不是把更换协议名称当作连接修复操作。
Shadowrocket WireGuard 配置详解：私钥、Peer 公钥、Allowed IPs 与 MTU
逐项说明 Private Key、Public Key、Pre-shared Key、Allowed IPs 与 MTU 的作用，区分本地密钥与 Peer 信息，并解释参数不一致时应从哪些位置核对。