Shadowrocket iOS 订阅导入失败怎么办？
简答：Shadowrocket iOS 订阅导入失败，先不要重装或反复刷新：复制完整订阅链接到 Safari 隐私浏览中检查返回内容，再回到 Shadowrocket 用 Subscribe 类型导入。若返回登录页、HTML 错误页、401/403/404/429 或一直超时，问题通常在链接、授权、路径、频率限制或当前网络；若导入成功但节点为空，再检查格式、订阅条目和手动更新；节点出现后仍不能联网，则进入选中节点、Global Routing 与 iOS VPN 接管排查。
定义：Shadowrocket iOS 订阅导入失败，是指订阅链接无法添加、更新请求失败、更新后没有节点，或节点出现但尚未能正常建立网络连接。
先看症状：三步判断问题在哪一层
本文是 AmyClash 的第三方使用指南，不是 Shadowrocket 官方页面。Shadowrocket 在 App Store 的产品说明中确认支持从 URL 导入规则文件，并支持记录 HTTP、HTTPS 与 DNS 请求；但不同版本的菜单名称和位置可能变化，以下路径应以你当前设备显示为准。查看 App Store 产品页。
| 你看到的现象 | 优先检查 | 暂时不要做 |
|---|---|---|
| 添加时提示 URL 无效、无法解析 | 链接是否完整、是否粘入了登录页或普通网页 | 不要连续刷新或立刻重装 |
| 更新超时、401、403、404、429 | 授权、路径、频率限制与当前网络 | 不要删除原有可用配置 |
| 订阅添加成功但节点为空 | 返回格式、订阅条目、手动更新结果 | 不要同时修改规则和 DNS |
| 节点出现但无法联网 | 选中节点、Global Routing、VPN 权限与日志 | 不要把“导入成功”当成“连接成功” |
- 先复制原始订阅链接备份。订阅 URL 可能包含账户令牌，不要发到公开平台或截图中。
- 用 Safari 隐私浏览检查链接。看它是订阅正文、Base64/节点 URI、登录页、HTML 错误页，还是空内容。
- 只改一个变量后复测。先换网络或重新复制链接，再检查格式和 VPN；不要同时改 DNS、规则、节点和路由。
最短导入步骤：用 Subscribe，不要把订阅当 Host
如果你拿到的是能返回一组服务器条目的订阅 URL，通常应在 Shadowrocket 的 Home 页面进入 Add Server，再在 Type 中选择 Subscribe，把完整链接放入 URL 字段并保存。公开教程对该界面的描述可作为定位参考，但其官方属性未核实；当前版本若名称不同，应以 App 内实际英文标签为准。界面路径参考页。
- 打开 Shadowrocket，进入 Home，找到 Add Server。
- 点击 Type，选择 Subscribe；不要把普通账户网页、登录地址或单个节点分享链接当作订阅 URL。
- 完整粘贴链接，保留开头、结尾以及所有查询参数；删除聊天软件带入的空格、换行、中文引号和截断字符。
- 保存后返回 Home，确认订阅条目出现，并执行一次手动更新。
- 看到服务器条目后，先选中一个节点，再单独测试连接；不要在此时同时更换规则文件。
预期结果：Home 页面能看到订阅条目及至少一个可选服务器。这个结果只说明客户端读到了返回内容，不代表节点一定可用，也不代表 iOS 已经允许 VPN 接管流量。
在 Safari 检查订阅 URL：返回什么，下一步就不同
建议使用 Safari 私人浏览打开链接，避免已有登录状态掩盖问题。不要把完整 URL 发送给客服或公开发布；如果必须反馈，只提供域名、时间、错误提示和已脱敏的状态信息。
| Safari 中的结果 | 可能含义 | 可执行处理 |
|---|---|---|
| 显示登录页或账户中心 | 这是网页入口，不是订阅接口，或当前请求需要登录 | 回到原服务后台复制专用订阅链接，必要时联系原提供方确认 |
| 显示 HTML 错误页 | 请求返回的不是客户端可解析的订阅内容 | 记录页面提示和状态，不要把 HTML 粘入 Shadowrocket |
| 401 | 缺少或不接受有效认证凭据 | 重新复制完整链接，确认令牌未被截断或过期 |
| 403 | 服务器理解请求但拒绝提供内容 | 检查账户权限、访问条件和当前网络，不能仅靠重复刷新解决 |
| 404 | 目标资源不存在或路径不再提供 | 核对链接路径，向原提供方确认是否更换了订阅地址 |
| 429 | 短时间请求过多，触发频率限制 | 停止连续更新，等待一段时间后再用一次请求复测 |
| 一直转圈或超时 | 当前 Wi-Fi、蜂窝网络或链路无法完成请求 | 分别用 Wi-Fi 与蜂窝网络测试；两边都失败再核对链接本身 |
| 返回一段可读配置或节点 URI | 可能是可识别内容，但格式仍需客户端支持 | 确认来源说明适用于 Shadowrocket，而不是仅适用于其他客户端 |
HTTP 状态码的含义应以标准定义为准：RFC 9110 将 401 定义为缺少有效认证凭据，403 表示服务器拒绝履行请求，404 表示找不到当前资源；429 通常表示单位时间内请求过多。RFC 9110 HTTP 语义。这些状态码只能帮助定位请求阶段，不能据此断言某个服务已经停止或失效。
导入后节点为空：检查格式与订阅条目
如果订阅条目已经保存，但服务器列表为空，先区分“没有收到内容”和“收到的内容无法解析”。订阅、Config 文件和单个节点分享链接不是同一种东西：订阅通常用于拉取并更新服务器列表，Config 更偏向规则及相关配置组织；不要把一个文件的导入结果当成另一个文件的结果。
- 确认订阅条目是否正确。回到 Home 检查是否打开了刚刚保存的 Subscribe 条目，而不是旧条目或手动添加的单节点。
- 重新执行一次手动更新。更新前保留原条目，不要先删除唯一配置；记录更新前后节点数量。
- 判断返回格式。Clash YAML、sing-box JSON、Base64 编码内容和 vless://、ss://、trojan:// 等节点 URI 并不等于所有客户端都能直接互换。没有可靠格式说明时，向原提供方确认“Shadowrocket 专用订阅”或兼容格式。
- 不要直接粘贴不明配置片段。网上看到的 [General]、dns-server 或其他字段示例只能用于识别概念，不能证明当前 Shadowrocket 版本支持，也不能保证适用于你的配置文件。
- 核对订阅是否被更换。如果同一链接以前有节点、现在返回空内容或结构变化，应由原提供方确认账号、到期状态、访问条件和格式变化；本站无法据此判断具体服务状态。
如果你只看到“导入成功”，但列表仍为空，不要继续修改 DNS 或规则。先把问题固定在“订阅响应与解析”这一层，避免把多个变量混在一起。
节点已经出现但不能联网：再排查 iOS 接管
节点出现后，问题就不再是单纯的订阅导入。按以下顺序检查：
- 确认选中了具体节点。订阅条目存在不代表已经选中可用节点。
- 检查 Global Routing。先使用当前版本提供的基础模式做单变量测试，暂时不要叠加复杂规则、On Demand 或自定义 DNS。
- 确认 VPN 权限。首次连接时，iOS 可能弹出允许添加 VPN 配置的系统提示；只有在你主动从 Shadowrocket 发起连接时才确认。Apple 的 Network Extension 文档说明，网络扩展可用于代理 DNS 查询或创建数据隧道，但这类系统能力不能直接证明某个客户端当前版本的具体菜单或字段行为。Apple Network Extensions 文档。
- 观察连接状态和请求记录。如果 VPN 未连接，优先处理系统权限或客户端连接状态；如果 VPN 已连接但只有部分网站失败，再检查规则命中、DNS 和目标节点。
- 交叉测试网络。在 Wi-Fi 和蜂窝网络各测试一次，每次只更改一个条件。若只有一种网络失败，记录网络类型、时间和错误现象，便于继续定位。
回滚方法：恢复原来的节点、路由和规则；删除你刚刚新增的测试条目，而不是删除全部配置。若曾修改 DNS 或自定义规则，先恢复到修改前的值，再重新测试单个节点。
安全自查清单：避免把订阅令牌泄露出去
- 订阅 URL 可能包含令牌、账户标识或访问权限，截图时遮盖域名后的路径、查询参数和完整二维码。
- 不要把完整订阅链接粘贴到论坛、工单公开区、代码仓库或群聊。
- 客服只需要错误类型、时间、状态码和脱敏后的域名时，不要主动提供完整凭据。
- 不要因为一次导入失败就连续刷新、反复删除重建或同时切换多个网络设置。
- 无法确认格式或来源时，优先向原提供方索取适用于 Shadowrocket 的订阅说明；不要从不明网页下载配置文件。
常见问题
Shadowrocket iOS 订阅导入失败，最先应该检查什么？
先检查订阅 URL 是否完整，再用 Safari 隐私浏览打开它。重点看返回的是订阅内容、登录页、HTML 错误页、401/403/404/429，还是直接超时。不要一开始就重装客户端或修改 DNS。
为什么订阅链接能在浏览器打开，Shadowrocket 里却没有节点？
浏览器能打开只说明请求得到了某种响应，不代表响应格式能被 Shadowrocket 解析。可能返回的是登录页、HTML、Clash YAML、sing-box JSON 或其他客户端格式。应确认原提供方给的是适用于 Shadowrocket 的订阅格式，并检查 Home 中是否打开了正确的 Subscribe 条目。
Shadowrocket 导入成功但节点为空，是否说明链接一定失效？
不一定。也可能是返回格式不兼容、订阅更新没有完成、打开了旧条目，或来源暂时返回空内容。保留原配置，记录更新前后节点数量，再用 Wi-Fi 和蜂窝网络各复测一次；无法确认时向原提供方核对账号和格式。
出现 401、403、404 和 429 分别怎么办？
401 通常指认证凭据无效或缺失；403 表示服务器拒绝请求；404 表示资源路径不存在或不提供；429 通常表示请求过于频繁。先停止连续刷新，重新核对完整链接和授权，再根据状态码联系原提供方确认，不要仅凭一次状态码判断服务长期状态。
节点已经导入，为什么 Shadowrocket 仍然无法联网？
导入成功和连接成功是两个阶段。先确认已选中具体节点，再检查 Global Routing、iOS VPN 权限和连接状态；如果 VPN 已连接但部分网站失败，再检查规则命中和 DNS。每次只修改一个设置，便于知道是哪一步产生影响。
导入失败需要删除 Shadowrocket 后重装吗？
通常不应把重装作为第一步。先备份订阅链接和已有配置，检查 URL 返回内容、格式、网络和 VPN 权限。只有在确认客户端本地状态异常且已有必要备份时，才考虑重装；重装也不会修复失效链接、权限不足或不兼容格式。
相关阅读
参考资料
- App Store：Shadowrocket 产品页
- RFC 9110：HTTP Semantics
- Apple Developer：Configuring network extensions
- Shadowrocket 订阅导入界面参考页（官方属性未核实）（shadow-official.com）