本文速览

本文适用于已经持有自己服务商订阅链接的用户。先在 Home 确认订阅分组,再手动刷新;需要在打开应用时检查更新,可到 Settings → Subscribe 查看 Update on Open。更新失败时依次检查链接、请求网络和返回格式。更新订阅只刷新连接条目,不等于更新 Config 中的规则,也不等于续期服务。

订阅更新改动什么,哪些内容不会随之更新

Shadowrocket(小火箭)中的订阅,是应用通过一个地址获取服务器条目的方式。服务商调整地址、端口或其他连接参数后,应用需要重新请求订阅,才能取得新的内容。手动添加的独立条目与订阅分组不是同一个数据来源,不能因为它们显示在同一页,就认为刷新会同时改写所有条目。

先区分 Home、Config 和 Settings 的用途。Home 用于查看和选择连接条目;Config 用于管理配置文件;Settings 用于调整应用行为。本文讨论的是 Home 中订阅条目的刷新,不是 Config 中远程配置文件的更新。

Home
确认订阅分组与更新后的连接条目
Config
管理配置文件与分流规则
Settings
在 Subscribe 中设置订阅更新行为

例如,配置中的 DOMAIN-SUFFIX,example.com,DIRECT 是一条域名后缀规则。刷新服务器订阅不会自动把这条规则改成其他策略。服务有效期、剩余用量也由用户已有的服务商决定;刷新动作本身不会增加配额或延长有效期。

手动更新:从 Home 刷新并核对结果

首次导入后、服务商通知连接参数调整后,或发现条目明显过时时,先手动更新一次。操作前记下当前选择的条目名称。暂时不要删除原订阅,以免在请求失败时失去原有资料。

  1. 确认分组

    打开 Home,找到自己的订阅分组。若列表只有手动添加的条目,先核对是否已经导入订阅;没有订阅来源的独立条目不能通过订阅刷新取得新参数。

  2. 核对地址

    在订阅条目的编辑页检查 URL 是否完整。首次添加可从 Home 右上角「+」进入,将 Type 设为 Subscribe,再填写自己的订阅 URL 并保存。不要把服务商登录页面地址当作订阅地址。

  3. 下拉刷新

    回到 Home,在列表顶部向下拉动并释放,触发订阅刷新。等待本次请求结束后再操作;列表较长时先滚回顶部,避免把普通列表滚动误认为刷新。

  4. 检查结果

    查看是否出现错误提示,再核对分组中的条目名称和数量。若服务商明确通知某条目已改名或移除,可用该项变化作对照;列表未变化本身不能证明更新失败。

  5. 验证连接

    重新确认当前选择的条目,连接后测试自己需要访问的目标。刷新成功说明数据获取与解析完成,不能单独证明每个服务器都可用。

订阅地址属于敏感资料

地址中的 token 可能具有访问凭据作用。向自己的服务商反馈时使用其私密支持渠道;对外展示截图或错误记录前,遮盖完整 URL、token、密码和个人标识。

打开时自动更新:Update on Open 的触发范围

进入 Settings → Subscribe,查看 Update on Open。启用后,应用会在打开时按该设置触发订阅更新。它不代表系统会在应用长期未打开时持续轮询,也不代表只要 VPN 保持连接,订阅就会按固定分钟数刷新。

Update on Open 和 Update via Proxy 处理的是不同问题。前者决定何时发起更新,后者决定更新请求是否使用代理路径。开启自动更新之前,应先让同一订阅手动更新成功,避免把地址错误误判为自动触发失效。

反复快速切换应用不是可靠的诊断方法。网络请求需要时间,也可能遇到服务商访问频率限制。一次只改一个设置,等待请求结束,再比较结果,才能确认是哪项调整起了作用。

先查请求路径,再判断是否需要 Update via Proxy

订阅更新可以拆成四个阶段。只有取得可识别的内容后,应用才有数据可写入列表。因此,“网页能打开”“VPN 已连接”和“订阅刷新成功”是三个不同的判断条件。

读取订阅地址 建立网络连接 获取返回内容 解析条目数据 更新本地列表

先确认当前 Wi-Fi 或蜂窝网络可以正常联网,且没有等待登录的网络认证页面。若订阅域名在当前网络无法直接访问,而已有连接确实可用,再尝试 Settings → Subscribe → Update via Proxy,并回 Home 手动刷新比较结果。

切换 Wi-Fi 与蜂窝网络适合用作对照测试。若同一地址只在一种网络下失败,优先检查该网络的访问条件;若不同网络都返回相同的授权错误,应回到链接和服务状态本身排查。

更新失败:按超时、授权、地址和格式分别处理

错误可能出现在提示框或相关请求记录中,显示形式会随系统语言和响应来源不同而变化。下面列出的是网络请求可能返回的英文错误原文或 HTTP 状态行,不保证每次都以完全相同的提示框出现。反馈时应保留自己实际看到的文字。

The request timed out.

原因:请求在等待期限内没有完成,可能与当前网络、访问路径或服务端响应有关。

解法:先切换一次网络重试;若已有代理连接可用,再比较 Update via Proxy 开关前后的结果,不要连续快速刷新。

401 Unauthorized

原因:服务端未接受本次请求的身份凭据,订阅 token 可能已失效或被重置。

解法:从自己的服务商处重新核对订阅地址,完整替换后重试;仅切换网络不能修复失效凭据。

403 Forbidden

原因:服务端拒绝访问,可能涉及账号状态、访问策略或请求来源限制。

解法:向自己的服务商确认订阅访问条件,并提供已遮盖敏感信息的错误记录;不要据此直接认定客户端解析异常。

404 Not Found

原因:服务端没有找到该请求地址对应的资源,常见于路径不完整或入口已变更。

解法:核对链接路径与查询参数,重新复制自己的完整订阅地址,避免手动拼接或删除参数。

如果没有上述网络错误,但更新后没有可用条目,应检查返回内容是否为应用支持的订阅格式。登录页、到期提示页或网络认证页虽然可能成功返回,却不是服务器列表。浏览器能显示页面,只能说明拿到了某些内容,不能证明该内容可用于 Subscribe。

更新后的常见问题与验收方法

更新完成后,分别检查数据是否取得、列表是否符合预期、选中条目是否可连接。不要用一次网页访问失败,反推整个订阅请求一定失败。以下问题可用于把故障范围进一步缩小。

显示更新完成,但条目一个都没变,是没刷新吗?

不一定。远端内容没有变更时,本地列表可以保持不变。先确认本次没有错误提示,再用服务商已经明确变更的条目作对照;不要为了让数量变化而重复删除和导入。

打开时自动更新开着,为什么还要手动刷新?

手动刷新用于主动获取当前内容,也便于立即观察错误。Update on Open 只规定触发时机,不保证网络请求一定完成。出现异常时回 Home 下拉刷新,记录结果再排查。

更新后原来选中的条目不见了,怎么处理?

先检查它是否被远端移除或改名。重新选择当前分组中仍有效的条目,再测试连接。不要把订阅生成的旧条目视为永久保留项;如需手动维护,应明确区分其数据来源。

更新成功但还是连不上,下一步查什么?

确认 Home 当前选中项,再检查连接状态与 Global Routing。使用 Config 姿态时继续核对匹配规则和策略;订阅更新不会自动修复错误的规则选择。可到常见问题页按连接故障继续排查。

完成排查后,保留成功使用的更新路径,并记下故障发生时的网络类型、实际提示和已尝试的操作。需要进一步帮助时,这些信息比“刷新不了”更容易定位问题。连接故障可继续阅读常见问题中的排查说明。

客户端购买与订阅服务分开核对

客户端买断 ≠ 线路套餐。Shadowrocket 是闭源商业应用,仅在 Apple 平台通过 App Store 获取,主要用于 iPhone 与 iPad。开发者为 Shadow Launch Technology Limited,应用 ID 为 932747118。价格、系统要求与通用购买适用范围以 App Store 页面标注为准。本文仅说明如何管理用户自己已有的订阅资料。