Shadowrocket 导入订阅失败？从添加到更新的完整步骤
简答：先确认你拿到的是完整订阅链接，而不是单节点参数或配置文件。打开 Home→右上角“+”→Type→Subscribe，粘贴 URL 并保存，再回到订阅项手动更新；出现节点后选中节点、设置 Global Routing，再开启连接验证。
定义：Shadowrocket 订阅导入，是把一条可更新的订阅 URL 保存到客户端，再由客户端拉取并展示节点列表的过程。
先判断：你拿到的到底是哪种配置
本文是第三方使用指南，与 Shadowrocket 项目及开发者无隶属关系。Shadowrocket 是面向 iPhone、iPad 等 Apple 设备的规则代理客户端，App Store 页面列出了订阅、规则文件、DNS 与网络测试等功能；具体菜单名称可能因设备、语言和版本变化，以实际界面为准。Shadowrocket App Store 页面
导入前先区分资料类型。订阅 URL 通常用于拉取一组可更新的节点；单节点资料往往包含协议、地址、端口、密码或其他认证字段；Config 配置文件则可能包含规则和策略。三者不能随意粘贴到同一个入口，否则可能出现保存成功但没有节点的情况。Shadowrocket 使用说明：订阅导入、路由与连接排查
| 你手里的资料 | 应选择的入口 | 导入后的判断标准 |
|---|---|---|
| 完整订阅链接 | Home→“+”→Type→Subscribe | 保存后能看到订阅记录，更新后出现可选择节点 |
| 单个节点参数 | Home→“+”→对应协议类型 | 填写 Host、Port、认证等字段后出现单个节点 |
| 二维码 | Home→“+”→Scan QR Code | 扫描后先核对识别出的地址、协议和备注 |
| Config 文件或配置 URL | 配置文件相关入口 | 在 Config 中看到配置，不应把它当普通订阅节点使用 |
最快判断：如果对方给你的是一条需要定期更新、并且会返回多个节点的地址，优先选择 Subscribe；如果只有服务器地址、端口和密码，则不要粘贴到 URL 订阅字段。
Shadowrocket 导入订阅：一屏一动作
- 准备完整链接。从原始消息或管理页面复制完整订阅 URL，不要只复制其中一段；保留问号后的参数，不要加入空格、换行、引号或说明文字。
- 进入添加页面。打开 Shadowrocket，进入 Home，点击右上角“+”，在 Type 中选择 Subscribe。
- 填写 URL。把订阅链接粘贴到 URL 字段；备注或名称填写一个容易识别的名称，例如“办公订阅”，不要把密码、Token 或其他认证信息写进备注。
- 保存订阅记录。点击保存或完成，返回 Home。此时只代表订阅地址已经被保存，不代表节点已经成功拉取。
- 手动更新。点击刚刚保存的订阅记录，寻找 Update、更新或类似按钮并执行；如果界面支持在订阅项上滑动，也可以查看是否出现更新操作。完成后回到 Home，检查订阅分组下是否出现可选择的节点。
- 选择节点。先点开订阅分组，再点选一个具体节点。仅看到分组名称，不能证明节点已经导入完成。
- 设置路由模式。在 Global Routing 中选择与当前测试目的相符的模式。Config 通常依赖配置文件和规则，Proxy 更适合进行代理路径对照，Direct 用于确认当前网络直连是否正常。不同版本的显示可能不同，以设备实际菜单为准。
- 开启连接并验证。打开 Home 顶部连接开关。首次连接时，系统可能要求允许添加 VPN 配置；确认请求确实由 Shadowrocket 发起，再按系统提示完成授权。之后访问一个你平时能正常打开的地址，或使用客户端提供的连通性、延迟或日志信息进行核对。
如果保存后列表仍为空，不要连续重复点击连接开关。先回到订阅记录，确认 URL 是否完整、是否执行过更新，以及更新后是否返回了节点内容。
二维码、剪贴板和 Cloud JSON 怎么选
| 方式 | 适合场景 | 操作重点 | 容易误判的地方 |
|---|---|---|---|
| 手动粘贴 URL | 你有完整订阅链接 | 选择 Subscribe，检查首尾和参数 | 把网页说明页地址当成订阅地址 |
| 二维码 | 手机上只有二维码或分享码 | 扫描后检查识别出的字段，再保存 | 二维码可能对应单节点，不一定是订阅 |
| 剪贴板 | 链接已经复制到 iPhone 或 iPad | 粘贴前确认剪贴板内容没有多余文字 | 复制了带标题、括号或换行的整段消息 |
| Cloud JSON | 你拿到的是兼容的 JSON 配置文件 | 确认文件格式和入口匹配 | 普通订阅 URL 不是通用 JSON 配置 |
订阅链接、二维码和带 Token 的截图可能包含访问凭据。不要把完整链接发到公开群组、工单或社交平台；需要求助时，只保留域名或用打码截图，并在问题解决后考虑重新生成凭据。
导入后没有节点：按现象排查
| 现象 | 优先检查 | 判定方法 | 下一步 |
|---|---|---|---|
| 保存后完全没有订阅记录 | 是否选中了 Subscribe，是否保存成功 | 返回 Home 后看不到任何新增条目 | 重新进入“+”检查 Type 和 URL 字段 |
| 有订阅记录，但没有节点 | 是否执行手动更新、链接是否完整 | 分组存在，但展开后没有可选条目 | 检查网络、URL 参数和订阅是否仍有效 |
| 更新超时 | 当前 Wi-Fi 或蜂窝网络、链接可达性 | 反复更新都在超时，其他网页是否正常 | 先换当前网络测试，再核对订阅来源和完整 URL |
| 出现 401 或 403 | 访问凭据、授权状态、订阅权限 | 同一链接持续返回授权错误 | 不要反复修改客户端字段，向订阅提供方核对权限或重新获取链接 |
| 出现 404 | 订阅路径是否失效或复制错误 | 服务器明确返回页面不存在 | 检查域名、路径和参数是否被截断 |
| 节点存在但无法连接 | 节点选择、Global Routing、VPN 权限 | 节点可见但连接开关失败或访问测试失败 | 换一个节点，并分别用 Direct 与当前模式做对照 |
错误代码只能说明请求结果，不能单独证明是客户端故障。排查时一次只改一个变量：先确认订阅更新，再确认节点选择，最后检查路由模式和系统 VPN 授权。这样才能判断问题来自订阅内容、当前网络还是具体节点。
节点出现后，怎样完成最小连接验证
- 确认节点已选中。订阅分组和具体节点是两个层级；展开分组后，需要点选一个具体节点。
- 先不要改太多设置。首次验证时暂时不要同时修改 DNS、规则、按需连接和传输参数，否则出现变化后难以判断原因。
- 确认 Global Routing。如果选择 Config，要确认当前配置文件存在且处于启用状态；如果只是测试节点是否能建立连接，可先记录当前模式，再进行对照。
- 打开连接开关。首次授权时按系统提示允许添加 VPN 配置，并完成设备认证。
- 记录结果。记录使用的网络、节点名称、路由模式和测试时间。能看到 VPN 图标只说明系统隧道已经建立，不等于所有目标地址都能访问。
- 做单变量对照。同一网络下换一个节点；或同一节点下切换 Direct 与代理模式。若 Direct 也失败，优先检查当前网络；若 Direct 正常而代理模式失败，再检查节点、订阅和路由配置。
App Store 页面确认 Shadowrocket 具备网络请求记录、网络速度测量、规则路由和多种 DNS 相关能力，但这些功能的菜单位置和可用项可能随版本变化。不要把单次延迟或一次访问结果写成长期稳定性结论。Shadowrocket iPad App Store 页面
安全提醒与版本差异
订阅 URL 往往等同于访问凭据。不要公开完整链接、二维码、密码、Token 或包含这些信息的日志截图；如果已经泄露，应尽快向订阅提供方确认是否可以撤销或重新生成。
本文按 2026-10-24 可检索到的公开资料和常见界面路径整理。Shadowrocket 的按钮名称、字段顺序和更新入口可能因 iOS、iPadOS、语言设置及客户端版本变化，找不到完全相同的文字时，应优先寻找 Home、Add Server、Type、Subscribe、Update、Global Routing 等同义入口，而不是随意关闭证书校验或修改协议参数。
边界云加速可作为需要进一步核对线路、延迟、丢包或跨境办公连接问题时的服务选项，具体服务内容以边界云加速官网为准。
常见问题
Shadowrocket 保存订阅后为什么没有节点？
保存订阅通常只是在客户端记录 URL，不一定已经完成拉取。回到 Home 打开订阅记录，执行 Update 或更新操作；如果仍为空，再检查 URL 是否完整、网络是否正常，以及订阅是否仍在有效期内。
订阅链接应该放在 Host 还是 Subscribe？
能返回一组可更新节点的完整订阅链接，应放在 Add Server→Type→Subscribe 的 URL 字段。Host 通常用于单个节点的服务器地址，不能把两类资料混用。
二维码导入后没有节点，应该怎么办？
二维码可能对应单个节点，也可能对应订阅。扫描后先检查识别出的 Type、地址和备注；如果是单节点，就按单节点测试，如果是订阅，再确认是否需要回到订阅记录执行更新。
出现 401、403 或 404 是 Shadowrocket 坏了吗？
不能仅凭错误码判断客户端故障。401 或 403 更应先核对授权、凭据和订阅权限；404 应检查域名、路径和参数是否失效或被截断。先用其他网络复测，再向订阅提供方确认链接状态。
节点已经出现但仍然连接不上，先改什么？
先确认具体节点已经选中，再检查 Global Routing 和系统 VPN 授权。随后只换一个节点或只切换一次 Direct 做对照；不要同时修改 DNS、规则和协议参数。
公开订阅链接会有什么风险？
订阅链接可能包含 Token 或其他访问凭据。公开后他人可能使用或转发该链接，因此不要发布完整 URL、二维码或原始截图；已经泄露时应向提供方询问撤销或重新生成方式。
参考资料
- Shadowrocket App Store 页面
- Shadowrocket iPad App Store 页面
- Shadowrocket 使用说明：订阅导入、路由与连接排查（shadow-help.com）