本文适合已经拥有自己的服务商与订阅链接、需要刷新服务器列表的用户。先在 Home 手动刷新，确认链接能够正常返回数据，再到 Settings → Subscribe 设置打开时更新；如果失败，按访问权限、网络路径、响应格式的顺序处理。更新订阅、更新 Config 与更新应用是不同操作，不能互相替代。
订阅更新会改变什么
Shadowrocket（小火箭）保存订阅地址后，会从该地址获取服务器信息。后续刷新仍然访问这个地址，并根据返回内容更新列表中的服务器、连接参数等信息。因此，列表没有新增项目不一定表示更新失败：服务商返回的内容可能与上次相同。
以下操作应分开判断，避免在错误的位置反复刷新。本文以 iPhone / iPad 的 Home、Settings 页面操作为主；其他平台的布局可能不同，排查网络请求与订阅响应的顺序仍然适用。
| 操作对象 | 操作目的 | 不能替代的操作 |
|---|---|---|
| Home 中的订阅 | 重新获取服务器列表与连接参数。 | 不能续期服务商账户，也不等于更新规则。 |
| Config 中的配置 | 管理配置文件及其中的规则、DNS 等设置。 | 不等于刷新 Home 的订阅列表。 |
| Shadowrocket 应用 | 更新客户端程序本身。 | 不会自动使已经失效的订阅地址恢复有效。 |
在 Home 手动刷新订阅
先做一次手动更新，确认地址与网络都有效，再开启自动更新。不要先删除原订阅：已有服务器可能仍能使用，删除后若新地址无法访问，就会同时失去可供排查的旧记录。
-
核对订阅
打开 Home，找到自己的订阅分组，确认不是仅有一个手动添加的服务器。手动填写的单条服务器信息没有可供刷新列表的订阅地址。
-
补充地址
尚未添加订阅时，进入 Home → 右上角「+」→ Type → Subscribe，在 URL 填入自己的完整订阅链接，填写便于辨认的名称后保存。
-
下拉刷新
回到 Home 的服务器列表，在列表顶部下拉并松手，等待更新结束。列表较长时先滚到顶部；不要把下拉通知中心当成应用内刷新。
-
检查结果
观察是否出现错误提示，再核对目标订阅中的服务器名称与数量。若有多个订阅，应分别查看目标分组，不能只凭其中一个分组有变化判断全部更新成功。
-
验证连接
选择更新后的服务器并测试连接。若更换了服务器或连接参数，断开后重新连接再验证网页访问，避免把原有连接的表现当成新参数的结果。
订阅地址通常带有账户凭据。例如 https://example.com/sub?token=xxxx 只是不可用于获取服务的假值示例。实际复制时要保留完整查询参数，不能漏掉问号后的内容，也不要把地址两侧的引号、空格或聊天软件附加文字一起粘贴进去。
设置打开时自动更新
打开时自动更新适合希望进入应用后获取最新列表的用户。它由应用打开这一时机触发，不代表系统会在应用关闭后持续、定时访问订阅，也不保证网络不可用时一定刷新成功。
-
进入设置
打开 Settings → Subscribe，找到 Update on Open。界面语言不同会影响显示文字，应在订阅设置中辨认对应的打开时更新开关。
-
开启更新
启用 Update on Open，返回 Home。这个开关只改变更新触发方式，不会替换 URL，也不会修复已经过期的账户凭据。
-
重新打开
在网络可用时重新打开应用，留意刷新结果。仅切换应用内的 Home 与 Settings 页面不能作为“重新打开后一定触发”的验证方法。
-
保留手动检查
服务商通知列表已调整、而当前列表未变化时，仍可回 Home 下拉刷新。出现错误时先记录提示，不要连续快速重试。
Settings → On Demand 管理的是按条件建立 VPN 连接，不是订阅定时任务。开启 On Demand 不等于开启 Update on Open；同样，自动更新成功也不代表 VPN 已经连接。应分别检查订阅刷新结果与 Home 的连接状态。
更新经代理还是直连
订阅地址能否访问，与列表里的服务器是否可连接是两件事。某个服务器可以正常使用，不代表订阅网站当前可达；订阅可以下载，也不代表返回的每个服务器都可连接。先辨认失败发生在哪一步，再决定是否改变请求路径。
| 检查项 | 用途 | 操作判断 |
|---|---|---|
| Settings → Subscribe → Update via Proxy | 控制订阅更新是否经代理请求。 | 直连访问失败且已有可用代理时，可启用后重试。 |
| Home → Global Routing | 选择 Proxy、Direct、Config 或 Scene 等路由姿态。 | 记录原设置；不要为了刷新订阅长期改变日常路由。 |
| Settings → On Demand | 按设定条件触发 VPN 连接。 | 排查断开状态下的直连时，留意它是否重新建立了连接。 |
若当前网络无法直接访问订阅地址，可先使用仍可连接的已有服务器，建立连接后，在 Settings → Subscribe 启用 Update via Proxy，再返回 Home 刷新。若已有服务器全部不可用，就不能把“经代理更新”当成可用的修复路径；此时应换一个可信的网络，或向自己的服务商确认地址是否可以直接访问。
- 每次只改一个变量：先更换 Wi-Fi 与蜂窝网络，或只切换 Update via Proxy，再刷新比较结果。
- 公共 Wi-Fi 需要先完成网络登录。尚未认证时，请求可能被带到登录页，而不是得到订阅数据。
- 验证结束后恢复原有 Global Routing 设置，不必为一次更新一直停留在 Proxy。
按错误提示定位原因
错误文字可能来自应用、系统网络层或订阅服务器，语言和具体表述会有所不同。下面列出可见的典型提示与 HTTP 状态，应用时应以实际提示为准；不要只根据“更新失败”四个字判断账户已经到期。
报错：The request timed out.
原因与解法：请求未在允许时间内完成，可能是网络路径不通或服务器响应过慢。先切换网络重试一次；若已有可用连接，再比较启用 Update via Proxy 后的结果，避免连续刷新增加请求压力。
报错：A server with the specified hostname could not be found.
原因与解法：订阅域名未能解析。检查 URL 的主机名是否复制完整，确认当前网络能正常解析其他域名，再向自己的服务商核对订阅域名是否已经调整。
报错：401 Unauthorized
原因与解法：服务器没有接受当前请求凭据。到自己的服务商账户中确认链接是否已重置，重新复制完整 URL；不要只更换链接中的域名而沿用旧 token。
报错：403 Forbidden
原因与解法：服务器拒绝了请求，可能涉及账户权限或访问限制。核对服务状态，并把状态码和发生时间提供给自己的服务商；反复切换规则不能消除服务端的权限限制。
报错：404 Not Found
原因与解法：当前路径未找到资源，可能是链接路径被截断或原地址已撤销。重新获取完整订阅地址，不要把账户登录页地址当成订阅 URL。
报错：429 Too Many Requests
原因与解法：请求次数触发了服务器限制。停止反复下拉，等待服务端允许的重试时间；若响应带有 Retry-After，应按该要求等待，再执行一次更新。
证书校验错误应单独处理：先检查设备日期与时间是否准确，再换可信网络验证，并让自己的服务商检查证书有效期和域名匹配情况。不要通过关闭证书验证来掩盖问题，否则无法可靠确认订阅响应来自预期服务器。
格式错误与列表未变化
网络请求成功不等于订阅解析成功。HTTP 200 只说明服务器成功返回了响应，响应正文仍可能是账户登录页、访问验证页面、到期提示或空内容。这类情况应检查返回内容的类型，而不是继续修改 Global Routing。
- 返回网页：如果地址打开后要求登录，或展示完整网页，确认复制的是订阅链接而不是账户页面。浏览器能登录账户，也不等于应用的订阅请求已经获得访问权限。
- 返回空内容：向自己的服务商确认该账户是否有可用条目，以及当前地址是否应返回数据。不要在没有备份的情况下删除旧分组再反复导入。
- 格式无法解析：使用服务商明确提供给 Shadowrocket 的订阅格式。不要仅凭文件扩展名判断兼容性，也不要擅自把网页正文转换后再次导入。
- 只有部分条目：核对缺失条目的协议及参数是否被当前客户端支持。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的字段不同，不能只修改协议名称来转换连接信息。
- 更新后数量不变：比较服务器名称和参数是否改变。数量相同不表示内容相同；内容本来没有变动时，也不需要人为制造新增条目验证更新。
订阅更新常见问题
开了自动更新，为什么列表还是旧的？
先在 Home 下拉刷新并观察错误提示，再检查 Settings → Subscribe → Update on Open。若手动刷新也失败，应处理地址或网络问题；若手动成功但内容相同，向自己的服务商确认源列表是否确实发生了变化。
更新成功了，为什么网页还是打不开？
更新成功只证明列表获取与解析完成。回 Home 选择可用服务器，重新连接，并检查 Global Routing；若使用 Config，再检查对应配置的 DNS、规则和 FINAL 策略。不要把网页故障直接当成订阅故障。
每次更新都要重新导入链接吗？
不需要。订阅地址仍然有效时，在 Home 刷新即可。只有自己的服务商更换了地址、重置了凭据或撤销了旧链接时，才需要编辑订阅地址；重复添加同一链接容易产生多个难以区分的分组。
买了客户端，为什么订阅还是提示到期？
客户端买断 ≠ 线路套餐。iPhone / iPad 版在 App Store $2.99 一次性购买，Mac、Windows、安卓、Linux 版免费；这些获取方式都不会续期自己的服务商账户。订阅权限和有效期需向自己的服务商确认。
完成排查后，建议记录成功时使用的网络类型、Update via Proxy 状态以及是否启用了 Update on Open。下次更新失败时，先与这组已知可用条件比较，通常比同时修改 DNS、路由模式和订阅地址更容易定位问题。本站不提供、不销售、不推荐节点、订阅、连接服务。