Shadowrocket 订阅更新教程:手动更新、打开时自动更新与更新失败原因

讲清订阅在 Home 页的手动更新入口、打开时自动更新开关的作用,以及链接过期、网络不通、格式变化导致更新失败的排查顺序。

本文速览

已添加订阅却看不到新条目时,先在 Home 手动刷新,再检查 Settings → Subscribe 中的 Update On Open。本文以 iPhone / iPad 的英文界面为步骤基准,适合已有服务商和订阅链接的用户;其他平台按同名功能核对。读完可区分链接失效、网络访问失败与内容解析失败,并判断更新后为什么仍然无法连接。

先区分更新对象

Shadowrocket(小火箭)的订阅更新,是重新请求已保存的订阅地址,把返回内容解析为连接条目,再同步到对应订阅分组。它不是更新应用程序,也不是给线路套餐续期。订阅链接从你的服务商处获取;客户端买断 ≠ 线路套餐,客户端的获取费用不会改变服务商账户的流量、期限或连接权限。

Home 展示连接条目与订阅分组;Config 管理配置文件及其规则;Settings 管理应用设置。本文讨论 Home 中连接订阅的刷新,不把 Config 中配置文件的远程更新当作同一操作。刷新连接订阅通常不会替你修改 Config 中的 DOMAIN-SUFFIX、IP-CIDR 或 FINAL 规则。

2 种
更新触发:Home 手动刷新、Update On Open
3 类
排查对象:订阅地址、访问网络、返回内容
443
HTTPS 未显式指定端口时的默认端口

订阅地址、连接服务器地址与配置文件地址也不能互换。订阅地址用于拉取条目;连接服务器地址和端口用于实际建立连接。即使二者都使用 443,也不代表访问的是同一台服务器。订阅刷新成功,只能说明本次拉取与解析完成,不能证明每个连接条目都可用。

在 Home 手动更新

第一次排查建议手动触发,便于记录触发时间、提示内容与条目变化。先确认 Home 中存在带有订阅来源的分组:只有单独手填的服务器,而没有订阅地址时,下拉不会凭空生成新的订阅内容。不要因为刷新无变化就重复导入同一链接,否则会增加判断分组来源的难度。

  1. 确认分组

    进入 Home,找到需要更新的订阅分组。若尚未添加,使用 Home 右上角“+”→ Type → Subscribe,填写从你的服务商处获取的订阅地址并保存。

  2. 核对地址

    在该订阅的编辑信息中检查 URL,确认完整保留协议、路径和查询参数。不要把服务商账户的网页登录地址当成订阅地址,也不要把复制时附带的空格或换行留在链接中。

  3. 下拉刷新

    回到 Home,将列表滚动到顶部后下拉并松开,等待刷新结束。此操作可能更新多个已保存订阅,因此应重点观察目标分组,不要只看列表总条目数。

  4. 检查结果

    记录错误提示,或核对服务商明确告知有变动的条目。若名称、数量与原来相同,先确认服务商是否实际更改了内容;相同结果不等于更新失败。

示例地址 https://example.com/sub?token=xxxx 仅用于识别结构,不能作为实际订阅使用。其中 token 属于访问凭据的一部分,不能只保留域名后再尝试刷新。分享排查信息时,应遮住完整查询参数、账户信息和连接凭据,不要公开订阅原文。

打开时自动更新

在 Settings → Subscribe 中找到 Update On Open 并开启后,应用会在打开时按该功能的触发逻辑尝试刷新订阅。它适合希望在使用前获取最新条目的情况,但不等于按分钟定时刷新,也不保证应用关闭后持续运行。系统后台调度、当前网络和服务端响应仍然会影响结果。

Update On Open 与 Settings → On Demand 不是同一个设置。前者用于订阅刷新,后者用于满足条件时触发 VPN 连接。开启 On Demand 不会自动修复订阅下载失败;关闭它也不是更新订阅的必要步骤。排查时只改变与当前问题有关的一项设置,才能判断变化来自哪里。

理解刷新处理流程

触发更新 请求订阅地址 接收响应 解析条目 同步分组

“请求订阅地址”阶段需要完成域名解析、建立连接,以及 HTTPS 地址所需的 TLS 协商。域名解析失败、网络不可达或证书校验失败,都会使后续解析没有机会发生。此时更换 Home 中某个连接条目的协议参数,通常不是针对订阅请求本身的修复。

“接收响应”完成后还要检查内容。HTTP 200 仅表示服务器返回了成功响应,不保证正文是可识别的订阅;服务商登录页、网页验证页或空正文也可能被正常下载。相反,HTTP 401、403、404 已经提供了访问权限或路径方面的线索,应先核对链接,而不是立即改 DNS。

结论:先定位失败阶段

超时先检查网络与可达性;401、403、404 先核对服务商链接;请求成功却没有条目,再检查返回内容与订阅格式。按阶段处理,避免同时修改网络、配置和订阅三个变量。

按提示排查失败

下面列出常见的英文网络错误或 HTTP 状态。具体提示的语言和呈现方式可能随系统与界面而不同,应保留实际原文。单条提示只能缩小范围,不能独立证明账户过期或服务器故障。

报错:The request timed out.

原因:请求未在等待期限内完成,可能涉及当前网络、访问路径或订阅服务器响应。

解法:先停止连续刷新,分别在可用的 Wi-Fi 与蜂窝网络下重试一次;若只有一个网络失败,优先检查该网络的解析与访问限制。

报错:Could not connect to the server.

原因:客户端无法与目标服务建立连接,地址、端口、网络可达性或服务端状态均可能相关。

解法:核对 URL 的域名与显式端口是否完整,再向你的服务商确认订阅服务是否可访问,不要自行猜测替代域名。

状态:HTTP 401 Unauthorized

原因:订阅服务器拒绝当前请求的身份凭据,常见于 token 无效或需要重新授权。

解法:从你的服务商处获取当前有效的完整链接,替换原订阅 URL 后再刷新,不要只修改参数中的几个字符。

状态:HTTP 403 Forbidden

原因:服务器拒绝访问,可能涉及账户状态、来源限制或请求频率,不能仅凭此状态判定订阅过期。

解法:暂停高频重试,向你的服务商核对权限与访问限制,并提供已脱敏的错误状态及发生时间。

状态:HTTP 404 Not Found

原因:服务器没有提供所请求的路径,可能是复制不完整或原订阅路径已更换。

解法:重新获取完整订阅链接,核对路径与查询参数;不要把首页地址拼接成订阅地址。

遇到证书相关错误时,先确认设备日期与时间正确,再核对域名是否与服务商提供的一致。不要通过关闭证书校验来掩盖问题。若其他 HTTPS 服务可访问而只有该订阅失败,应将域名和错误提示反馈给你的服务商,确认其证书与服务状态。

格式变化与空列表

如果网络请求能够完成,却出现解析失败、空分组或条目明显缺失,应检查订阅内容是否变了。服务商可能调整输出格式、替换订阅路径,或者在原路径返回账户提示页面。网页能打开不代表正文符合 Shadowrocket 的订阅格式;不要把一个可浏览的 HTML 页面再次当作连接订阅导入。

观察现象优先核对下一步
提示成功,条目不变服务商是否真的发布了变化核对一个已知改名或新增的条目,不以总数作为唯一依据。
返回登录页或验证页是否复制了账户网页地址从你的服务商处获取供客户端使用的订阅链接。
原来可用,现在解析失败服务商是否更换格式或路径确认当前适用的订阅输出,保留原分组信息后再修改 URL。
只有部分条目缺失服务商是否删除条目或改变字段提供脱敏后的差异描述,请服务商检查输出,不手动猜填凭据。

不要把“删除订阅再添加”当作首要步骤。删除会丢失现有分组这个对照对象,也可能影响当前所选条目。先记下订阅名称、错误原文和变化情况,再决定是否替换地址;若确需重新添加,确认新分组已成功生成并能使用后,再整理重复条目。

更新后的连接检查

刷新完成后仍然无法访问网页,需要把订阅问题与连接问题分开。Home 中显示的新条目可能尚未被选中;原先选中的条目也可能已被服务商移除。先选择当前订阅中仍然存在的条目,完成连接与实际访问测试,再排查 DNS 或规则,不要只依赖延迟结果。

  1. 核对当前选择:在 Home 确认当前连接条目属于已更新的目标订阅,而不是同名的旧分组。
  2. 核对路由姿态:检查 Global Routing。Config 按配置规则处理请求,Proxy 与 Direct 用于不同的整体路由选择;刷新订阅本身不会替你切换这些姿态。
  3. 核对实际访问:用自己原本需要访问的服务验证。延迟测试有结果,不代表 DNS、TLS 与页面请求全部成功。
  4. 准备反馈信息:记录网络类型、发生时间、错误原文及失败阶段;隐藏 token、密码与完整订阅地址后再联系你的服务商。

日常使用时,可保留 Update On Open 作为获取变更的便利设置,并在服务商通知调整后手动刷新一次。若更新频繁失败,按“地址是否有效、网络是否可达、返回内容是否可解析”的顺序检查,比反复重装应用更有针对性。Shadowrocket 不提供、不销售、不推荐节点或订阅;本文所有操作均以用户已有自己的服务商与订阅为前提。

下载 Shadowrocket