小火箭订阅导入失败或为空:链接格式与更新时机自查

Subscribe 解析失败或列表为空时,依次核对链接格式、服务商侧状态与更新时机,再按步骤重新导入,定位问题出在哪一环。

本文速览

本文适用于已经拥有自己的服务商与订阅、但在 Shadowrocket(小火箭)中无法导入或更新后看不到服务器的用户。排查按“链接完整性、请求结果、返回内容、重新导入”展开;先保留已有配置,再做一次可对照的更新,避免把访问失败、内容为空与连接失败混为一谈。

先区分导入失败、列表为空与连接失败

Subscribe 的作用是从指定地址取得内容,并将可识别的服务器配置加入列表。保存了一个订阅条目,不等于已经取得有效内容;列表里出现服务器,也不等于该服务器一定能够连接。先判断卡在哪一层,再调整相应设置,比反复删除整个列表更容易保留线索。

读取链接 请求地址 取得内容 解析配置 显示列表

Home 负责查看服务器和连接状态,Config 用于管理配置文件,Settings 提供应用设置。不要为了修复 Subscribe 请求失败而先清空 Config;两者处理的对象不同。本文也不以修改 Global Routing 作为通用修复,因为订阅更新请求的实际路径还受相关设置和当前网络环境影响。

核对 Subscribe 链接,保留原始字符

订阅地址通常包含域名、路径和查询参数。查询参数里的 token 具有访问凭证的性质,少一个字符就可能变成另一条请求。应从自己服务商的订阅入口直接复制,不从聊天预览、截图识别结果或经过省略的地址栏文本中拼接。

https://example.com/sub?token=xxxx

上面是不可用于实际连接的假值,仅用于说明格式。https:// 是访问方式,example.com 是示例域名,/sub 是示例路径,token=xxxx 是示例参数。真实地址的路径和参数名称可以不同,应以自己服务商提供的原文为准,不能照着示例替换真实链接。

443
HTTPS 未显式指定端口时使用的默认端口
?
URL 路径与查询部分之间的分隔符
&
查询部分中多个参数的常见分隔符

结论:先重新复制,再比较结果

如果怀疑地址被截断,直接从自己的账户重新复制完整链接,保留旧条目做对照。不要凭记忆补齐 token,也不要把完整地址发送到公共讨论区或在线检测工具。

按请求结果区分网络问题与服务端问题

收到 HTTP 错误状态与完全没有收到响应,需要不同的处理方式。以下卡片列出标准 HTTP 状态短语,便于对应诊断信息或服务商提供的响应记录;Shadowrocket 的提示措辞可能不同,不要求屏幕上逐字出现这些英文。没有状态码时,应记录应用实际提示,而不是自行推断为凭证过期。

HTTP 401 Unauthorized

原因与解法:服务端未接受当前认证信息。确认链接是否完整、凭证是否被重置,再从自己的账户复制当前有效的订阅地址。

HTTP 403 Forbidden

原因与解法:服务端拒绝了这次访问,但不能仅凭状态码认定原因。向自己的服务商核对账户权限、访问限制或安全拦截,并提供已隐藏凭证的错误记录。

HTTP 404 Not Found

原因与解法:请求的路径未找到,也可能是服务端隐藏资源的响应。先比对域名与路径,再确认订阅端点是否变更,不要只替换 token 后继续尝试。

HTTP 429 Too Many Requests

原因与解法:请求触发了频率限制。停止连续刷新;若响应包含 Retry-After,按其指定的时间间隔或时刻再试,否则按服务商说明等待。

HTTP 503 Service Unavailable

原因与解法:服务暂时无法处理请求。保留原配置,确认服务端状态与恢复安排;重复删除、重建订阅不会修复服务端故障。

如果表现为超时、域名无法解析或 TLS 校验失败,先确认 iPhone 或 iPad 当前网络可以完成普通 HTTPS 访问,再单独切换 Wi-Fi 与蜂窝网络进行对照。一次只改变网络这一项,并记录结果。出现证书错误时还应检查系统日期与时间是否正确,不通过关闭证书校验来绕过问题。

返回成功但为空,检查内容而不是只看状态

HTTP 200 表示请求在 HTTP 层面成功,不保证正文是 Shadowrocket 能识别的订阅内容。登录页、到期提示页、安全验证页也可能返回 200;它们是网页文本,不是可直接导入的服务器列表。浏览器能展示页面,因此不能单独作为“订阅正常”的依据。

观察到的结果可能卡住的环节下一步
返回登录页面或安全验证页面请求没有取得预期订阅正文确认使用订阅专用端点,并向服务商核对访问要求
响应正文没有内容服务端未输出服务器配置核对账户状态及该订阅当前是否应包含条目
内容存在,但格式不匹配返回格式与导入入口不对应确认服务商提供的是适用于 Shadowrocket 的订阅格式
已有条目但主列表未展开列表显示状态在 Home 展开对应分组并检查筛选条件

账户到期、权限调整、服务器维护或订阅生成尚未完成,都可能影响返回内容,但不能只凭“空列表”判断是哪一种。到自己的账户页面核对状态,并让服务商确认该链接此时应返回多少条有效配置。不要把账户页面显示的套餐名称当作已经生成有效订阅的证据。

协议名称与订阅封装格式也要分开理解。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是连接配置涉及的协议或隧道类型,并不表示任意包含这些名称的文本都能由 Subscribe 直接解析。不要自行改写编码内容或拼接协议字段;需要手动参数时,应按对应入口和完整参数填写。

结论:200 与有效条目是两次判断

请求成功但没有条目时,先确认服务端确实返回了可识别内容,再检查应用列表状态。此时调整 DOMAIN-SUFFIX 或 FINAL 等分流规则,不会把空正文变成服务器配置。

保留现有配置,按步骤重新导入一次

重新导入适合验证“复制地址是否出错”或“旧条目保存的地址是否已失效”,不应成为每次失败后的第一动作。开始前记录原订阅名称和条目数量;如已有可用配置,先保留,不删除整个 Home 列表。不同界面布局可能略有差异,以相同英文入口辨认操作。

  1. 记录现状

    在 Home 查看原订阅分组,记下可见服务器数量与最近一次更新的结果。保留原条目,不在排查过程中同时修改 Config 或服务器参数。

  2. 复制地址

    从自己服务商的账户入口重新复制完整订阅链接。若刚刚重置了凭证,使用新地址,并确认旧地址是否已失效。

  3. 选择类型

    进入 Home → 右上角“+”→ Type → Subscribe。返回添加页面,将链接粘贴到 URL 字段,用可辨认的备注区分这次测试与原条目。

  4. 保存并更新

    保存后回到 Home,下拉触发更新,等待本次请求结束。记录实际提示,避免在请求仍进行时连续下拉;若有多个订阅,注意区分失败的是哪一项。

  5. 核对列表

    展开新订阅分组,核对是否出现服务器及其数量。新条目成功后再整理重复项;新旧条目都失败时,保留错误记录,转向网络或服务端检查。

若新地址可以导入、旧地址仍失败,优先比较二者保存的 URL 和凭证状态。若两个条目均能显示服务器,但只有连接失败,则应结束本轮导入排查,另行检查选中的服务器。不要将延迟测试失败直接记录为 Subscribe 解析失败。

更新时机与反馈记录

更新订阅会重新请求服务端内容,但不会自动恢复已经到期的账户权限,也不会立即解除请求频率限制。凭证重置、权限恢复或内容调整后,先确认服务端已完成生效,再进行一次手动更新。自动更新的启用状态和执行时机受设置及系统运行条件影响,不以“已经打开应用”推定更新已经成功。

提交问题时保留哪些信息

有效反馈应能复现操作,同时保护访问凭证。向自己的服务商说明发生时间、所用网络、导入入口、更新前后条目数量,以及实际错误原文。如果记录包含完整 URL,应隐藏 token、账户标识和其他授权参数;不要发送订阅正文、服务器密码或二维码。

入口:Home → + → Type → Subscribe
操作:保存后返回 Home,下拉更新一次
现象:原有条目仍在,新订阅分组没有服务器
对照:分别记录 Wi-Fi 与蜂窝网络的更新结果
错误:抄录本次实际提示,不凭现象猜测状态码
隐私:反馈材料中隐藏 URL 凭证与账户信息

最终按三层结果收尾:请求未完成,继续查网络与端点;请求完成但没有有效条目,查返回内容与账户状态;条目已经出现但不能连接,查服务器配置与连接过程。每次只处理一层,能减少误删配置,也能让后续反馈有明确依据。

App Store 正版入口 先核对开发者与应用 ID