刚装好 Shadowrocket，最容易卡住的通常不是连接开关，而是订阅入口、链接格式和更新位置。添加前请确认你已经拥有自己的订阅网址，并且可以正常访问该地址；订阅链接通常包含访问凭据，不要发到公开群组、截图或求助帖中。本文以 iPhone 上的 Shadowrocket 界面为例，说明首次导入、手动更新和常见故障检查方法，具体菜单名称以设备当前显示为准。
从 Home（首页）右上角的“+”进入添加流程，将 Type（类型）设为 Subscribe（订阅），再粘贴自己的订阅网址并保存。导入后检查订阅分组和节点列表，手动更新时确认更新的是正确分组。若订阅不显示、节点为空或更新失败，按链接、网络、访问方式和列表状态逐项排查，不要重复粘贴或公开订阅凭据。
一、添加前先确认订阅链接和应用状态
Shadowrocket 本身是 Apple 平台上的付费商业应用，获取入口为 App Store。首次安装或需要核对应用信息时，可先查看正版获取说明；系统要求以 App Store 页面标注为准。客户端买断 ≠ 线路套餐，购买应用不会自动提供订阅或连接内容。本文只说明如何导入用户已有的订阅，不提供订阅网址或节点。
先确认复制的是完整订阅网址，而不是服务说明页、账户登录页或单个节点分享地址。订阅网址可能很长，也可能包含问号、等号或其他特殊字符；复制时应使用原始内容，不要手动删改、截断或在末尾增加空格。若订阅来自你已有的服务资料，发现链接不确定或已经失效，应通过原有的资料渠道核实，不要把完整链接贴给他人代为检查。
开始前也建议确认设备当前网络可以访问订阅网址。首次导入时先使用当前可用的 Wi-Fi 或蜂窝网络，不要同时更换网络、修改 DNS、切换路由设置并重复添加。若这些因素一起变化，即使结果不同，也很难判断问题来自哪里。
- 订阅网址：应是你已有资料中用于订阅导入的完整地址，不是单个节点的分享内容。
- 剪贴板内容：粘贴后检查开头和末尾，确认没有漏复制或夹带换行、空格。
- 当前网络：先确认设备能正常联网；能打开普通网页不一定代表订阅网址所在服务也可访问。
- 应用状态：若刚安装，先完成首次打开和必要的系统授权流程；订阅导入与 VPN 配置授权是不同步骤。
二、在 Home 添加订阅网址
以下步骤以 Shadowrocket 的 Home 页面为起点。不同版本或系统语言下，按钮位置与字段名称可能略有差异；按页面上的英文界面词核对即可。操作时只使用自己的订阅网址，不要将链接转发给他人，也不要把订阅地址当成普通网页链接公开保存。
-
打开首页
启动 Shadowrocket，进入
Home（首页）。如果首页已经有其他连接或订阅，先记下现有条目，避免误删或覆盖。 -
进入添加
点击 Home 右上角的“+”，进入添加项目页面。若当前页面显示的是手动添加服务器字段，先找到
Type（类型）选项，不要把订阅网址填进单个服务器的地址字段。 -
选择订阅
在
Type中选择Subscribe（订阅）。页面进入订阅信息表单后，核对字段名称，再将自己的完整订阅网址粘贴到 URL 或对应的地址输入框。 -
填写并保存
如页面提供备注或名称字段，可填写便于自己辨认的名称；不要把访问凭据写入公开可见的备注。检查网址未被截断后，点击页面上的保存或完成按钮返回 Home。
-
确认导入
返回 Home，查找刚添加的订阅分组。必要时按页面提示更新该分组，等待列表处理完成，再确认订阅下是否出现可选择的连接条目。
订阅导入成功不等于 VPN 已连接，也不代表每个节点都能使用。它表示应用已保存订阅入口，并在成功获取内容后显示相应条目。接下来应先查看 Home 中的分组和列表；只有在你准备测试已有连接时，才选择条目并按需要开启连接。不要把“订阅存在”“节点已显示”和“网络访问正常”当成同一个状态。
保存自己的订阅网址，由应用按订阅内容获取或更新多个连接条目。
适合：已有订阅网址、需要查看订阅中的多个条目
按已有资料逐项填写某个连接所需的服务器和协议参数，不是订阅导入。
适合：手上只有单个连接的完整参数
三、手动更新并确认列表变化
订阅添加后，手动更新可以让 Shadowrocket 重新获取订阅内容。更新入口会随界面版本和条目状态有所不同：在 Home 找到对应订阅分组，使用该条目提供的更新操作；有些界面也可在 Home 下拉刷新。操作后等待请求结束，再确认列表是否刷新。若列表没有明显变化，不要立即重复添加同一网址，因为更新后内容不变也可能是正常结果。
更新前先核对正在操作的分组名称。若 Home 中有多个自己添加的订阅，刷新错分组会造成“更新了但目标列表没变化”的误判。需要确认内容是否变化时，可以记录分组下的条目数量或名称作为更新前基线；不要将订阅地址复制到笔记中作为比较依据，也不要因名称相同就认定条目必然来自同一分组。
- 分组可见且有条目：说明当前页面至少显示了已获取的条目；若其中某个连接不可用，再单独检查该连接和当前网络。
- 分组可见但列表为空：查看是否更新已完成、订阅是否返回了可导入内容，以及订阅格式是否适用于当前导入方式。
- 分组不见或更新没反应：确认是否保存成功、是否回到正确的 Home 页面，以及设备网络是否允许访问该订阅地址。
- 更新后条目变化：订阅内容可能由提供方调整；先检查当前选中项是否仍存在，避免误把旧条目当成最新内容。
如果更新失败，先记下应用显示的报错原文和发生时间，但不要把完整订阅网址、令牌或个人账户信息一并截图分享。随后只改一个条件再试，例如确认网络后重新更新；如果同一网络无法访问订阅地址，可在你已有且允许使用的网络环境中确认其可达性。不要为了排错同时改多个设置，否则难以定位原因。
结论：先确认“更新对象”，再判断更新是否成功
Home 中有多个分组时，手动刷新前先核对目标名称；刷新后再看该组的状态和列表。重复添加同一网址不会替代更新，也会让后续排查更难。
四、订阅不显示、节点为空或更新失败怎么办
排查时先区分三种现象：订阅条目没有保存、订阅分组存在但没有节点、更新操作出现错误。它们对应的检查方向不同。建议保持现有配置不动，按下表从最容易确认的项目开始，不要直接删除所有条目或重装应用。
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 保存后找不到订阅 | 是否选择 Subscribe，保存后是否返回 Home |
重新进入添加页核对类型和保存操作；避免重复添加前先检查现有分组。 |
| 订阅分组存在但节点为空 | 是否执行过更新、更新是否完成、订阅返回内容是否为空 | 确认网址完整且当前可访问，再检查已有资料中该订阅的有效状态。 |
| 更新失败或超时 | 设备网络、订阅网址是否仍有效、当前是否能访问目标服务 | 切换到自己可用的网络后单独重试；若持续失败，向原有服务资料提供方核实链接状态。 |
| 有节点但连接后无访问 | 所选条目、连接状态、Global Routing 与当前网络 |
将订阅更新问题与连接问题分开处理，先确认列表，再检查路由和连接参数。 |
如果看到类似 Failed to load subscription 的提示，通常表示本次订阅获取没有完成，但仅凭这句文字不能断定是网址错误。网络中断、链接过期、访问权限变化或目标服务暂时不可用，都可能导致失败。先确认网址来自你自己的有效资料，再检查设备网络；不要把订阅地址发给陌生人代测。
如果 Home 能显示订阅分组，但节点列表为空，重点检查是否已经执行更新，以及更新后是否有可导入内容。也要确认自己粘贴的是订阅链接，而不是登录页面地址或单个连接分享内容。如果页面提示链接格式或内容有误，回到原有资料核对完整地址及订阅状态；不要自行在链接中增删参数。
若节点已经显示但连接或访问仍失败，订阅导入本身可能已完成。此时应检查 Home 中实际选中的条目、连接开关和 Global Routing（全局路由）模式，并确认当前启用的配置。不要通过反复更新订阅来处理连接建立后的规则或网络问题；订阅更新、连接建立和流量分流属于不同环节。
五、常见问题
订阅链接可以直接粘贴到单个节点的地址栏吗？
不建议。先从 Home 右上角“+”进入添加页，将 Type 设为 Subscribe，再粘贴订阅网址。单个连接的添加方式用于填写一条连接的参数，不等同于订阅导入。
添加订阅后，为什么 Home 里没有立刻出现节点？
保存订阅入口与获取订阅内容不是同一状态。先在 Home 找到对应分组并执行更新，等待操作结束，再查看列表。如果仍为空，核对网址完整性、当前网络可达性和原有订阅资料状态。
每次都要重新添加订阅网址吗？
通常不需要。订阅已保存后，应对现有分组执行手动更新；只有确认条目确实未保存或已被移除，才重新添加。重复添加可能形成多个相似分组，增加选错更新对象的概率。
订阅显示成功，是否代表现在已经连接？
不是。订阅显示表示应用获得或保存了订阅内容，不代表已选中连接、VPN 隧道已建立或流量规则正确。需要使用时，再分别核对 Home 的选择与连接状态、Global Routing 和实际访问结果。
完成导入后，建议保留一个清晰的 Home 列表，并记住对应订阅分组的名称与手动更新入口。遇到异常时，先判断是订阅未保存、列表未获取，还是连接后的网络访问问题，再按对应步骤检查。这样既能减少重复操作，也能避免在排错过程中泄露订阅凭据。