· 故障排查 · 约 7 分钟

Shadowrocket 订阅解析失败或节点为空:链接格式、服务商侧与更新时机自查

订阅添加后提示解析失败或列表为空时,按链接格式、服务商侧状态、更新时机三条线逐步排查,给出每一步在 Shadowrocket 里的核对位置。

本文速览

已有自己的服务商和订阅链接,但在 Shadowrocket 的 Home 看不到服务器条目时,先核对添加类型和链接全文,再确认服务商返回的确实是服务器列表,最后手动刷新一次并比较结果。下文以 iPhone / iPad 界面为例;如果条目已经显示,只是选中后连不上,应转入连接排查,不要反复重导订阅。

先区分下载失败、解析失败和列表为空

订阅条目出现在 Home,只表示应用里已有这项订阅,不代表服务器列表已成功更新。一次更新要先向订阅地址发请求,再读取响应、识别其中的服务器条目,最后在 Home 显示结果。下载失败时,应用可能没有拿到可读取的响应;解析失败时,要核对拿到的内容是不是预期格式;列表为空时,还要确认服务商当前是否实际分配了条目。仅凭一个通用提示,有时不能确定失败发生在哪一步。

订阅地址网络请求服务端响应内容解析列表显示

Failed to load subscription

可能原因:链接已失效,或者请求未能取得可供读取的订阅内容。处理:到自己的服务商后台确认当前链接是否有效、是否生成了服务器列表,再回 Home 下拉刷新一次并记下结果。

401 Unauthorized

可能原因:如果服务商确认订阅请求返回该 HTTP 状态,通常是请求没有提供有效的认证信息,例如链接中的令牌已失效。处理:从自己的账户后台重新复制完整链接;如果最新链接仍返回此状态,请由服务商核对认证要求。这不是 Shadowrocket 固定显示的提示文案。

核对链接格式:在 Home 用 Subscribe 添加

先确认复制的是服务商专门提供的订阅地址,而不是账户后台、登录页或说明页的网址,也不是单个服务器的分享地址。一个能在浏览器里打开的网址,不一定能用于订阅。下面只演示地址结构,不能用来导入服务器:

https://example.com/sub?token=xxxx
  1. 复制当前链接

    从自己的服务商后台复制当前订阅地址。不要从聊天消息中复制带省略号的预览文字,也不要把地址末尾的句号、引号或换行一起带入。

  2. 选择添加类型

    在 Shadowrocket 打开 Home,点右上角的 +,在 Type 选择 Subscribe。此处添加的是用于取得服务器列表的地址,不是到 Config 导入规则文件。

  3. 核对完整地址

    粘贴链接,核对开头的协议、主机名、路径,以及 ? 后是否保留了全部查询参数。如果原地址含 & 或百分号编码,应按原样保留;不要凭猜测删掉参数,也不要把编码手动改成普通字符。

  4. 保存后刷新

    保存并返回 Home,在服务器列表区域下拉刷新。等待本次操作返回结果,再检查对应订阅下是否有新条目。若此前已添加同一订阅,先核对原条目,不要为了测试而反复添加副本。

订阅参数可能包含账户凭据。核对时只在自己的设备和服务商后台对照全文,不要把真实链接粘贴到公开的解析工具、帖子或截图中。需要描述链接格式时,用假值替换令牌和其他能识别账户的信息。

核对服务商响应:HTTP 成功不等于列表有效

链接无误但仍解析失败时,在服务商后台核对订阅是否启用、是否有分配给当前账户的服务器,以及是否更换过订阅地址。能登录后台,只能证明浏览器当前可以访问账户页面;浏览器可能带有登录状态,而 Shadowrocket 请求订阅地址时,不会自动取得你在浏览器里的登录状态。

200
HTTP OK:请求成功,不代表正文是有效列表
401
HTTP Unauthorized:请求缺少有效认证凭据
429
HTTP Too Many Requests:请求过于频繁

结论:链接正确后,先问服务商返回了什么

如果完整链接在 Home 下拉刷新后仍失败,向服务商提供刷新时间和时区,请其核对当时的 HTTP 状态、响应是列表还是网页、列表是否含条目。先确认这三项,再决定是否需要更换链接或调整输出格式。

核对更新时机:一次只改变一个条件

刚启用订阅、重置令牌或调整账户分配时,先确认变更已经作用到订阅地址,再回 Home 刷新。续期或分配更新可能仍沿用原地址;如果服务商明确重置了链接,就应更新保存的地址,而不是继续刷新旧地址。没有统一的等待时长,以自己的服务商给出的生效状态为准。

  1. 记录刷新前的现象。在 Home 确认检查的是哪项订阅,记下当前可见条目数和提示原文。旧条目仍然显示,并不证明刚才的刷新已经成功。
  2. 确认变更后刷新一次。返回 Home 下拉,查看是否出现条目、旧条目是否如预期发生变化、提示是否仍然相同。若服务商确认返回 429,按服务商提供的等待时间重试,不要连续下拉。
  3. 只有在怀疑网络时才做对照。如果当前网络上的刷新提示超时,可改用同一设备上的另一种可用网络,对同一地址再试一次。测试时不同时修改链接和账户设置;如果只在一种网络失败,优先检查订阅地址在该网络是否可达,不要据此认定列表格式有误。
  4. 条目恢复后停止重导。如果 Home 已显示预期条目,而使用其中一条时连不上,再用 Connectivity Test 检查连接。该测试不是用来确认订阅返回格式的,不能代替刷新后的列表核对。

仍然为空时,整理可交给服务商的记录

报障时,把“订阅是否更新”和“服务器能否连接”分开描述。写明是首次添加后始终为空,还是原有列表在某次变更后变空;两种情况需要核对的服务端记录不同。先保留现有条目和报错现场,不必用重装应用或清空 Config 来测试同一个订阅响应。

下载 Shadowrocket