本文速览

本文适用于已经持有自己服务商订阅的 Shadowrocket(小火箭)用户。先区分“没有取回内容”“取回的不是订阅”“订阅没有可用条目”三种情况,再检查链接、服务商状态、刷新时机与网络路径。排查期间保留原有记录,每次只改变一个条件;最后整理不含凭据的反馈信息,判断应由设备端调整还是由自己的服务商处理。

一、先区分请求失败、解析失败与显示为空

订阅不是一组始终保存在链接里的固定节点。更新时,客户端先访问地址,取得服务端返回的内容,再把其中支持的服务器条目写入本地列表。任一环节失败,都可能表现为更新异常,但处理方法并不相同。

读取链接请求地址接收内容解析条目显示列表

先在 Home 查看目标订阅是否只是分组折叠,确认没有把其他分组的节点数量当作该订阅的结果。随后记录刷新时看到的完整提示。下面的现象可以帮助定位环节,不应仅凭“空白”两个字就删除整个订阅。

本文的界面定位以 iPhone / iPad 上的 Home、Config、Settings 为例。Mac、Windows、安卓与 Linux 上同样可以按“请求、响应、解析、显示”定位问题,但不要把移动端的下拉手势当作桌面端必须存在的操作;应从目标订阅的操作菜单执行更新。

二、核对完整链接:不要把管理页面当作订阅地址

回到自己服务商的订阅管理页面,重新使用其复制订阅地址的功能。复制后只在本机查看内容,核对地址开头、域名、路径及查询参数是否完整。浏览器地址栏中的账户首页、订单页和登录页通常不是客户端需要读取的订阅端点。

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

上面只是用于辨认结构的假值,不可用于导入。真实地址中的 token 等字段可能相当于访问凭据;不能因为看起来像随机字符就删掉。也不要把其他服务商的参数名套用到自己的链接。

  1. 检查首尾是否多出空格、换行、引号或中文标点。聊天软件显示的换行不一定属于链接,实际粘贴后再确认。
  2. 确认 https:// 没有被截断;路径大小写、? 后的参数以及 & 分隔符均保持原样。
  3. 如果文本中出现字面量 &,回到原页面重新复制,不要未经确认就批量替换或解码整条地址。
  4. 服务商提供多种导出格式时,选择其明确标注适用于 Shadowrocket 的订阅输出,不要把网页分享地址或整份 Config 文件地址直接当作同类内容。

三、检查服务商响应:状态码与空内容分别处理

浏览器能打开某个页面,不等于该地址能作为订阅使用。登录后的浏览器可能持有 Cookie,而订阅请求未必具有同一登录状态;服务端也可能返回验证页面。即使 HTTP 状态为 200,正文仍可能是 HTML,而不是客户端能够解析的服务器数据。

443
HTTPS 未显式指定端口时使用的默认端口
401 / 403
优先检查授权要求与访问策略
200
HTTP 请求成功,不保证正文是有效订阅

以下卡片列出的是标准 HTTP 响应原文,用于解释你在错误详情或服务商反馈中看到的状态,并不表示 Shadowrocket 一定会逐字显示这些提示。

HTTP 401 Unauthorized

原因与解法:请求缺少有效身份凭据,或凭据已失效。回服务商页面重新复制有效订阅地址,确认账户状态后,再更新目标订阅。

HTTP 403 Forbidden

原因与解法:服务器拒绝当前请求,可能涉及账户权限、来源限制或访问策略。记录时间与网络类型交给自己的服务商确认,不要把修改客户端规则当作解除服务端权限限制的方法。

HTTP 429 Too Many Requests

原因与解法:请求触发了频率限制。停止连续刷新;如果响应带有 Retry-After,按其指示等待,否则按服务商公布的刷新间隔重试。

HTTP 503 Service Unavailable

原因与解法:服务端暂时不能处理请求。先查看自己的服务商维护说明,稍后再试;重复删除和添加本地订阅不能修复服务端故障。

判断:先确认正文类型,再调整本地设置

若服务商确认响应是登录页、验证页或空内容,应先由服务商修正订阅输出;在本地切换协议或重排规则,不能把这些响应变成服务器条目。

四、选择更新时机:保留旧条目,一次完成一个验证

修改账户套餐、重置订阅凭据或服务商调整条目后,管理页面和订阅端点的结果可能不是同时变化。此时连续点击更新既难以判断结果,也可能触发频率限制。按照服务商说明等待,并把“最近一次尝试时间”与“最近一次确认成功时间”分开记录。

  1. 保留现场:记录原订阅名称、当前条目数和报错。若旧节点仍可用,先不要删除整个分组,也不要清空应用数据。
  2. 确认新地址生效:若刚重置凭据,确保本地订阅地址已经替换;保留旧地址反复刷新只会重复得到失败结果。
  3. 只更新目标订阅:在 Home 找到对应订阅并执行更新;使用下拉刷新时,留意实际触发了哪些订阅请求,避免把另一条订阅的结果混入判断。
  4. 等待完成再比较:核对该分组是否出现条目、数量是否变化、错误是否相同。一次操作结束后再改下一个条件。

不要把“反复重新导入”当成默认修复步骤。它可能创建重名分组,使旧条目和新条目同时存在,也会掩盖究竟是哪一次更新成功。如果确实需要重建记录,应先确认有效链接已经保存,并明确知道要移除的是哪一个订阅分组。

五、切换网络验证:把订阅请求与节点连接分开

订阅地址的可访问性与某个节点的可连接性是两项不同条件。节点能连接,不保证订阅域名可以访问;反过来,订阅更新成功也不保证每个节点都能建立连接。测试时先固定同一条订阅链接,再只改变 Wi-Fi 或蜂窝网络这一个变量。

观察结果优先检查下一步
Wi-Fi 失败,蜂窝网络成功Wi-Fi 的认证状态、DNS 与出口策略先完成网络登录,记录失败网络环境,暂不改订阅内容
两种网络均返回 401订阅凭据与账户权限重新复制有效地址,向自己的服务商确认授权
两种网络均出现解析异常响应正文及导出格式请服务商核对端点实际返回的内容
更新成功,连接仍失败服务器地址、端口与连接参数转入连接排查,不再反复替换订阅链接

如果测试中连接开关反复自动开启,可到 Settings → On Demand 检查按需连接条件,并记录原设置。只在理解其作用时临时调整,完成测试后恢复。On Demand 影响连接触发条件,并不是解析订阅正文的开关。

Global Routing 下的 Proxy、Direct、Config、Scene 用于控制路由行为,不是订阅数据格式。不要通过改写 DOMAIN-SUFFIX、GEOIP、IP-CIDR 或 FINAL 来修复无效内容;是否需要调整某条网络路径,应以实际请求结果为依据。

六、节点仍为空:先核对条目,再整理反馈

如果目标分组已经展开,更新也没有网络错误,但仍然没有服务器条目,请服务商确认该订阅当前是否确实包含可导出的节点。账户到期、套餐未生效、服务端筛选条件或输出异常,都可能导致内容为空;具体原因需要由服务商根据账户和响应判断。

协议名称相同也不意味着每一份输出都能直接导入。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的连接参数各不相同。不要只把条目开头的协议名替换成另一种协议,也不要凭空补写端口;应取得服务商为 Shadowrocket 提供的有效输出。

七、订阅更新常见问答

同一条链接在浏览器有内容,为什么导入还是失败?

先分辨内容是服务器数据还是网页。若看到登录表单、验证提示或账户面板,就不能据此认定订阅正常。不要把网页源码整段粘进 Home;请自己的服务商确认客户端实际能取得的订阅输出。

我是不是先把旧订阅删掉,再加一次就能好?

先不要删除。记下目标分组和报错,核对原地址是否仍有效,再执行一次更新。只有确认记录填错或确实需要重建时才删除对应分组,避免连同仍可使用的旧条目一起移除。

刚更新完却没有新节点,要一直下拉吗?

不用连续刷新。先确认服务商管理页是否已经有新条目,再按其刷新间隔等待;若出现 429,应停止尝试。等待后仍为空,把时间、目标分组和网络测试结果交给服务商核对。

已经有节点但网页打不开,也属于解析失败吗?

不属于同一阶段。先确认 Home 中选中的服务器,再检查 Global Routing 当前姿态和连接结果;使用 Config 时,还要核对实际启用的配置。订阅条目已经出现后,继续重复导入通常不能解决服务器连接或规则匹配问题。

获取 Shadowrocket 与查看导入教程

iPhone / iPad 版 App Store $2.99 一次性付费,Mac(Apple 芯片 / Intel)/ Windows / 安卓 / Linux 版免费,共 2 档获取。iPhone / iPad 系统要求以 App Store 页面标注为准。前往下载页选择对应设备,或查看首次导入与连接步骤。