· 订阅管理 · 约 8 分钟

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

讲清订阅的手动刷新入口与打开应用时自动更新的设置位置,并逐条排查链接失效、网络不通、格式不识别等更新失败原因。

本文速览

本文面向已经持有自己的服务商订阅链接的用户。先在 Home 对目标订阅执行手动更新，再到 Settings → Subscribe 检查打开应用时自动更新的选项；遇到失败时，按链接、网络、返回内容三个层次定位。更新完成后，还需要单独验证服务器连通性，不能把“订阅刷新成功”当成“连接已经可用”。

订阅更新会改变哪些内容

Shadowrocket（小火箭）的订阅更新，是重新请求已保存的订阅 URL，并解析返回的服务器配置。它不是更新应用本身，也不等同于刷新 Config 中的规则文件。本文只说明用户已有订阅的管理方法，不提供、销售或推荐订阅及相关服务。

更新可能增加服务器、移除旧条目，或改变地址、端口与连接参数。手工修改订阅条目后，后续刷新可能重新载入远端参数，因此重要调整应先记录。若原来选中的条目被移除，还要重新检查 Home 中的选择，不能只看总条目数。

Home
检查订阅分组、更新结果与当前服务器
Settings → Subscribe
检查订阅自动更新与请求路径设置
Config
管理配置文件与规则，不等同于服务器订阅

结论：先确认更新对象

如果目的是更新服务器列表，操作 Home 中的订阅；如果目的是修改 DOMAIN-SUFFIX、GEOIP、IP-CIDR 或 FINAL 的匹配行为，应检查 Config 中正在使用的配置。不要通过反复刷新服务器订阅来修复规则顺序。

在 Home 手动更新订阅

首次导入后、服务端通知配置已调整后，或自动更新结果不明确时，先做一次目标明确的手动更新。存在多个订阅时，分别处理并记录结果，避免把另一组的成功提示误认为当前订阅已恢复。

  1. 确认分组

    打开 Home，找到需要刷新的订阅分组。先核对备注和所属条目，确认它是已导入的订阅，而不是单独手工添加的服务器。

  2. 核对链接

    查看该订阅的编辑信息，确认 URL 完整。若需要重新添加，路径为 Home → + → Type → Subscribe，填入自己的订阅 URL 后保存。排错时优先保留原记录，不要一开始就删除。

  3. 执行更新

    在 Home 对订阅分组标题行向左滑动，选择 Update。注意操作订阅行，而非分组内的单个服务器行；后者的操作对象不同。等待本次请求结束，不要连续触发刷新。

  4. 检查结果

    查看是否有失败提示，并核对分组中预期的地址、端口或条目变化。列表没有变化不一定是失败：远端返回相同内容时，刷新后也可能保持原样。

  5. 验证连接

    在 Home 重新确认选中的服务器，再运行 Connectivity Test。若需要实际连接测试，确认连接开关及系统 VPN 授权；订阅请求完成本身不代表数据连接已建立。

打开应用时自动更新怎么设置

进入 Settings → Subscribe，找到控制打开应用时更新订阅的选项 Update on Open，按需开启。界面大小写与排列以当前安装版本为准。开启后应返回 Home 观察下一次打开应用时的结果，而不是仅根据开关位置判断更新已经执行。

打开时更新属于触发条件，不是固定间隔的后台任务。它不承诺在应用未打开时持续刷新，也不保证每次切换前后台都会立即完成一次请求。网络可达、链接有效、返回内容可解析，仍然是成功更新的必要条件。

若开启后仍不确定是否刷新，先让自己的服务商确认远端确实有可识别的配置变化，再对照 Home。单纯看到数量相同，无法证明自动更新没有运行；同样，数量变多也不能证明每个条目都能连接。

更新超时：先检查请求经过哪里

订阅 URL 可否访问，与列表里的服务器能否连接是两件事。直接网络可能访问不了订阅域名，而已有连接可以访问；反过来，当前选中的服务器失效，也可能让经过代理的订阅请求失败。

检查项操作位置判断方法
当前网络设备 Wi-Fi 或蜂窝网络设置只切换网络，再更新同一订阅；结果改变说明需继续检查网络路径。
已有连接Home → Connectivity Test先验证当前服务器；不能依赖一个已失效的连接去取得替代配置。
代理更新Settings → Subscribe → Update via Proxy已有连接可用但直接请求失败时，可开启后重试，并比较结果。
路由姿态Home → Global Routing记录当前是 Config、Proxy、Direct 还是 Scene，避免把路由切换和刷新设置同时修改。

Update via Proxy 不是通用修复开关。启用前，应先选中可用服务器并建立连接；若当前只能直接访问订阅地址，则应测试关闭该选项后的结果。Global Routing 下的 Proxy 表示代理姿态，Direct 表示直接连接，Config 按配置处理，Scene 按所设场景工作；这些选择不等于“自动更新已开启”。

建议每次只改一项：记录原值，手动刷新一次，保留结果，再做下一步。不要同时切换网络、服务器与多个开关，否则即使更新恢复，也无法判断真正生效的条件。

按错误信息区分失败原因

下面列出网络层或 HTTP 响应中可能出现的错误原文。实际提示语言与展示方式可能不同，应记录设备上显示的完整信息，不要求每次都出现相同句子。只凭“更新失败”四个字，无法判断是链接失效还是连接中断。

报错：The request timed out.

原因与解法：请求在等待期限内未完成，可能涉及网络、DNS 或远端响应。先切换 Wi-Fi 与蜂窝网络重试；若已有可用连接，再比较 Settings → Subscribe → Update via Proxy 开关前后的结果，超时本身不证明订阅已过期。

报错：A server with the specified hostname could not be found.

原因与解法：订阅域名未能解析。核对 URL 中的主机名是否完整、有无空格或多余标点，再更换网络测试；仍失败时，让自己的服务商确认该域名是否仍在使用。

报错：HTTP 401 Unauthorized

原因与解法：服务器要求有效授权。确认复制的是当前完整订阅 URL，而不是登录页面地址；若授权参数已被重置，从自己的账户页面重新取得链接并更新保存值。

报错：HTTP 403 Forbidden

原因与解法：服务器拒绝了本次请求，可能与授权、访问限制或账户状态有关。先核对完整链接，再向自己的服务商提供状态码和发生条件；不要仅凭 403 断定必须更换协议。

报错：HTTP 404 Not Found

原因与解法：请求路径没有对应资源。检查是否截断路径或漏掉查询参数，并确认订阅入口是否已更换；同一错误链接反复刷新通常不会改变结果。

若看到证书相关错误，应检查设备日期与时间、订阅域名及当前网络是否存在登录拦截，再让自己的服务商核查证书。不要通过忽略安全校验来掩盖原因。公共网络要求登录时，应先完成系统中的网络登录，再返回应用重试。

链接能打开，为什么仍然无法解析

HTTP 请求成功并不意味着返回内容就是可用订阅。服务器可能返回账户登录页、到期提示页或网络验证页；这些页面即使能正常显示，也不是 Shadowrocket 可以导入的服务器列表。

以下地址仅展示结构，不是可用订阅。实际链接中的查询参数属于凭证的一部分，复制时必须完整保留，也不应发送到公开群组或不明转换页面。

https://example.com/sub?token=xxxx

更新后的验证与常见问题

完成刷新后，依次核对分组、选中服务器、Connectivity Test 与实际访问。规则导致的访问结果，应回到 Config 检查；服务器认证或传输失败，应核对该条目的参数。将这些层次分开，可以避免把连接故障误判成订阅故障。

订阅显示成功，为什么服务器数量没变？

远端可能只修改地址、端口或认证参数，也可能没有任何变化。对照自己预期发生变化的条目，而不是只比较数量；若仍有疑问，让自己的服务商确认该 URL 当前返回的内容。

开启自动更新后，还需要手动刷新吗？

排查时需要。先在 Home 对目标订阅执行 Update，确认链接和网络工作正常，再回到 Settings → Subscribe 检查 Update on Open。这样能区分请求失败与自动触发条件未满足。

刷新后原来选中的服务器不见了怎么办？

先核对是否仍在正确的订阅分组内，再从本次更新保留的条目中重新选择服务器并运行 Connectivity Test。不要假设原条目的选择状态会在远端删除或重命名后继续有效。

需要把完整订阅链接发给别人排错吗？

通常先提供错误原文、网络类型、手动更新结果，以及 Update via Proxy 的状态即可。隐藏 URL 的路径凭证、查询参数、密码和账户信息；若完整链接已经泄露，应在自己的账户中重置后重新保存。

需要继续检查连接设置时，可查看设置手册。Shadowrocket 是 Apple 平台的闭源商业应用，以 iPhone、iPad 使用为主，唯一获取入口是 App Store。客户端一次性买断不等于线路套餐；价格、系统要求及购买适用性以 App Store 页面标注为准。

App Store 正版核对