本文适用于已经持有自己服务商订阅链接的用户。先在 Home 确认订阅分组,再手动刷新;需要在打开应用时检查更新,可到 Settings → Subscribe 查看 Update on Open。更新失败时依次检查链接、请求网络和返回格式。更新订阅只刷新连接条目,不等于更新 Config 中的规则,也不等于续期服务。
订阅更新改动什么,哪些内容不会随之更新
Shadowrocket(小火箭)中的订阅,是应用通过一个地址获取服务器条目的方式。服务商调整地址、端口或其他连接参数后,应用需要重新请求订阅,才能取得新的内容。手动添加的独立条目与订阅分组不是同一个数据来源,不能因为它们显示在同一页,就认为刷新会同时改写所有条目。
先区分 Home、Config 和 Settings 的用途。Home 用于查看和选择连接条目;Config 用于管理配置文件;Settings 用于调整应用行为。本文讨论的是 Home 中订阅条目的刷新,不是 Config 中远程配置文件的更新。
例如,配置中的 DOMAIN-SUFFIX,example.com,DIRECT 是一条域名后缀规则。刷新服务器订阅不会自动把这条规则改成其他策略。服务有效期、剩余用量也由用户已有的服务商决定;刷新动作本身不会增加配额或延长有效期。
手动更新:从 Home 刷新并核对结果
首次导入后、服务商通知连接参数调整后,或发现条目明显过时时,先手动更新一次。操作前记下当前选择的条目名称。暂时不要删除原订阅,以免在请求失败时失去原有资料。
-
确认分组
打开 Home,找到自己的订阅分组。若列表只有手动添加的条目,先核对是否已经导入订阅;没有订阅来源的独立条目不能通过订阅刷新取得新参数。
-
核对地址
在订阅条目的编辑页检查 URL 是否完整。首次添加可从 Home 右上角「+」进入,将 Type 设为 Subscribe,再填写自己的订阅 URL 并保存。不要把服务商登录页面地址当作订阅地址。
-
下拉刷新
回到 Home,在列表顶部向下拉动并释放,触发订阅刷新。等待本次请求结束后再操作;列表较长时先滚回顶部,避免把普通列表滚动误认为刷新。
-
检查结果
查看是否出现错误提示,再核对分组中的条目名称和数量。若服务商明确通知某条目已改名或移除,可用该项变化作对照;列表未变化本身不能证明更新失败。
-
验证连接
重新确认当前选择的条目,连接后测试自己需要访问的目标。刷新成功说明数据获取与解析完成,不能单独证明每个服务器都可用。
订阅地址属于敏感资料地址中的 token 可能具有访问凭据作用。向自己的服务商反馈时使用其私密支持渠道;对外展示截图或错误记录前,遮盖完整 URL、token、密码和个人标识。
打开时自动更新:Update on Open 的触发范围
进入 Settings → Subscribe,查看 Update on Open。启用后,应用会在打开时按该设置触发订阅更新。它不代表系统会在应用长期未打开时持续轮询,也不代表只要 VPN 保持连接,订阅就会按固定分钟数刷新。
Update on Open 和 Update via Proxy 处理的是不同问题。前者决定何时发起更新,后者决定更新请求是否使用代理路径。开启自动更新之前,应先让同一订阅手动更新成功,避免把地址错误误判为自动触发失效。
- 设置路径:Settings → Subscribe → Update on Open,用于控制打开应用时的更新行为。
- 网络路径:Settings → Subscribe → Update via Proxy,用于调整订阅请求的访问路径,不负责修复过期链接。
- 观察方法:启用后,在下次打开应用时查看请求结果;不要仅以后台隧道仍连接来判断是否已刷新。
- 失败后处理:自动更新失败时,回 Home 手动刷新一次,记录具体提示,再按后文顺序排查。
反复快速切换应用不是可靠的诊断方法。网络请求需要时间,也可能遇到服务商访问频率限制。一次只改一个设置,等待请求结束,再比较结果,才能确认是哪项调整起了作用。
先查请求路径,再判断是否需要 Update via Proxy
订阅更新可以拆成四个阶段。只有取得可识别的内容后,应用才有数据可写入列表。因此,“网页能打开”“VPN 已连接”和“订阅刷新成功”是三个不同的判断条件。
先确认当前 Wi-Fi 或蜂窝网络可以正常联网,且没有等待登录的网络认证页面。若订阅域名在当前网络无法直接访问,而已有连接确实可用,再尝试 Settings → Subscribe → Update via Proxy,并回 Home 手动刷新比较结果。
- 启用 Update via Proxy 前,先确认当前选中的已有条目可以建立连接。已有连接本身失效时,用它更新订阅通常仍会失败。
- 若启用后失败而关闭后成功,保留能够完成请求的设置,并检查所选连接是否能访问订阅域名。
- Global Routing 中的 Proxy、Direct、Config、Scene 是整体路由姿态,不是订阅更新频率设置。不要为了刷新一次订阅而同时改动全部路由设置。
- On Demand 用于按条件触发连接,不负责轮询订阅。调整 Settings → On Demand 不能替代检查 Subscribe 中的更新设置。
切换 Wi-Fi 与蜂窝网络适合用作对照测试。若同一地址只在一种网络下失败,优先检查该网络的访问条件;若不同网络都返回相同的授权错误,应回到链接和服务状态本身排查。
更新失败:按超时、授权、地址和格式分别处理
错误可能出现在提示框或相关请求记录中,显示形式会随系统语言和响应来源不同而变化。下面列出的是网络请求可能返回的英文错误原文或 HTTP 状态行,不保证每次都以完全相同的提示框出现。反馈时应保留自己实际看到的文字。
The request timed out.
原因:请求在等待期限内没有完成,可能与当前网络、访问路径或服务端响应有关。
解法:先切换一次网络重试;若已有代理连接可用,再比较 Update via Proxy 开关前后的结果,不要连续快速刷新。
401 Unauthorized
原因:服务端未接受本次请求的身份凭据,订阅 token 可能已失效或被重置。
解法:从自己的服务商处重新核对订阅地址,完整替换后重试;仅切换网络不能修复失效凭据。
403 Forbidden
原因:服务端拒绝访问,可能涉及账号状态、访问策略或请求来源限制。
解法:向自己的服务商确认订阅访问条件,并提供已遮盖敏感信息的错误记录;不要据此直接认定客户端解析异常。
404 Not Found
原因:服务端没有找到该请求地址对应的资源,常见于路径不完整或入口已变更。
解法:核对链接路径与查询参数,重新复制自己的完整订阅地址,避免手动拼接或删除参数。
如果没有上述网络错误,但更新后没有可用条目,应检查返回内容是否为应用支持的订阅格式。登录页、到期提示页或网络认证页虽然可能成功返回,却不是服务器列表。浏览器能显示页面,只能说明拿到了某些内容,不能证明该内容可用于 Subscribe。
- 地址完整性:检查是否多复制了空格、换行、引号,或漏掉了查询参数。
- 入口用途:确认取得的是自己的客户端订阅入口,而不是账户管理页、网页预览页或远程配置文件入口。
- 格式兼容性:向自己的服务商确认该入口是否适用于 Shadowrocket,以及返回内容是否包含有效连接条目。
- 安全处理:不要把完整链接交给陌生的在线转换页面。格式问题应先由原资料提供方确认。
更新后的常见问题与验收方法
更新完成后,分别检查数据是否取得、列表是否符合预期、选中条目是否可连接。不要用一次网页访问失败,反推整个订阅请求一定失败。以下问题可用于把故障范围进一步缩小。
显示更新完成,但条目一个都没变,是没刷新吗?
不一定。远端内容没有变更时,本地列表可以保持不变。先确认本次没有错误提示,再用服务商已经明确变更的条目作对照;不要为了让数量变化而重复删除和导入。
打开时自动更新开着,为什么还要手动刷新?
手动刷新用于主动获取当前内容,也便于立即观察错误。Update on Open 只规定触发时机,不保证网络请求一定完成。出现异常时回 Home 下拉刷新,记录结果再排查。
更新后原来选中的条目不见了,怎么处理?
先检查它是否被远端移除或改名。重新选择当前分组中仍有效的条目,再测试连接。不要把订阅生成的旧条目视为永久保留项;如需手动维护,应明确区分其数据来源。
更新成功但还是连不上,下一步查什么?
确认 Home 当前选中项,再检查连接状态与 Global Routing。使用 Config 姿态时继续核对匹配规则和策略;订阅更新不会自动修复错误的规则选择。可到常见问题页按连接故障继续排查。
完成排查后,保留成功使用的更新路径,并记下故障发生时的网络类型、实际提示和已尝试的操作。需要进一步帮助时,这些信息比“刷新不了”更容易定位问题。连接故障可继续阅读常见问题中的排查说明。
客户端购买与订阅服务分开核对客户端买断 ≠ 线路套餐。Shadowrocket 是闭源商业应用,仅在 Apple 平台通过 App Store 获取,主要用于 iPhone 与 iPad。开发者为 Shadow Launch Technology Limited,应用 ID 为 932747118。价格、系统要求与通用购买适用范围以 App Store 页面标注为准。本文仅说明如何管理用户自己已有的订阅资料。