本文速览

本文适合已经从自己的服务商处获取订阅链接的用户。先在 Home 手动下拉更新,再检查 Settings → Subscribe → Update on Open。遇到失败时,按链接有效性、网络请求、返回格式三个环节定位。更新成功后,还要分别确认服务器列表、默认选择与实际连接,不能仅凭刷新动画判断结果。

订阅更新会改变什么

Shadowrocket(小火箭)的 Subscribe 记录保存订阅地址。更新时,客户端请求这个地址,读取服务商返回的服务器数据,再更新对应分组。它不是给应用安装更新,也不等于给服务套餐续期。本文的操作路径以 iPhone / iPad 界面为例,其他平台应按实际界面核对对应项目。

读取订阅地址 请求远端内容 解析服务器数据 更新所属分组 核对连接结果

Home 中的服务器列表、Config 中的规则配置和 Settings 中的应用设置属于不同层级。订阅更新成功,通常只能说明这次服务器数据获取与解析完成,不能据此断定 Config 内的规则文件也已更新。单独添加的服务器也不会因为另一条订阅刷新而自动变成该订阅的一部分。

3 个位置
Home 查看列表,Config 管理配置,Settings 调整更新行为
2 种触发
手动下拉与 Update on Open,分别验证
3 层检查
链接有效性、网络可达性、返回格式

在 Home 手动下拉更新

排查时先进行一次手动更新。这样可以明确触发时间,也便于把屏幕上的错误与这次请求对应起来。不要在第一次失败后立即删除整个分组;先保留原有记录与错误信息,避免同时丢失正在使用的服务器选择。

  1. 核对订阅

    进入 Home,找到需要更新的 Subscribe 记录。进入该记录的编辑界面,确认 Type 为 Subscribe,并核对 URL 是否仍是服务商当前提供的地址。

  2. 补建记录

    如果只有手动添加的服务器而没有订阅记录,在 Home 右上角点「+」,将 Type 设为 Subscribe,在 URL 中粘贴自己的订阅链接并保存。已有记录则跳过这一步。

  3. 下拉更新

    返回 Home,在列表顶部向下拖动并松手,等待本轮更新结束。存在多条订阅时,逐条核对结果,不要把其中一条成功理解为全部成功。

  4. 核对内容

    查看目标订阅下的服务器名称与条目变化。列表没有变化可能是远端内容未变;出现明确错误时,记录错误原文,而不是仅记录“更新不了”。

  5. 验证连接

    重新确认默认服务器的圆点标记,按需要连接,再运行 Connectivity Test。列表获取成功与服务器可连接是两项独立结果。

设置打开时自动更新

在 Settings → Subscribe → Update on Open 开启打开时更新。之后正常打开应用,检查是否触发了订阅刷新。不同平台的设置排列可能不同,应核对同名选项;不要在 Config 中寻找这个开关。

Settings → On Demand 管理的是按条件连接的行为,不是订阅更新计划。不要为了让订阅自动刷新而反复改动 On Demand。若手动更新正常、打开时更新异常,先复核 Update on Open 是否保持开启,再记录应用打开时的网络状态。

先看错误原文,再决定处理顺序

同样是“更新失败”,原因可能处于不同阶段。下列卡片列出常见错误文本或 HTTP 状态。具体显示可能由系统和服务端决定;应以本次屏幕上出现的完整内容为依据,不要把所有失败都归为链接过期。

报错:Failed to load subscription

原因与解法:这是订阅加载失败的概括提示,不能单独确定是过期还是格式问题;先核对完整 URL,再检查同次请求是否有更具体的网络或 HTTP 错误。

报错:The request timed out.

原因与解法:请求未在允许时间内完成,可能涉及本地网络、远端响应或当前请求路径;先确认普通网络访问正常,再用同一地址切换 Wi-Fi 与蜂窝网络各测试一次。

响应状态:HTTP 401

原因与解法:服务端要求有效身份信息,地址中的令牌可能缺失、失效或已被重置;从自己的服务商处重新取得当前订阅链接,完整替换 URL 后重试。

响应状态:HTTP 403

原因与解法:服务端拒绝本次请求,可能与账户权限或访问策略有关;向自己的服务商提交状态码与发生时间,不能仅凭此状态认定套餐到期。

响应状态:HTTP 429

原因与解法:请求频率触发服务端限制;停止连续下拉,按服务商提示等待后再试,若响应包含 Retry-After,则按其指示等待。

排查时一次只改变一个条件。例如先保持订阅地址不变,只切换本地网络;下一轮再保持网络不变,替换为服务商重新提供的地址。否则,即使恢复成功,也难以判断究竟是哪项修改起效。

链接过期、网络不可达与格式不识别

链接有效性:检查完整 URL 与账户状态

订阅 URL 中的令牌通常参与身份验证。复制时漏掉问号后的参数、多出空格或换行,都可能使请求失效。服务商重置链接后,旧地址也可能立即失效。应从服务商处确认链接是否仍有效,同时核对账户是否有权获取该订阅内容。

网络可达性:区分解析、连接与证书

HTTPS 订阅地址未显式指定端口时,通常连接 TCP 443。域名解析失败、连接超时、TLS 证书验证失败属于不同问题。设备能打开其他网页,只能证明部分网络访问正常,不能证明订阅域名也可达。

Home → Global Routing 下的 Proxy、Direct、Config、Scene 影响连接与分流姿态,但不应机械套用为每次订阅请求的固定路径。Proxy 与 Direct 的切换还会改变其他应用的流量路径。排查时记录当前姿态和 VPN 状态,不要为了刷新而长期改为另一种姿态。

格式不识别:成功响应不等于可导入

服务器返回 HTTP 200,只能说明 HTTP 请求成功,不能保证响应体是有效订阅。返回内容可能是登录页面、维护通知或空正文。可识别的订阅内容也可能因字段缺失或协议参数不完整而无法形成可用条目。

观察到的现象优先核对下一步
响应是 HTML 页面是否返回登录或验证页面向服务商确认供 Shadowrocket 使用的订阅地址
响应为空或列表为空账户是否分配了服务器数据请服务商核对响应内容,不直接删除原分组
部分条目无法导入对应协议与必需字段是否完整提交脱敏后的错误与协议类型,不自行猜测参数
名称与数量没有变化远端是否实际发布了变化先确认请求成功,再向服务商核对预期内容

更新成功后仍不能连接的检查

更新成功不代表每台服务器都可连接。原条目被远端删除或替换后,应重新核对默认服务器。对于 VMess、VLESS、Trojan 等记录,地址、端口、UUID 或密码、传输方式与 TLS 参数应由服务商数据决定,不能为消除错误而随意补写。

  1. 在 Home 确认选中的是更新后的目标服务器,而不是同名的手动记录。
  2. 打开连接后运行 Connectivity Test,区分“订阅能获取”和“服务器可连接”。
  3. 若测试可用但某个域名异常,再查看 Global Routing 的当前姿态及 Config 中的规则命中情况。
  4. 检查 DOMAIN-SUFFIX、IP-CIDR、GEOIP 与 FINAL 等规则时,只调整与目标问题有关的项目,不把规则修改当作订阅格式修复。

向服务商反馈时,提供发生时间、使用的本地网络、错误原文、手动更新结果与打开时更新结果。订阅 URL 中的令牌、UUID 和密码均应遮盖。不要将完整链接发布到公开截图或评论中;若已经泄露,应从服务商处重置链接,再更新客户端内的 URL。