iPhone
首次打开后，先导入自己的连接信息，再按系统提示添加 VPN 配置。该授权用于建立本机网络连接，并不代表服务器参数已经通过验证。
前往说明 →官方手册 · App Store 正版
Shadowrocket 使用说明订阅导入与规则设置
面向 iPhone / iPad 客户端，从核对 一次性买断开始，依次完成已有订阅导入、连接验证与规则分流设置。
- Subscribe 订阅
- VLESS
- WireGuard
获取与首次打开
先核对 App Store，再设置连接
Shadowrocket 是付费应用，一次性买断，只在 App Store 发售。购买前先核对开发者、官方图标与应用 ID；系统要求和设备兼容性以 App Store 页面标注为准。
已有订阅或服务器信息的用户，可以在安装后继续阅读导入步骤。客户端买断 ≠ 线路套餐；本站不提供任何节点或订阅，订阅链接从你的服务商处获取。
设置项与使用顺序
Shadowrocket 核心功能说明
先区分服务器、订阅与配置文件，再决定流量如何处理。下面按常用入口解释用途；示例只用于阅读格式，不用于实际连接。
Subscribe 订阅导入
订阅用于集中获取和更新服务器条目，链接从你的服务商处获取。在 Add Server 添加服务器入口选择 Subscribe 订阅类型，填写完整地址后保存并更新。导入前检查链接是否被换行、是否缺少查询参数；导入后核对分组和条目，而不是只看是否出现名称。更新失败时先保留已有可用信息，确认链接状态再重试。订阅地址可能含访问凭据，排查时不要公开完整链接。
前往订阅手册 →https://example.com/sub?token=xxxx示例中的 token 是假值，不是连接凭据。
Global Routing 全局路由
Global Routing 全局路由决定连接采用哪种处理方式。Config 配置模式按当前配置中的规则分流；Proxy 代理模式将一般请求交给所选代理；Direct 直连模式用于直接访问。首次验证时，先记录当前选择，再根据排查目标切换，不要同时修改多项设置。模式变化不等于服务器参数发生变化，也不能修复错误的地址或密码。需要规则生效时，还要确认 Config 配置页中实际选中了预期文件。
查看路由设置步骤 →Config → 按当前配置分流
Proxy → 使用代理模式
Direct → 使用直连模式On Demand 按需连接
On Demand 按需连接用于按设定条件触发系统连接行为，入口位于 Settings 设置页。建议先在手动连接下确认服务器和路由可用，再逐项启用所需条件；它不能代替订阅导入，也不负责修正失效参数。排查“关闭后又连接”时，应先检查这里的条件，并观察切换网络后的实际状态。测试时临时关闭相关条件，能够减少自动连接对结果的干扰，确认原因后再恢复原来的设置。
阅读按需连接说明 →Settings
On Demand
先验证手动连接
再设置触发条件
最后测试网络切换Rule 规则匹配
Rule 规则按配置中的顺序判断请求，匹配后交给指定策略处理。DOMAIN-SUFFIX 用于域名后缀，IP-CIDR 用于地址段，FINAL 为未被前面规则处理的请求提供兜底。编辑前备份当前配置，再检查目标规则的位置与策略名称；只新增一条规则，不代表它一定会先命中。PROXY、DIRECT 与 REJECT 表达不同处理结果，测试时应结合实际请求记录判断，而不能仅根据网页外观推断匹配情况。
阅读规则匹配与限制 →[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT多协议与字段核对
Shadowrocket 可用于管理 Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等协议的连接信息。进入 Add Server 添加服务器时，先按已有信息选择 Type 类型，再核对地址、端口和认证字段。不同协议需要的字段并不相同，传输方式与 TLS 参数也要与服务端一致。分享链接导入后仍应复核解析结果；不要因为端口相同就套用另一条记录的参数，也不要仅凭协议名称判断实际连接表现。
查看手填字段说明 →Type → 与已有协议一致
Address → example.com
Port → 443
UUID → your-uuid
以上仅为字段说明，不构成可用配置。Config 配置管理
Config 配置页管理规则与其他配置内容，和 Home 首页中的服务器列表承担不同职责。服务器决定连接到哪里，配置决定请求如何处理；使用 Config 配置模式时，两者需要配合。修改前先保留原文件，编辑后确认选中的是新文件，再用同一个测试目标比较结果。涉及 iCloud 同步时，还要检查系统账户与同步状态；同步不应替代独立备份，也不应被当作订阅更新成功或另一台设备已完成连接授权的证明。
阅读配置与备份说明 →[General]
bypass-system = true
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT正版、购买与连接验证
购买客户端前后，需要分清的事实
Shadowrocket（小火箭）是闭源商业应用。本站是官网与官方手册，获取、购买和兼容性信息以 App Store 产品页为依据；具体操作以设备当前显示的界面为准。
- 开发者 Shadow Launch Technology Limited
- 应用 ID 932747118
- 一次性买断
正版核对：名称只是第一步
进入 App Store 后，先确认产品名为 Shadowrocket，再查看开发者是否为 Shadow Launch Technology Limited。对照本站页头的官方图标，并检查产品页链接中的应用 ID 是否为 932747118。三处信息应共同核对，不要只凭搜索结果中的名称、排名或相似图案作判断。浏览器打开产品页与设备商店内展示的内容可以相互参照；最终购买前，仍应在付款界面确认应用名称与金额。
官方图标用于辨认应用，不代表当前设备已经购买或安装。若商店页面展示的开发者与应用 ID 不一致，应返回核对入口，而不是继续填写支付信息。正版核对说明页把这三个位置拆开讲解，适合首次购买时逐项对照。
商店可见性与账号地区
App Store 的应用展示、货币与可购买状态会受当前账户店面影响。页面打不开、搜索不到与应用连接失败是不同问题：前两者发生在获取阶段，尚未涉及服务器配置。先检查 App Store 当前登录账户、网络状态与页面提示，再确认产品页是否可正常展示。不要将手册中的美区金额直接换算为所有地区的实际售价，也不要把网页能打开理解为设备一定符合兼容性要求。
系统要求、设备兼容以及是否通用购买，一律以 App Store 页面标注为准。购买前读兼容性栏，比安装后再判断更直接；涉及账户或付款状态时，应依据商店显示的信息处理，而不是通过修改订阅链接来尝试解决。
一次性买断与线路服务分别管理
美区定价约为 2.99 美元，一次性买断，各店面按当地货币显示，实际金额以 App Store 页面为准。买断指客户端本身的购买方式，不等于购买了一组可连接的服务器。客户端买断 ≠ 线路套餐。用户仍需已有自己的订阅或服务器信息，订阅链接从你的服务商处获取；本站不提供、不销售、不推荐节点或订阅。
因此，付款成功后首页列表为空，并不说明购买失败；列表是否出现条目，取决于后续是否完成导入。反过来，订阅里存在条目也不能证明该服务仍然有效。应用购买记录、订阅有效状态、服务器可达性分别属于不同环节，排查时应分别确认。
两种设备的购买与恢复
在 iPhone 与 iPad 之间使用时，先用购买时的 Apple ID 核对 App Store 已购记录，通用购买的适用性以 App Store 页面标注为准。换机或重新安装，应从已购项目查找对应应用，并核对开发者和应用 ID。若页面仍显示购买金额，先检查是否使用了原购买账户及相应店面，不要把重复付款当作恢复记录的第一步。
恢复应用不会自动证明订阅、配置和本机授权都已恢复。安装完成后，应重新检查 Home 首页的条目、Config 配置页的文件选择及系统连接提示。需要借助 iCloud 同步时，先确认系统相关开关和同步结果，再逐项验证，不要在多台设备上同时覆盖尚未备份的配置。
首次授权与首次连接不是同一个结果
首次开启连接时，系统可能要求允许添加 VPN 配置。这是建立本机网络连接所需的系统授权；完成授权后，还需要服务器地址、认证信息、传输方式和路由设置相互匹配。建议先使用一条已核对的记录进行测试，暂时保持其他设置不变。若授权被取消，应先处理系统提示，再继续判断连接状态，避免将本机未获授权误认为服务器故障。
回到 Home 首页后，先核对所选条目，再查看连接开关与 Global Routing 全局路由。连接状态只是判断依据之一，还应打开具体目标页面进行验证。若失败，记录当时的网络环境和错误提示，按参数、路由、解析的顺序缩小范围。
Data 流量统计与延迟测试的读法
Data 流量统计用于观察设备上由客户端记录的流量情况，不应直接当作服务商侧的结算账单。比较数据前，先看清统计口径与所选范围，并结合实际使用时间判断。Connectivity Test 连通性测试则用于辅助观察条目的响应，不等同于完整网页访问测试；不同测试方法、目标与网络环境，都可能影响读数。
出现“延迟正常但网页打不开”时，不要仅根据数字反复排序。先用同一目标复测，再检查 Global Routing 全局路由、当前配置与 DNS 解析情况。只有保持测试条件一致，前后结果才有比较意义。服务端可连接、域名可解析、目标可访问，是相关但不相同的判断。
订阅更新与配置备份分开处理
订阅更新可能改变服务器列表，配置编辑则可能改变请求的路由结果。更新前先记下当前使用的分组与条目，编辑规则前先备份配置；不要在同一次排查中同时更换订阅、服务器和规则文件。若列表突然为空，优先核对链接完整性和返回内容，不要立即清空原有数据。链接中的查询参数可能参与认证，复制时应保留完整格式。
备份内容也可能包含服务器凭据，应保存在自己可控制的位置。向他人说明故障时，可以提供协议类型、错误提示与已做过的测试，但应隐藏订阅地址、密码等敏感字段。手册中的 example.com 与示例认证值仅用于展示结构，不是实际服务。
应用更新与设置变更的顺序
应用更新通过 App Store 管理，更新记录也在对应产品页查看。需要更新时，先保留当前配置并记录可复现的问题；完成更新后，用原来的测试目标确认行为，再决定是否调整设置。不要把应用更新、订阅更新与规则文件更新视为同一件事，它们分别影响客户端、服务器列表和分流逻辑。
本手册不固定写入具体版本号或系统最低版本，避免将会变化的信息当作长期前提。遇到界面位置差异时，以设备上的英文入口名称定位，再结合当前 App Store 说明核对。操作中一次只改一项，能够让恢复原状和判断原因都更清楚。
常见问题精选
购买后 Home 首页没有服务器，需要先做什么？
先导入自己已有的订阅或服务器信息。订阅链接从你的服务商处获取；应用购买与服务器列表分别管理。保存后执行更新，再核对条目是否完整。详细顺序见订阅手册。
Global Routing 应该选 Config、Proxy 还是 Direct？
需要按规则分流时选择 Config 配置模式，并确认当前配置；验证代理路径时可按测试目标使用 Proxy 代理模式；需要直连时使用 Direct 直连模式。切换前记录原选择，完整说明见入门指南。
延迟有结果，为什么具体页面仍然打不开？
延迟测试与完整访问的目标和过程不同。应继续检查当前服务器、路由模式、规则命中及 DNS 解析，不要仅凭一次测试判断连接正常。可按常见问题中的分类逐项排查。
手动关闭连接后又自动连接，应检查哪里？
先查看 Settings 设置页中的 On Demand 按需连接条件。测试期间临时停用相关条件，观察系统连接状态，再决定恢复哪些设置。不要同时删除订阅与配置，以免丢失原始排查条件。更多说明见常见问题。
协议与故障排查
继续阅读：字段与连接问题
完成首次连接后，再按遇到的具体问题深入阅读。协议名解释设计与参数，不代表对实际网络表现的承诺；排查文章则帮助保持测试条件一致，逐步缩小故障范围。
协议科普
Hysteria2 协议是什么：基于 QUIC 的设计与适用场景
理解 Hysteria2 的传输与拥塞控制思路，区分弱网下的设计目标和实际效果，了解 UDP 受限时为何可能无法连接，以及添加记录前需要核对哪些已有参数。
协议科普VMess 和 VLESS 有什么区别：手填时需要看懂的字段
围绕 UUID、alterId、加密方式与 TLS 参数说明差别。按 Add Server 添加服务器时的核对顺序阅读，避免把一个协议的填写方法直接套在另一个协议上。
故障排查订阅更新失败或列表为空：五步自查清单
依次检查链接格式、复制完整性、服务商侧状态、更新时机与网络环境。保留已有信息后再测试，区分地址失效、响应异常与解析失败，避免盲目重复导入。