本文适用于已经持有自己服务商订阅的用户。先区分请求失败、返回内容无法解析和有效条目为空，再核对链接与账号状态，最后检查 Subscribe 的更新路径。排查期间保留原订阅和可用条目，每次只修改一个条件，并记录结果。
一、先区分“导入失败”和“导入后为空”
Shadowrocket（小火箭）是 App Store 发行的闭源商业应用，采用一次性买断。产品页可核对开发者 Shadow Launch Technology Limited 和应用 ID 932747118。客户端购买不等于线路套餐；本文不提供、不销售、不推荐节点或订阅。
订阅更新包含三个环节：请求订阅地址、读取响应内容、把支持的条目写入列表。列表为空不一定表示网络连接失败。服务器也可能正常响应，却返回登录页面、错误说明或不含有效条目的内容。
- 请求没有完成：表现为超时、域名无法解析或连接失败。先检查访问路径，不急着改协议参数。
- 请求完成但解析失败：重点检查返回格式。网页能打开，不代表它就是可导入的订阅内容。
- 更新后仍没有条目：请服务商确认响应中是否确实包含有效条目，以及账号是否有对应使用权限。
- 条目已经出现但连接失败：导入环节已取得结果，应转向服务器连通性与认证参数检查。
二、核对 Subscribe 链接，不把网页地址当成订阅
先从自己的服务商账户页面重新复制完整订阅地址。账户首页、订单页、登录页和订阅接口用途不同。不要仅凭域名相同就判断地址正确，也不要手动拼接不熟悉的参数。
https://example.com/sub?token=xxxx上面是不可用于连接的格式示例。https:// 是协议部分，/sub 是示例路径，token=xxxx 是示例认证参数。真实接口的路径与参数名由你的服务商决定，不要求与示例相同。
-
保留原记录
先记录原订阅的名称、当前条目数和失败提示。若原列表还有可用条目，不要先删除整个分组。
-
重新复制地址
从自己的服务商页面使用复制功能取得链接。检查开头和结尾是否有空格、换行、引号或聊天软件附加的标点。
-
选择 Subscribe
进入 Home → 右上角“+”→ Type → Subscribe。在 URL 中粘贴完整订阅地址，不要把整条地址填进单个服务器的 Address 或 Password 字段。
-
保存并刷新
保存后回到 Home，下拉触发更新。等待本次请求结束，记录提示和条目数，再决定下一步。
查询参数中的 &、= 和百分号编码可能参与认证。不要擅自删掉后半段参数，也不要重复进行 URL 编码。若复制出的文本含有字面量 &，应重新从原页面复制正确链接，而不是逐段猜测修复。
三、识别服务商侧响应：状态码不等于可用条目
若错误详情或服务商提供的诊断记录含有 HTTP 状态码，可据此缩小范围。以下是标准 HTTP 状态文字，不代表 Shadowrocket 在所有情况下都会显示相同报错。没有看到状态码时，不要自行认定是某一种错误。
HTTP 401 Unauthorized
原因与解法：请求未通过接口认证，可能与缺失或失效的 token 有关。重新复制自己的有效订阅地址，并请服务商核对认证状态。
HTTP 403 Forbidden
原因与解法：服务器拒绝当前请求，可能涉及账户权限或访问限制。保留发生时间和网络类型，向服务商确认拒绝原因，不要反复修改客户端密码字段。
HTTP 429 Too Many Requests
原因与解法：接口触发请求频率限制。停止连续刷新，按服务商说明或响应中的 Retry-After 指示等待，再进行一次更新。
200 OK 只说明 HTTP 请求成功返回，不能证明内容可解析。登录页面、维护公告和验证页面也可能使用这个状态码。浏览器还可能带有登录状态，而客户端订阅请求不具备同样的会话条件。
- 返回 HTML 页面：让服务商确认该地址是否为可直接读取的订阅接口，是否依赖浏览器登录。
- 返回空内容：确认账户状态、订阅权限和接口是否生成了有效条目。
- 返回内容但解析失败：确认所选订阅格式适用于 Shadowrocket，不要仅修改文件后缀来改变格式。
- 出现证书错误：核对设备日期与时间，并请服务商检查域名证书。不要以关闭安全校验作为常规修复方式。
结论：先确认接口返回什么
已有 HTTP 响应但仍导入失败时，优先让服务商核对响应内容与格式；切换 Global Routing 不能把登录网页转换成订阅条目。
四、检查更新时机与 Update via Proxy
订阅接口与订阅内的服务器不是同一个测试目标。普通网页能打开，只能证明部分网络访问正常；某个条目的 Connectivity Test 成功，也不能证明订阅域名当前可访问。两类结果应分别记录。
在 Settings → Subscribe 中检查 Update via Proxy。该设置用于调整订阅更新的访问路径，不是修复链接格式或账号权限的开关。启用前应已有可用的代理连接，否则可能出现“需要更新才能获得条目，却又依赖这些条目完成更新”的循环。
- 先保留当前列表，在稳定网络中完成一次更新，并记录是否超时。
- 如果已有可用条目，先选中该条目并开启连接，确认实际访问正常。
- 进入 Settings → Subscribe，启用 Update via Proxy，再回到 Home 下拉更新一次。
- 比较两次结果。只有更新路径变化后结果随之变化，才有依据继续检查该路径的连通性。
- 若出现明确的 401、403 或内容解析错误，转回认证与响应内容检查，不要持续切换网络碰运气。
首次导入完全没有可用条目时，不要把启用 Update via Proxy 当成前提条件。可先在自己有权使用的另一稳定网络下做一次对照。若接口仍不可达，请服务商确认该接口的访问条件。
五、条目已出现时，停止按“空订阅”排查
列表中已经出现服务器条目，说明至少有内容被成功解析。接下来应测试具体条目，而不是重复导入同一地址。服务商变更密码、端口或服务器地址后，旧条目仍可能留在本地，因此也要先确认本次更新是否真正成功。
- Home → Connectivity Test：检查目标条目的连通性。单次成功不等于所有网站、所有协议和所有时段都正常。
- Home → Global Routing：核对当前选用 Proxy、Direct、Config 或 Scene。Direct 下的直连结果不能用于证明所选代理条目可用。
- 使用 Config 时：检查当前配置的匹配规则与策略。
DOMAIN-SUFFIX、IP-CIDR、GEOIP和FINAL影响流量处理，不负责生成订阅列表。 - 部分条目可用：记录失败条目的名称和测试时间，交由服务商核对对应服务器，不必删除全部订阅。
订阅接口使用 HTTPS 默认端口 443，不代表订阅中的服务器也使用 443。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 各有自己的连接参数。不要把订阅 URL 的端口抄进所有条目，也不要为了让测试通过而随意更换 Type。
六、向服务商反馈前，整理可复现的信息
客户端侧可以核对链接、更新路径和可见提示，但不能替服务商恢复账号权限、修复接口证书或生成远端条目。提交信息时应说明问题发生在哪个环节，避免只写“用不了”。
- 发生时间：记录日期、具体时间与时区，便于对照服务端日志。
- 网络条件：说明使用 Wi-Fi 还是蜂窝网络，以及是否在另一网络复现。
- 更新路径：说明 Update via Proxy 的状态；启用时，说明所依赖的连接是否已经验证可用。
- 可见结果：提供错误原文、HTTP 状态码（若有）、更新前后条目数量，不要补写猜测的错误原因。
- 隐私处理：公开截图遮住完整订阅 URL、token、密码与账户信息；完整凭据只按服务商私密支持流程提供。
结论：一次只改变一个条件
保留原记录，分别测试链接、网络和更新路径。若同时重建订阅、切换网络并改动连接设置，即使恢复，也难以确定是哪一项解决了问题。
七、订阅导入与更新常见问答
链接在浏览器能打开，为什么还是导入失败？
先判断打开的是订阅内容还是登录网页。浏览器可能携带账户会话。回到服务商页面重新复制订阅地址，再通过 Home → “+”→ Type → Subscribe 添加；仍失败时让服务商确认接口可被客户端直接读取。
更新失败后，要不要马上删除原来的订阅？
不要先删除。保留原分组和已有可用条目，记录错误后再检查 URL 与更新路径。删除记录不会修复远端认证，反而可能让后续对照失去依据。
重置过订阅链接，旧链接还能继续用吗？
是否立即失效由服务商决定。重置后应将新的完整 URL 更新到对应 Subscribe 记录，再手动刷新一次。旧列表仍在本地，不代表旧链接仍有访问权限。
开启 Update via Proxy 后仍然超时怎么办？
先验证当前代理连接本身可用，再检查订阅接口是否可通过这条路径访问。没有可用连接时先恢复可验证的更新路径。若两条路径都失败，向服务商提交时间、网络条件和错误提示。
买了 Shadowrocket，为什么 Home 还是空的？
购买的是客户端，不包含线路套餐。已有自己服务商订阅的用户，需要按 Subscribe 流程导入。应用仅在 Apple 平台发行，以 iPhone 和 iPad 为主；系统要求以 App Store 页面标注为准。