2026-08-09 · 入门指南 · 约 8 分钟

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

说明在 Home 列表里手动更新订阅、开启打开时自动更新的位置,以及链接失效、网络受限导致更新失败的常见原因。

本文速览

本文适用于已经持有自己服务商订阅的 Shadowrocket(小火箭)用户。先在 Home 对单个订阅执行手动更新,确认链接能返回有效配置,再设置打开时自动更新;遇到失败时,按网络可达性、链接权限、返回内容逐项检查。更新服务器列表不等于更新 Config,也不等于延长服务有效期。

一、分清订阅更新与连接测试

订阅链接是读取服务器配置的入口。执行更新时,Shadowrocket 向该地址请求内容,解析其中的服务器参数,再更新 Home 中对应的订阅分组。请求能否完成,取决于订阅地址、当前网络以及服务商返回的内容;列表中某个服务器能否连接,则是另一项检查。

读取链接 请求内容 解析配置 更新列表 核对连接

不要用延迟测试代替订阅更新。延迟测试读取的是已有服务器信息,不会自动取得服务商新增或替换的服务器。反过来,即使更新成功,仍可能出现某台服务器不可用、账户额度用尽或服务期限结束的情况。

Home
检查订阅分组与服务器列表
Settings
设置订阅更新行为
Config
管理规则配置,区别于订阅列表

先明确准备更新的对象。如果目标是服务商的服务器列表,操作 Home 中的订阅;如果目标是规则文件,则检查 Config 中对应配置的来源。两者可能分别维护,更新其中一个不能证明另一个也已更新。

二、在 Home 手动更新已有订阅

先保持当前列表,不要以删除订阅作为第一步。删除后再导入会增加重新选择服务器、核对分组和恢复配置的工作,也可能丢失排查时需要对照的旧信息。首次操作时只更新一个订阅,便于确认结果来自哪条链接。

  1. 定位订阅

    打开 Home,找到自己的订阅分组。核对分组名称与其中已有服务器,避免把单独添加的服务器条目误认为订阅入口。

  2. 调出操作

    在 Home 的订阅分组标题处调出操作菜单,选择 Update。可先长按分组标题;若当前界面通过左滑显示操作按钮,则在订阅分组行左滑后选择更新操作,不要在单个服务器行执行 Delete。

  3. 等待完成

    保持应用在前台,等待请求结束。不要连续触发多次更新。若出现错误,记录完整提示及发生时间,再进行下一项检查。

  4. 核对列表

    检查分组是否仍在、条目能否展开,以及服务商已明确通知变更的服务器是否出现。若内容没有变化,先确认远端是否确实提供了新内容。

  5. 复测连接

    确认当前选中的服务器仍然有效,再连接并访问同一个测试页面。把“更新是否成功”和“服务器是否可用”分别记录,避免把两个结果混为一谈。

三、开启打开时自动更新

先完成一次手动更新,再设置自动更新。这样可以先确认订阅链接有效,避免每次打开应用都重复触发同一个错误。打开时自动更新属于订阅管理行为,不是连接开关,也不是规则模式。

  1. 进入设置

    打开 Settings → Subscribe,查找 Update On Open。以当前安装版本实际显示的订阅设置为准,不要到 Config 中修改规则来代替该开关。

  2. 开启选项

    启用 Update On Open。若页面还提供更新间隔等条件,同时核对其说明;是否实际发起请求,应结合这些条件判断。

  3. 返回核对

    在网络可用时重新打开应用,回到 Home 观察更新反馈。若要立即确认某条订阅,仍可手动执行一次 Update,不必依赖自动触发时机。

不要把 Update On Open 理解为固定周期的后台任务。离开应用、锁屏或仅看到系统 VPN 状态,并不能证明订阅持续在后台更新。从后台回到前台时,也不应只凭动作本身推定已完成一次请求。

  • Update On Open:控制打开应用时的订阅更新行为,仍受网络和相关更新条件影响。
  • Settings → On Demand:用于按需连接相关配置,不负责替换订阅中的服务器列表。
  • Global Routing:包含 Proxy、Direct、Config、Scene 等选择,用于控制流量处理方式,不是订阅刷新频率设置。

四、按错误提示区分链接与网络问题

更新失败时,先保存错误文字,再判断失败发生在哪一层。以下是可能遇到的请求错误或 HTTP 状态示例,实际提示可能随系统语言、网络层及服务商响应不同而变化。不要为了消除提示,反复删除并重新导入同一条链接。

报错:The request timed out.

原因与解法:请求未在允许时间内完成,可能是网络中断、地址不可达或远端响应过慢。先确认普通网页可以打开,再在另一个可信网络中对同一订阅重试,比较结果。

报错:Could not connect to the server.

原因与解法:连接目标服务器失败,可能涉及远端服务、网络限制或连接路径。核对订阅域名是否抄写完整,再向自己的服务商确认订阅入口当前是否可用。

报错:HTTP 401 Unauthorized

原因与解法:远端拒绝了当前请求的身份凭据。回到自己的服务商账户核对订阅权限和当前链接,确认链接是否已被重置,不要自行猜测或拼接 token。

报错:HTTP 403 Forbidden

原因与解法:服务器收到请求但拒绝访问,可能涉及权限、访问来源或防护策略。记录发生时间与所用网络,请服务商核对限制条件;单凭 403 不能判断一定是到期。

链接被重置后,旧链接可能不再有效。应从自己的服务商账户重新复制当前订阅地址,替换对应订阅的 URL,再手动更新。复制时检查首尾空格、换行以及查询参数是否完整,不要只保留域名。

五、请求成功但列表异常的核对顺序

网络请求成功不代表返回内容一定是有效订阅。远端可能返回登录页面、验证页面或账户状态提示。即使 HTTP 状态为 200,正文也可能是 HTML,而非 Shadowrocket 能解析的服务器配置。此时继续切换服务器通常不能修复解析问题。

观察到的现象 优先核对 下一步
更新结束,条目没有变化 远端内容是否真的变更 对照服务商通知中的具体条目,不以数量变化判断结果。
提示解析失败或没有可用条目 地址是否为订阅入口,是否返回网页 从自己的账户重新复制适用于 Shadowrocket 的订阅地址。
列表正常,连接仍然失败 当前服务器、服务期限与账户额度 将连接故障与订阅请求分开,向服务商核对该服务器状态。
一种网络失败,另一种成功 网络认证、域名解析与访问限制 保留同一订阅与同一设置,比较网络差异,不同时修改多个变量。

协议名称也不能作为更新成功的保证。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 描述的是不同的连接配置;订阅请求负责取得这些配置,并不会自动修正错误的端口、密码、UUID 或 TLS 参数。若服务商给出的内容本身有误,应先核对来源。

  • 遇到公共 Wi-Fi,先完成网络要求的登录或使用确认,再更新订阅。
  • 怀疑 DNS 时,先观察订阅域名能否解析;不要直接把域名换成 IP,HTTPS 证书与服务端路由可能依赖原域名。
  • 遇到证书验证错误,核对设备日期、时间与网络环境,不以关闭证书校验作为常规解决办法。
  • 不要通过添加 DOMAIN-SUFFIX 或修改 FINAL 来处理已经失效的链接;规则不能恢复远端权限。

六、更新后保留哪些核对记录

每次排查只改变一个条件。先使用同一链接测试不同网络,再核对链接权限,最后检查返回内容。若同时更换订阅、调整 DNS、切换 Global Routing 并删除旧配置,即使恢复正常,也很难确认是哪项操作起了作用。

  1. 记录对象:保留订阅分组名称,不记录完整 token,也不把服务器密码作为故障描述发送。
  2. 记录环境:注明使用 Wi-Fi 还是蜂窝网络,以及普通网页是否能够访问。
  3. 记录结果:区分更新错误、列表变化和连接错误,保留完整错误文字及发生时间。
  4. 记录改动:写明只修改了哪一项设置;未改善时恢复原值,再测试下一项。

Shadowrocket 是 Apple 平台的闭源商业应用,主要用于 iPhone 与 iPad,唯一获取入口是 App Store。核对开发者 Shadow Launch Technology Limited 与应用 ID 932747118;系统要求以 App Store 页面标注为准。客户端一次性买断不等于线路套餐,也不会替代已有服务商的订阅授权。

需要检查连接故障时,继续阅读站内问题诊断;需要区分 Subscribe、Config 与 Global Routing 时,查看名词解释。先确认一次手动更新能够完成,再启用打开时自动更新,后续维护会更容易定位问题。

App Store 正版核对