本文面向已有服务商与订阅链接的用户。先区分下载失败、内容无法解析与解析后没有可用条目,再核对链接、账号状态、更新时机和访问路径。排查期间保留原订阅与已有连接,确认新链接能返回有效列表后再替换,避免删除唯一可用的连接。
先区分:请求失败、解析失败,还是列表被隐藏
Shadowrocket(小火箭)的订阅更新不是单一步骤。应用先访问订阅地址,服务端返回内容,应用再识别内容并生成 Home 中的条目。任意一环失败,都可能表现为“导入后没有节点”,但处理方法不同。连接开关是否开启,也不能单独证明订阅地址可以访问。
先回到 Home,清除搜索条件,并展开对应订阅分组。若条目实际存在,只是连接测试失败,应检查连接参数与线路状态,而不是反复删除订阅。若列表确实为空,再观察更新时的提示,确认是未收到内容,还是收到内容后无法识别。
- 一直等待后超时:优先检查网络路径、域名解析和服务端响应。
- 立即提示解析问题:优先检查是否复制了网页地址,或服务端返回了不兼容的内容。
- 更新结束但没有条目:检查服务商是否返回空列表,以及 Home 的分组和搜索状态。
- 已有条目但无法连接:转查协议、端口、认证信息与本地网络,不把它等同于订阅下载失败。
第一步:检查链接是否完整、类型是否正确
订阅链接从你的服务商处获取。应使用服务商明确标注适用于 Shadowrocket 的订阅地址,而不是账号中心、套餐详情页或浏览器登录后的页面地址。以下是假值示例,只用于说明 URL 的组成,不是可用订阅。
https://example.com/sub?token=xxxx
这里的 https:// 是协议,example.com 是域名,/sub 是路径,token=xxxx 是查询参数。真实链接的路径与参数名可能不同,不应照着示例修改。尤其不要删除问号后面的内容,也不要把订阅地址误填为某个服务器的 Address 或 Port。
- 从服务商页面重新复制完整订阅链接,检查开头和结尾是否夹带空格、换行、引号或中文标点。
- 核对链接里的
&是否被复制成字面文本&;后者可能改变参数含义。应重新复制原始地址,不要盲目全局替换。 - 若拿到的是
ss://、vmess://或vless://开头的单条分享链接,按单条服务器信息处理,不把它当作 HTTPS 订阅地址。 - 在 Home 的 Add Server 中选择订阅对应的类型;订阅类型通常显示为 Subscribe。粘贴到 URL 字段,保存后执行该订阅的更新操作。
第二步:确认服务商返回的是订阅内容
链接能在浏览器打开,不等于它返回了可解析的订阅。浏览器可能展示登录页、验证页或提示文字;应用需要的是对应格式的订阅内容。即使响应状态为 200,正文若是 HTML 页面,仍然可能解析失败。不要仅凭“页面能打开”就排除服务端问题。
若更新提示或诊断记录包含以下 HTTP 状态行,可按对应方向处理。这些是服务端可能返回的标准响应,不表示每个平台都会逐字显示相同的错误文案。
HTTP 401 Unauthorized
原因与解法:服务端未接受当前凭据。先到自己的服务商页面确认订阅权限,再重新复制当前有效链接,避免继续使用已重置的 token。
HTTP 403 Forbidden
原因与解法:服务端拒绝当前请求,可能涉及访问策略或验证要求。记录发生时间和所用网络,向自己的服务商确认限制条件,不通过反复重试猜测原因。
HTTP 429 Too Many Requests
原因与解法:请求触发了频率限制。停止手动连刷;如响应提供 Retry-After,按其指示等待,否则按服务商说明选择下一次更新时间。
列表为空还可能是账号权限未生效、可下发条目被服务商清空,或选择了不适用的订阅格式。进入自己的服务商页面核对账号状态与可用条目,再确认应复制哪一种格式。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的字段并不相同,把 Type 改成另一个名称不会自动转换协议内容。
结论:先确认响应内容,再修改客户端设置
若同一地址返回登录页、错误提示或空列表,应先处理服务端状态;修改 Global Routing 或连接端口不能把这些内容变成有效订阅。
第三步:按状态选择更新时机
重置订阅链接、变更账号权限或服务商调整列表后,旧地址与旧内容可能不再适用。更新前先确认服务商页面已经显示预期状态,再复制新链接。不要把购买、续期或重置操作后的等待过程,误判为客户端必然需要重新安装。
- 首次导入:保存条目后主动执行一次订阅更新,观察是否生成服务器列表,而不是只看订阅名称是否出现。
- 重置链接后:编辑原订阅的 URL 或新增一个可辨认的测试订阅,使用新的完整链接。旧 token 不会因为刷新而自动恢复。
- 权限刚变更:先核对服务商页面是否已生效;若仍为空,按服务商说明等待,不虚设统一的生效分钟数。
- 自动更新未发生:回到 Home 手动更新一次,记录结果。后台执行受到系统调度与当时网络条件影响,不能把自动更新理解为固定时刻必定完成。
每次测试只改变一个条件,并记下“使用哪个链接、哪种网络、是否开启连接、出现什么提示”。这样可以区分链接替换带来的变化与网络切换带来的变化。连续点击更新既难以定位问题,也可能触发限流。
第四步:分开测试订阅请求与代理连接
订阅服务器与实际代理服务器可以使用不同域名、端口和访问路径。某个已有条目能够连接,并不代表订阅域名一定能访问;反过来,订阅成功也不保证返回的每个条目都可用。测试时先完成“能否下载列表”的判断,再做连接测试。
- 本地网络对照:先在当前 Wi-Fi 更新一次,再切换到蜂窝网络测试。记录网络差异,避免同时更改 URL 和协议参数。
- 连接状态对照:如果手中仍有可用连接,可在开启连接后测试更新,再与关闭连接的结果比较。是否实际经过代理,还取决于订阅更新选项与当前转发设置。
- HTTPS 排查:检查设备日期与时间是否正确。若服务端证书异常,应交由服务商处理,不以关闭证书验证作为常规修复办法。
- 登录网络排查:公共 Wi-Fi 需要先完成网络登录。验证页面尚未通过时,订阅请求可能被引导至网页,而不是收到预期内容。
Home → Global Routing 下的 Proxy、Direct、Config、Scene 属于转发姿态,不是订阅内容格式。Config 依赖当前配置规则,Scene 依赖已设置的场景行为。Settings → On Demand 管理按条件连接,也不会自动修复错误 URL、过期 token 或空响应。排查期间应记录原设置,测试结束后恢复所需状态。
重新导入:先验证新条目,再清理旧条目
重新导入适合用于排除旧 URL、误选类型或条目保存错误,不是所有订阅故障的通用解法。删除订阅可能同时移除其下服务器;如果它们仍承担当前连接,应先保留,避免排查过程中失去访问路径。
- 记录原订阅名称与必要设置,妥善保存自己的有效链接。不要把含凭据的备份放到公开位置。
- 从自己的服务商重新获取适用链接,在 Home → Add Server 选择 Subscribe,将完整地址填入 URL。
- 使用与旧条目不同的备注,例如“订阅复查”,保存后对该订阅执行更新。
- 展开新分组,确认至少能看到预期的服务器条目。再核对条目的协议类型和服务商给出的端口,不把 HTTPS 订阅常用的 443 端口直接套给所有代理服务器。
- 选择一个条目进行连接测试,确认实际访问符合预期;最后再删除重复或失效订阅,保留需要的 Config 与策略引用。
若新旧订阅使用同一地址,在同一网络都返回空列表,重复新增通常不会改变结果。此时整理响应提示、测试时间、网络类型与是否重置过链接,联系自己的服务商核对。提交截图前遮住 token、UUID、密码等认证信息。
订阅为空与更新失败的常见问题
浏览器能打开订阅,为什么导入仍然失败?
先看打开后是订阅内容还是登录、验证、错误页面。浏览器已有的登录状态不一定能被应用请求复用。回到自己的服务商页面复制适用于 Shadowrocket 的订阅地址,不复制账号中心的网址。
更新成功但没有节点,要不要先删掉重装?
先清除 Home 搜索条件、展开订阅分组,再核对服务商账号下是否确有可下发条目。确认链接和响应后再新增测试订阅。重装不会改变服务端返回的空内容,还可能丢失本地配置。
节点还在,但订阅一直更新失败,旧节点能继续用吗?
已有条目能否使用取决于服务器与认证信息是否仍有效,更新失败不等于它们立刻失效。先保留旧条目并测试连接,同时单独排查订阅地址,不急着清空列表。
把 Global Routing 改成 Proxy 就一定能更新吗?
不一定。还要看是否已有可用连接,以及订阅更新请求采用的路径。先做相同 URL 的连接开关对照;若问题是失效 token、错误内容或服务端空列表,改变姿态不能修复。