Shadowrocket 订阅解析失败或节点列表为空:链接格式与更新时机自查

订阅导入后报错或列表为空时,按链接格式、服务商侧状态、更新时机与网络环境四步排查,并说明何时需联系你的服务商。

本文速览

本文适用于已经持有自己服务商订阅链接的用户。先区分“请求失败”“内容无法解析”和“成功返回但没有可用条目”,再核对 Subscribe 的 URL、服务商返回内容与更新时机,最后用单变量方式检查网络。排查时保留现有配置,不要先删除仍能使用的条目。

一、先确认失败发生在哪个环节

Shadowrocket(小火箭)的订阅更新,是从指定 URL 请求内容,再把支持的节点记录转换为 Home 中的条目。订阅链接能保存,不等于服务器已经返回有效内容;服务器返回成功状态,也不等于内容一定包含可解析的节点。

读取链接请求服务器接收内容解析记录显示条目

记录当前现象:是添加时立即提示失败,还是更新等待后超时;是原有条目仍在但更新失败,还是新建的订阅分组一直为空。旧条目存在,只能说明本地曾保存过数据,不能证明本次更新成功。节点能够连接,也不能证明订阅地址目前仍有效。

3 环节
请求、解析、列表显示分别核对
4 步
链接、服务状态、更新时机、网络
1 项
每轮只改变一个测试条件

判断:先保留现象,再修改设置

先记下报错原文和操作时间,再进行一次手动更新。若直接删除订阅、切换配置并重装应用,将无法判断究竟是哪一个变化影响了结果。

二、核对 Subscribe 中保存的链接

订阅 URL 应来自用户自己的服务商,不能用账户登录页、订单页或网页分享页代替。以下地址只是结构示例,不能用于导入。URL 中的路径和查询参数可能共同承担身份识别作用,不能只复制域名。

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

    在自己的服务商账户页面使用订阅复制功能,选择其标明适用于 Shadowrocket 的格式。不要从截图识别链接,也不要把页面标题一并复制。

  2. 核对添加位置

    在 Home 右上角选择“+”,将 Type 设为 Subscribe,再把完整地址放入 URL。已有订阅应先检查原记录,不必反复新建相同分组。

  3. 检查字符边界

    核对开头的 https://、末尾参数与复制前是否一致,移除地址外侧的空格、换行或引号。保留参数内部原有字符,不要随意删改 ?、&、= 或百分号编码。

  4. 保存并更新

    保存后回到 Home,下拉刷新订阅列表,等待本次操作结束,再查看目标分组是否出现条目。记录这一次结果,避免连续触发多次请求。

单节点 URI 与订阅 URL 不是同一种输入。以 ss://、vmess:// 或 trojan:// 等形式提供的单条记录,应按相应导入方式处理,不能把它当作一个 HTTP 订阅地址填入 Subscribe 的 URL。反过来,订阅页面地址也不能直接当成某个协议的服务器地址。

订阅 URL 可能含有账户令牌。不要把完整地址发到公开评论、截图或在线解码工具。需要求助时保留域名与错误信息,遮盖路径中的密钥和全部身份参数。

三、区分 HTTP 状态与响应内容

如果提示或服务商日志包含 HTTP 状态,先按状态定位。下面列出的是标准 HTTP 响应状态,不代表 Shadowrocket 在所有系统上都会逐字显示这些文本。没有状态码时,保留实际提示,不要自行补成“链接过期”。

报错:401 Unauthorized

原因:服务器要求的身份认证没有通过,可能是令牌失效、缺失或认证方式不符。

解法:回到自己的服务商账户页重新复制当前订阅 URL;若仍返回相同状态,向服务商核对该令牌的权限。

报错:403 Forbidden

原因:服务器拒绝当前请求,可能涉及访问策略、账户权限或安全拦截,不能仅凭此状态认定套餐到期。

解法:记录时间、网络类型与完整错误文本,请服务商查对应请求;不要连续刷新尝试绕过限制。

报错:404 Not Found

原因:请求的路径不存在,可能是链接被截断、旧地址已停用,也可能是服务端主动隐藏资源。

解法:逐项比对当前账户页给出的路径和参数,不要自行猜测接口路径;新链接仍失败时交由服务商确认。

200 OK 只表示 HTTP 层面的请求成功。返回正文仍可能是登录页面、安全验证页、维护通知或空内容。这些内容即使可以在浏览器中打开,也不能据此判断客户端应当生成节点。浏览器还可能带着账户 Cookie,而订阅请求并不等同于已登录的网页会话。

四、核对服务商状态与更新时机

订阅分组为空,可能源于服务端当前没有给账户分配可用条目,也可能是订阅输出与账户页面状态尚未同步。账户余额、套餐状态、设备限制和订阅权限是不同字段,应以自己的服务商实际说明为准;Shadowrocket 中的空列表不能单独证明其中任何一项。

  1. 检查账户:登录自己的服务商页面,确认服务状态、有效期以及页面中是否存在可用条目。若账户页面本身为空,先联系服务商。
  2. 检查链接变更:如果刚重置过订阅令牌,原 URL 可能已经失效。把 Home 中保存的地址与新 URL 对照,不能只比较相同的域名。
  3. 等待服务端完成:刚变更套餐或恢复服务时,按服务商标注的处理时间再更新。不要假定操作提交后所有接口立即同步。
  4. 检查请求限制:遇到 429 Too Many Requests 时停止连续更新;若响应包含 Retry-After,按其指示等待,否则询问服务商允许的更新间隔。

不要把“每隔几秒刷新一次”当作排查方法。频繁请求可能触发限流,使原本的格式问题叠加访问问题。如果旧条目仍可使用,可以先保留它们,等新订阅内容确认有效后再整理重复记录。

判断:账户页也为空时,先处理服务端状态

如果账户页没有可用条目,或服务商确认订阅接口尚未生成数据,继续切换协议、规则或 DNS 不能补出节点。先让服务商确认接口能够返回有效记录,再回到 Home 更新。

五、用单变量测试网络与连接状态

请求超时、域名解析失败和 TLS 错误发生在不同阶段。超时可能是连接未建立,也可能是响应迟迟未结束;证书错误应检查系统时间、目标域名与服务端证书,不能靠忽略证书检查来替代排查。只改变一个条件,才能比较前后结果。

  1. 记录当前状态

    记下当前使用 Wi-Fi 还是蜂窝网络、Home 连接开关状态、Global Routing 当前选项,以及实际报错。不要同时更改 DNS 和规则。

  2. 切换接入网络

    在同一订阅 URL、相同连接状态下,切换 Wi-Fi 与蜂窝网络后各更新一次。若仅一个网络失败,优先检查该网络的登录认证、DNS 或访问限制。

  3. 检查自动连接

    若手动关闭后连接又自动建立,到 Settings → On Demand 查看是否启用了触发条件。记录原设置,再临时停止自动连接测试,完成后恢复。

  4. 比较连接前后

    仅在已有可用节点时,比较断开与连接状态下的更新结果。不能使用尚未导入成功的订阅建立连接,也不能假定订阅请求必然跟随所选节点出站。

Global Routing 下的 Config、Proxy、Direct、Scene 涉及流量处理方式,但不负责把网页转换成节点。Config 中的 DOMAIN-SUFFIX、GEOIP、IP-CIDR 和 FINAL 是规则关键字,不是订阅解析修复开关。遇到空列表时,先核对响应内容,再决定是否有必要检查规则与出站路径。

“能打开服务商首页”只证明该网页在当前环境中可访问,不证明订阅接口、重定向目标及其身份参数均可用。比较测试时应围绕同一个订阅请求记录结果。

六、何时联系服务商,以及提供哪些信息

当最新链接持续返回认证错误、账户页有条目但接口为空,或服务商指定格式仍无法解析时,应联系自己的服务商。由其确认接口权限、响应内容、格式兼容性与请求日志,比反复删除本地记录更有针对性。

修复后回到 Home 手动更新一次,确认目标分组出现记录,再选择已有条目测试连接。列表出现与连接成功是两个验收点:前者验证订阅获取和解析,后者还取决于节点地址、端口、协议参数及当前网络。若条目已出现但不能连接,应转入连接问题排查,不必继续重建订阅。

本文以用户已有自己的服务商与订阅为前提。本站不提供、不销售、不推荐节点或订阅。客户端获取与线路服务分别处理,客户端买断 ≠ 线路套餐。

Shadowrocket 官方下载