Shadowrocket(小火箭)订阅更新失败时,先保留已有记录,手动刷新一次并记录提示,再依次检查链接、网络路径与返回格式。本文以用户已有自己的服务商与订阅为前提,说明 Home 的刷新操作、Settings → Subscribe 的自动更新设置,以及如何区分“订阅未更新”和“节点无法连接”。以下路径以 iPhone / iPad 界面为操作基准,其他平台的入口位置可能有所差异。
先区分订阅更新与连接测试
订阅更新是向订阅地址发起请求,取得内容后解析为服务器记录;连接测试则使用某条记录中的地址、端口与协议参数建立连接。这是两条不同的检查链路。已有节点能够连接,不代表订阅地址仍然有效;订阅刷新成功,也不代表列表中的每条节点都能连接。
Home 显示的是服务器记录与连接状态,Config 主要管理规则配置文件。不要把 Config 中某个远程配置的更新,当成 Home 中服务器订阅的更新。排查前先确认失败对象,避免为了修复订阅而替换整个规则文件。
在 Home 手动更新订阅
第一次排查应采用手动更新,便于直接观察提示。不要先删除订阅:已有记录可能仍可用于连接,删除后若无法重新获取,反而会失去可用的测试条件。先记下订阅分组名称、当前记录数量和错误提示,再执行以下操作。
-
确认分组
打开 Home,找到需要更新的订阅分组。若已有多个订阅,先明确本次检查哪一组,不要把另一个分组的变化当作更新成功。
-
检查链接
进入该订阅的编辑界面,核对 URL 是否完整。初次添加时,路径是 Home → 右上角“+”→ Type → Subscribe;已有记录优先编辑,不要重复创建。
-
下拉刷新
回到 Home,在列表顶部下拉并释放,触发订阅刷新。等待本轮请求结束,再读取成功或失败提示;连续下拉可能增加限流概率。
-
核对结果
查看目标分组是否仍有记录、名称与数量是否符合预期。若提示成功但数量不变,可能只是远端内容没有变化,不应仅凭数量判断失败。
如果更新后列表变空,先停止重复刷新。记录当时提示,并向自己的服务商确认订阅是否确实返回了空列表、是否调整了可用记录范围。重新添加相同链接不会修复远端内容问题。
设置打开时自动更新
进入 Settings → Subscribe,找到 Update on Open 并启用。该设置用于在打开应用时尝试更新订阅,适合已经确认手动更新正常的情况。打开后先离开应用,再重新进入,观察更新结果;仅切换 Home 与 Config 页面,不应作为验证自动更新的唯一依据。
- 先手动、后自动:手动刷新仍报错时,先排查请求失败原因;自动更新不会补全失效链接,也不会修复错误的返回内容。
- 自动不等于定时:Update on Open 不表示应用关闭后持续在后台定时请求。系统后台调度、网络状态与应用运行状态都会影响实际执行。
- 代理路径单独设置:Settings → Subscribe → Update via Proxy 控制更新请求是否尝试经代理发送,与 Update on Open 的触发时机不是同一个设置。
- 按需连接另行检查:Settings → On Demand 管理按条件连接的行为,不负责修复订阅 URL,也不是订阅更新计时器。
若只有重新打开应用时失败,而停留几秒后手动刷新成功,优先检查刚切换 Wi-Fi 或移动网络时是否尚未完成联网。可临时关闭 Update on Open,等网络稳定后手动复测,以区分启动时机问题与链接本身的问题。
按错误提示检查链接与访问权限
错误文字可能因系统语言、网络层和服务端响应而不同。以下是常见错误文本或状态码的含义,并不表示每次失败都会出现完全相同的整句提示。记录原始文本比只记录“更新不了”更有助于定位。
报错:The request timed out.
原因:请求未在等待时间内完成,可能涉及链路不通、远端响应缓慢或代理路径不可用。
解法:先切换 Wi-Fi 与移动网络复测,再分别检查直连与 Update via Proxy 路径,每次只改一项。
报错:A server with the specified hostname could not be found.
原因:订阅域名未能解析,可能是域名拼写错误、DNS 异常或原域名已停用。
解法:核对完整域名,换网络重试;若持续失败,向自己的服务商确认当前订阅域名。
状态码:HTTP 403
原因:服务器拒绝访问,可能与链接令牌、账号权限或请求来源限制有关。
解法:在自己的服务账户中核对订阅状态与最新链接,不要把反复重装客户端作为处理步骤。
状态码:HTTP 429
原因:服务端限制了短时间内的请求频率,多设备同时自动刷新也可能触发限制。
解法:停止连续刷新,按服务端给出的等待时间再试,并减少其他设备的重复请求。
订阅链接通常带有账户凭证。核对时注意问号后的参数是否完整、是否混入空格或换行,以及链接是否被聊天软件截断。下面仅用于识别结构,不是可用订阅地址;分享排错信息时也应隐藏实际 token。
https://example.com/sub?token=xxxx
网络不通时检查更新请求路径
普通网页可以打开,并不能证明订阅域名可访问。不同域名可能使用不同的解析结果、访问限制或网络路径。先保持原设置,用另一种接入网络刷新同一订阅;如果只在某个网络失败,优先检查该网络,而不是立即修改所有节点参数。
- 记录 Settings → Subscribe → Update via Proxy 的当前状态,然后在现有状态下刷新一次,保留结果。
- 如果直连失败、已有节点仍可连接,先在 Home 选择一条已确认可用的记录并连接,再开启 Update via Proxy 复测。
- 如果经代理更新失败,则关闭 Update via Proxy,以直连方式复测。不要默认“经代理”一定比直连更容易成功。
- 核对 Global Routing 当前是 Proxy、Direct、Config 还是 Scene,并记录本次测试姿态。不要只凭连接开关已打开,就认定所有请求都经过代理。
- 若遇到证书或安全连接错误,检查设备日期、时间和时区是否正确;不要通过忽略证书错误来绕过验证。
使用 Config 时,规则可能影响请求最终走向。不要为测试订阅而随意加入大范围 DIRECT 或 PROXY 规则。先用少量、可恢复的设置变化确认问题所在,再决定是否调整配置。
返回成功但解析失败:核对内容格式
HTTP 请求成功只说明拿到了响应,不保证响应就是有效订阅。远端可能返回登录页面、权限说明、验证页面或空文本,这些内容有时同样使用 HTTP 200。此时持续点击更新不会把网页转换成服务器列表。
| 观察现象 | 优先核对 | 处理顺序 |
|---|---|---|
| 请求结束后提示解析失败 | 链接是否为客户端订阅,而不是账户管理网页 | 从自己的服务账户重新复制对应订阅链接,再编辑原记录。 |
| 此前正常,格式调整后失败 | 服务端是否更换输出格式或加入不受支持的字段 | 向服务商说明使用 Shadowrocket,并提供脱敏错误文本确认兼容格式。 |
| 更新成功但记录减少 | 远端是否删除记录、调整账户权限或返回空列表 | 先核对账户状态和远端内容,不要直接归因于本地解析错误。 |
| 列表正常但节点连接失败 | 节点地址、端口、协议参数与有效状态 | 转入连接排查,不再反复更新同一份列表。 |
不要尝试把错误页面整体复制进 Add Server。Shadowsocks、VMess、VLESS、Trojan 等记录各有对应字段,订阅解析与手动填写属于不同操作。需要人工处理时,应取得自己的服务商提供的明确参数,而不是根据网页文字猜测协议或端口。
常见问题与排查记录
为什么更新失败,旧节点却还能用?
订阅地址与节点地址不是同一个请求目标。保留旧记录,在 Home 测试已有连接,再单独检查订阅 URL 的权限和网络路径;不要先删除整个分组。
开了自动更新,怎么还是旧列表?
先到 Home 手动下拉刷新并读取提示,再核对 Settings → Subscribe → Update on Open。若请求成功但列表未变化,需确认服务端是否确实发布了不同内容,名称和数量不变本身不能证明自动更新失效。
换手机后,复制原链接就一定能更新吗?
不一定。链接可能已重置,也可能受账户权限或请求频率限制。在自己的服务账户中确认链接仍有效,再通过 Home → “+”→ Type → Subscribe 添加;不要向公开讨论区发送带 token 的完整地址。
失败后需要重装 Shadowrocket 吗?
先不重装。保存配置与订阅记录,完成换网络、核对链接、切换更新路径三项测试。只有明确定位为本地应用状态异常时,才考虑进一步处理;重装不会改变服务端拒绝访问的结果。
向自己的服务商反馈时,建议提供失败时间与时区、接入网络、错误原文、是否开启 Update via Proxy,以及换网络后的结果。涉及账户与链接的信息应通过其私密支持渠道提交。本站不提供、不销售、不推荐节点、订阅、连接服务,仅说明客户端设置与排查方法。