本文适用于已经持有自己服务商订阅的 Shadowrocket(小火箭)用户。先区分“没有取回内容”“取回的不是订阅”“订阅没有可用条目”三种情况,再检查链接、服务商状态、刷新时机与网络路径。排查期间保留原有记录,每次只改变一个条件;最后整理不含凭据的反馈信息,判断应由设备端调整还是由自己的服务商处理。
一、先区分请求失败、解析失败与显示为空
订阅不是一组始终保存在链接里的固定节点。更新时,客户端先访问地址,取得服务端返回的内容,再把其中支持的服务器条目写入本地列表。任一环节失败,都可能表现为更新异常,但处理方法并不相同。
先在 Home 查看目标订阅是否只是分组折叠,确认没有把其他分组的节点数量当作该订阅的结果。随后记录刷新时看到的完整提示。下面的现象可以帮助定位环节,不应仅凭“空白”两个字就删除整个订阅。
- 等待后超时:优先检查当前网络能否访问订阅域名,不能据此断定链接已经过期。
- 很快出现解析异常:可能已收到响应,但响应是登录页、错误页或不受支持的内容。
- 刷新完成但目标分组为空:检查服务商是否实际返回了服务器条目,以及本地显示状态。
- 条目存在但连接失败:已经进入服务器连接问题,不再是单纯的订阅解析问题。
本文的界面定位以 iPhone / iPad 上的 Home、Config、Settings 为例。Mac、Windows、安卓与 Linux 上同样可以按“请求、响应、解析、显示”定位问题,但不要把移动端的下拉手势当作桌面端必须存在的操作;应从目标订阅的操作菜单执行更新。
二、核对完整链接:不要把管理页面当作订阅地址
回到自己服务商的订阅管理页面,重新使用其复制订阅地址的功能。复制后只在本机查看内容,核对地址开头、域名、路径及查询参数是否完整。浏览器地址栏中的账户首页、订单页和登录页通常不是客户端需要读取的订阅端点。
https://example.com/sub?token=xxxx
上面只是用于辨认结构的假值,不可用于导入。真实地址中的 token 等字段可能相当于访问凭据;不能因为看起来像随机字符就删掉。也不要把其他服务商的参数名套用到自己的链接。
- 检查首尾是否多出空格、换行、引号或中文标点。聊天软件显示的换行不一定属于链接,实际粘贴后再确认。
- 确认
https://没有被截断;路径大小写、?后的参数以及&分隔符均保持原样。 - 如果文本中出现字面量
&,回到原页面重新复制,不要未经确认就批量替换或解码整条地址。 - 服务商提供多种导出格式时,选择其明确标注适用于 Shadowrocket 的订阅输出,不要把网页分享地址或整份 Config 文件地址直接当作同类内容。
三、检查服务商响应:状态码与空内容分别处理
浏览器能打开某个页面,不等于该地址能作为订阅使用。登录后的浏览器可能持有 Cookie,而订阅请求未必具有同一登录状态;服务端也可能返回验证页面。即使 HTTP 状态为 200,正文仍可能是 HTML,而不是客户端能够解析的服务器数据。
以下卡片列出的是标准 HTTP 响应原文,用于解释你在错误详情或服务商反馈中看到的状态,并不表示 Shadowrocket 一定会逐字显示这些提示。
HTTP 401 Unauthorized
原因与解法:请求缺少有效身份凭据,或凭据已失效。回服务商页面重新复制有效订阅地址,确认账户状态后,再更新目标订阅。
HTTP 403 Forbidden
原因与解法:服务器拒绝当前请求,可能涉及账户权限、来源限制或访问策略。记录时间与网络类型交给自己的服务商确认,不要把修改客户端规则当作解除服务端权限限制的方法。
HTTP 429 Too Many Requests
原因与解法:请求触发了频率限制。停止连续刷新;如果响应带有 Retry-After,按其指示等待,否则按服务商公布的刷新间隔重试。
HTTP 503 Service Unavailable
原因与解法:服务端暂时不能处理请求。先查看自己的服务商维护说明,稍后再试;重复删除和添加本地订阅不能修复服务端故障。
判断:先确认正文类型,再调整本地设置
若服务商确认响应是登录页、验证页或空内容,应先由服务商修正订阅输出;在本地切换协议或重排规则,不能把这些响应变成服务器条目。
四、选择更新时机:保留旧条目,一次完成一个验证
修改账户套餐、重置订阅凭据或服务商调整条目后,管理页面和订阅端点的结果可能不是同时变化。此时连续点击更新既难以判断结果,也可能触发频率限制。按照服务商说明等待,并把“最近一次尝试时间”与“最近一次确认成功时间”分开记录。
- 保留现场:记录原订阅名称、当前条目数和报错。若旧节点仍可用,先不要删除整个分组,也不要清空应用数据。
- 确认新地址生效:若刚重置凭据,确保本地订阅地址已经替换;保留旧地址反复刷新只会重复得到失败结果。
- 只更新目标订阅:在 Home 找到对应订阅并执行更新;使用下拉刷新时,留意实际触发了哪些订阅请求,避免把另一条订阅的结果混入判断。
- 等待完成再比较:核对该分组是否出现条目、数量是否变化、错误是否相同。一次操作结束后再改下一个条件。
不要把“反复重新导入”当成默认修复步骤。它可能创建重名分组,使旧条目和新条目同时存在,也会掩盖究竟是哪一次更新成功。如果确实需要重建记录,应先确认有效链接已经保存,并明确知道要移除的是哪一个订阅分组。
五、切换网络验证:把订阅请求与节点连接分开
订阅地址的可访问性与某个节点的可连接性是两项不同条件。节点能连接,不保证订阅域名可以访问;反过来,订阅更新成功也不保证每个节点都能建立连接。测试时先固定同一条订阅链接,再只改变 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 来修复无效内容;是否需要调整某条网络路径,应以实际请求结果为依据。
- 遇到证书或 TLS 错误,先检查系统日期、时间与服务商域名状态,不要关闭证书验证来掩盖问题。
- 公共 Wi-Fi 可能需要先在浏览器完成网络认证;认证页面不是订阅响应。
- 截图和记录必须来自自己的测试。未执行测试时,不要把“换网络后一定成功”当作结论。
六、节点仍为空:先核对条目,再整理反馈
如果目标分组已经展开,更新也没有网络错误,但仍然没有服务器条目,请服务商确认该订阅当前是否确实包含可导出的节点。账户到期、套餐未生效、服务端筛选条件或输出异常,都可能导致内容为空;具体原因需要由服务商根据账户和响应判断。
协议名称相同也不意味着每一份输出都能直接导入。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的连接参数各不相同。不要只把条目开头的协议名替换成另一种协议,也不要凭空补写端口;应取得服务商为 Shadowrocket 提供的有效输出。
- 提供现象:是超时、解析提示,还是更新后目标分组为零;附上遮住凭据的错误截图。
- 提供环境:设备平台、系统信息、Wi-Fi 或蜂窝网络,以及是否在另一网络复现。
- 提供时间:最近一次正常更新的时间、故障出现时间及所在时区,便于服务商对照日志。
- 明确问题:请对方核对 HTTP 状态、是否重定向到登录页、响应格式及实际条目数量,而不只是询问“是不是客户端坏了”。
七、订阅更新常见问答
同一条链接在浏览器有内容,为什么导入还是失败?
先分辨内容是服务器数据还是网页。若看到登录表单、验证提示或账户面板,就不能据此认定订阅正常。不要把网页源码整段粘进 Home;请自己的服务商确认客户端实际能取得的订阅输出。
我是不是先把旧订阅删掉,再加一次就能好?
先不要删除。记下目标分组和报错,核对原地址是否仍有效,再执行一次更新。只有确认记录填错或确实需要重建时才删除对应分组,避免连同仍可使用的旧条目一起移除。
刚更新完却没有新节点,要一直下拉吗?
不用连续刷新。先确认服务商管理页是否已经有新条目,再按其刷新间隔等待;若出现 429,应停止尝试。等待后仍为空,把时间、目标分组和网络测试结果交给服务商核对。
已经有节点但网页打不开,也属于解析失败吗?
不属于同一阶段。先确认 Home 中选中的服务器,再检查 Global Routing 当前姿态和连接结果;使用 Config 时,还要核对实际启用的配置。订阅条目已经出现后,继续重复导入通常不能解决服务器连接或规则匹配问题。
获取 Shadowrocket 与查看导入教程
iPhone / iPad 版 App Store $2.99 一次性付费,Mac(Apple 芯片 / Intel)/ Windows / 安卓 / Linux 版免费,共 2 档获取。iPhone / iPad 系统要求以 App Store 页面标注为准。前往下载页选择对应设备,或查看首次导入与连接步骤。