第一次使用 Shadowrocket（常称“小火箭”），容易把“添加订阅”“更新节点”和“连接 VPN”当成同一步。实际上，订阅地址负责让客户端取得配置，更新后出现的线路还要经过选择和连接，最后由 iOS 授权建立 VPN 通道。按这个顺序操作，能更快判断问题出在链接、配置、权限还是网络。
先确认订阅链接与客户端兼容
开始前，先确认 iPhone 已安装从官方渠道获取的 Shadowrocket，并能正常打开。应用是否可在你的 App Store 地区获取、界面文字和菜单位置，可能随地区及版本变化；如果尚未安装，应先核对应用名称和开发者信息，不要从陌生网页下载描述文件或所谓“破解版”。
订阅服务和 Shadowrocket 是不同部分：服务提供线路配置，客户端负责读取配置并发起连接。并非所有服务都支持 Shadowrocket，也不是所有订阅地址都能被它识别。先查看服务面板或客户端说明，确认是否明确提供适用于 Shadowrocket 的订阅链接或导入方式；如果只支持其他客户端格式，应按服务说明选用兼容客户端，不要将不兼容的链接反复粘贴尝试。
获取链接时，登录服务面板，进入订阅或客户端配置区域，复制对应的订阅地址。普通的官网首页、登录页面或客户端下载页面通常不是订阅链接。也不要将订阅地址误当作单条节点地址：订阅一般用于获取或维护一组配置，单条节点则只对应一个连接配置。具体名称和入口以服务面板实际显示为准。
在小火箭中添加订阅
添加方式会因 Shadowrocket 版本和服务提供的格式不同而有差异。以下流程适用于服务明确说明可用订阅链接导入的情况；如果你的页面按钮、菜单名称不同，优先对照当前客户端界面和服务提供的操作说明，不要猜测字段含义。
- 复制订阅链接。从服务面板复制完整地址，注意避免多复制空格、换行或标点。若面板提供二维码，可用客户端支持的扫码入口导入；不要把二维码截图上传到公开平台。
- 打开订阅入口。在 Shadowrocket 中查找添加配置、从 URL 导入或订阅相关入口。选择与订阅链接相符的导入方式，而不是手动创建单条节点。
- 粘贴并保存。将链接放入对应地址栏，按客户端提示填写可选名称或备注。名称只用于区分配置，不会改变线路参数。确认保存后返回配置或节点列表。
- 执行更新。如果保存后列表没有显示线路，使用客户端提供的更新或刷新功能。观察是否出现成功提示、配置名称或可选节点；列表为空、提示格式错误和网络超时对应的原因并不相同。
- 选择一条线路。从已导入的配置中选取目标线路。初次验证时保持客户端的其他选项不变，避免同时切换规则、代理模式和线路，导致无法判断是哪项设置影响连接。
订阅添加成功，只代表客户端保存了一个配置来源，不代表其中的线路已经更新或连通。线路名称也不是速度保证；实际表现会受当前网络、线路状态、目标服务和客户端配置影响。若列表中出现无法识别的协议或错误，不要随意修改加密、传输等字段，应先确认服务是否支持 Shadowrocket 及其当前订阅格式。
如果还需要核对 iPhone 上的基础客户端准备流程，可参阅本站快速上手。需要下载或了解服务入口时，也可以从免费VPN下载开始查找，再按面板提示获取适配的配置；营销首页本身不等同于订阅地址。
更新配置并选择线路
配置列表中可能同时存在订阅项目和具体线路。订阅项目是后续刷新配置的来源，具体线路才是连接时选用的对象。更新订阅通常会重新读取服务端提供的配置，因此更新后线路名称、可用选项或分组可能变化。若你曾经手动添加过配置，不要在没确认用途前删除它们。
点击订阅更新后，先看客户端是否显示完成或错误信息，再确认节点列表是否加载。若更新成功但某个节点连接失败，可以在不改动订阅本身的前提下改选另一条已提供线路进行对照；如果所有节点都没有出现，优先检查订阅地址、网络访问和格式兼容，而不是不断点击连接按钮。
小火箭中的全局路由、配置规则或类似选项，决定哪些请求经过代理、哪些请求直连，具体名称随版本而异。首次使用时先保留服务说明建议的默认方式，确认基本连接后再调整。若开启全局代理后，局域网设备、公司内网或本地服务无法访问，可恢复原设置，再检查规则和排除选项。不要把“选中了线路”误认为所有 iPhone 流量必然都通过它。
| 当前现象 | 优先检查 | 建议处理 |
|---|---|---|
| 订阅已保存但没有线路 | 是否执行更新、地址是否完整、格式是否受支持 | 核对服务说明后重新更新，查看具体错误提示 |
| 线路出现但无法连接 | 所选配置、当前网络、客户端连接记录 | 保持其他设置不变，改选服务提供的另一条线路对照 |
| 显示已连接但应用无法访问 | 路由模式、规则、DNS 与目标应用的网络请求 | 先用浏览器验证，再检查规则和应用自身的网络状态 |
| 更新提示超时或失败 | 网络是否可用、链接是否过期或复制不完整 | 切换当前网络后重试，必要时在服务面板重新复制地址 |
允许 iOS 建立 VPN 连接
第一次启动连接时，iOS 通常会显示系统级 VPN 添加或连接授权提示。核对请求来自 Shadowrocket 后，按系统提示允许；这一步是 iPhone 建立 VPN 配置所需的系统授权，不是订阅更新，也不代表订阅内容自动正确。若此前已授权，之后连接时可能不会重复出现相同提示。
授权完成后，观察客户端中的连接状态，并查看 iOS 设置里的 VPN 状态或状态栏提示（显示方式可能随系统版本和设备设置变化）。客户端显示连接中而系统状态没有建立，可能仍在等待授权、网络响应或配置处理；系统显示已连接，也不能单独证明目标应用的流量符合预期，仍应进行实际访问验证。
如果系统提示已有 VPN 配置、无法添加或连接被其他工具占用，检查是否同时运行了另一款 VPN 或代理客户端。先在另一款工具中断开连接，再回到 Shadowrocket 尝试；也可在 iOS 设置中查看 VPN 配置列表。不要随意删除不认识的企业或学校管理配置，涉及受管理设备时应先联系管理员。
- ✅ 系统授权提示出现时，确认发起应用是当前正在设置的客户端。
- ✅ 连接后对照客户端状态与 iOS 显示的 VPN 状态，不只凭单个图标判断。
- ✅ 更换 Wi-Fi 或移动数据后，重新检查连接是否恢复以及目标应用是否能访问。
- ❌ 不要同时开启多个 VPN 客户端，再据此判断订阅或线路故障。
验证连接与分流是否符合预期
连接建立后，先用 Safari 打开一个平时可访问的网页，再测试你实际要使用的应用。浏览器能打开网页只能证明某些请求可用，不代表所有 App、域名或传输方式都走相同路径。若服务支持查看连接记录，可在客户端中观察目标请求是否出现，并核对它匹配的规则与所选出口。
当网页能访问、某个 App 不能访问时，先确认该 App 是否被规则设为直连或排除代理，再检查应用自身是否有网络错误。若全部应用都无法访问，先断开并重新连接，检查当前网络是否可用、配置是否仍有效；不要立刻删除订阅或重置 iPhone 网络设置。若只有特定线路异常，可按服务说明更新配置，并用其他已提供线路做对照。
切换 Wi-Fi 与移动数据时，网络地址和路由环境会改变，连接可能需要重新建立。遇到切网后暂时无法访问，等待客户端完成重连，必要时手动断开再连接；如果系统显示已断开，重新检查授权和当前选中的线路。测试期间保持其他客户端关闭，避免系统路由状态相互影响。
处理常见导入问题
提示链接无效或无法解析：检查是否复制了完整的订阅地址，链接前后是否混入空格，面板中的地址是否仍有效。确认导入入口与链接类型相匹配；普通网页地址不能替代订阅地址。若仍失败，查阅服务说明或联系服务支持时，只提供错误文本和客户端版本等必要信息，不要直接发送完整订阅链接。
更新失败但网页可以打开：网页能访问不代表订阅服务器、证书或请求方式一定可用。检查当前网络是否限制了该请求、日期与时间设置是否正常，以及客户端是否提示超时或格式问题。切换网络后重试有助于区分网络环境问题，但不要通过关闭系统安全设置来绕过错误。
导入成功但没有可用线路：确认列表中添加的是订阅配置而非空白手动配置，并执行一次更新。如果服务面板为不同客户端提供不同订阅类型，应选择明确标注为 Shadowrocket 或该客户端支持的格式。不要把其他客户端的配置文件强行当成小火箭订阅。
可以连接但访问异常：分别检查客户端规则模式、目标应用的代理行为和 DNS 设置。先恢复到服务建议的默认配置，再逐项调整。某些应用可能使用自身网络策略，浏览器的访问结果无法替代对该应用的检查。如果调整后问题仍在，记录连接状态、错误信息以及发生问题的网络环境，向服务支持咨询。
完成设置后，保留能正常更新的订阅来源，避免反复添加同一配置造成列表重复。今后更换设备、分享屏幕或提交故障截图时，务必遮挡订阅链接、账号标识及其他访问凭据。配置、系统授权和线路状态分别检查，通常比连续更换所有选项更容易定位故障。