已添加订阅却看不到新条目时,先在 Home 手动刷新,再检查 Settings → Subscribe 中的 Update On Open。本文以 iPhone / iPad 的英文界面为步骤基准,适合已有服务商和订阅链接的用户;其他平台按同名功能核对。读完可区分链接失效、网络访问失败与内容解析失败,并判断更新后为什么仍然无法连接。
先区分更新对象
Shadowrocket(小火箭)的订阅更新,是重新请求已保存的订阅地址,把返回内容解析为连接条目,再同步到对应订阅分组。它不是更新应用程序,也不是给线路套餐续期。订阅链接从你的服务商处获取;客户端买断 ≠ 线路套餐,客户端的获取费用不会改变服务商账户的流量、期限或连接权限。
Home 展示连接条目与订阅分组;Config 管理配置文件及其规则;Settings 管理应用设置。本文讨论 Home 中连接订阅的刷新,不把 Config 中配置文件的远程更新当作同一操作。刷新连接订阅通常不会替你修改 Config 中的 DOMAIN-SUFFIX、IP-CIDR 或 FINAL 规则。
订阅地址、连接服务器地址与配置文件地址也不能互换。订阅地址用于拉取条目;连接服务器地址和端口用于实际建立连接。即使二者都使用 443,也不代表访问的是同一台服务器。订阅刷新成功,只能说明本次拉取与解析完成,不能证明每个连接条目都可用。
在 Home 手动更新
第一次排查建议手动触发,便于记录触发时间、提示内容与条目变化。先确认 Home 中存在带有订阅来源的分组:只有单独手填的服务器,而没有订阅地址时,下拉不会凭空生成新的订阅内容。不要因为刷新无变化就重复导入同一链接,否则会增加判断分组来源的难度。
-
确认分组
进入 Home,找到需要更新的订阅分组。若尚未添加,使用 Home 右上角“+”→ Type → Subscribe,填写从你的服务商处获取的订阅地址并保存。
-
核对地址
在该订阅的编辑信息中检查 URL,确认完整保留协议、路径和查询参数。不要把服务商账户的网页登录地址当成订阅地址,也不要把复制时附带的空格或换行留在链接中。
-
下拉刷新
回到 Home,将列表滚动到顶部后下拉并松开,等待刷新结束。此操作可能更新多个已保存订阅,因此应重点观察目标分组,不要只看列表总条目数。
-
检查结果
记录错误提示,或核对服务商明确告知有变动的条目。若名称、数量与原来相同,先确认服务商是否实际更改了内容;相同结果不等于更新失败。
示例地址 https://example.com/sub?token=xxxx 仅用于识别结构,不能作为实际订阅使用。其中 token 属于访问凭据的一部分,不能只保留域名后再尝试刷新。分享排查信息时,应遮住完整查询参数、账户信息和连接凭据,不要公开订阅原文。
打开时自动更新
在 Settings → Subscribe 中找到 Update On Open 并开启后,应用会在打开时按该功能的触发逻辑尝试刷新订阅。它适合希望在使用前获取最新条目的情况,但不等于按分钟定时刷新,也不保证应用关闭后持续运行。系统后台调度、当前网络和服务端响应仍然会影响结果。
- 启用前:先在 Home 完成一次成功的手动更新,确认当前地址与网络能够返回有效内容。
- 启用后:重新打开应用,等待请求完成,再检查目标分组;不要将“开关已开启”当作“本次更新已成功”。
- 出现失败时:回到 Home 手动刷新,以便看到错误提示。反复切换 Update On Open 不能修复过期链接。
- 网络较慢时:先让本次请求结束,再决定是否重试,避免连续打开、关闭应用造成重复请求。
Update On Open 与 Settings → On Demand 不是同一个设置。前者用于订阅刷新,后者用于满足条件时触发 VPN 连接。开启 On Demand 不会自动修复订阅下载失败;关闭它也不是更新订阅的必要步骤。排查时只改变与当前问题有关的一项设置,才能判断变化来自哪里。
理解刷新处理流程
“请求订阅地址”阶段需要完成域名解析、建立连接,以及 HTTPS 地址所需的 TLS 协商。域名解析失败、网络不可达或证书校验失败,都会使后续解析没有机会发生。此时更换 Home 中某个连接条目的协议参数,通常不是针对订阅请求本身的修复。
“接收响应”完成后还要检查内容。HTTP 200 仅表示服务器返回了成功响应,不保证正文是可识别的订阅;服务商登录页、网页验证页或空正文也可能被正常下载。相反,HTTP 401、403、404 已经提供了访问权限或路径方面的线索,应先核对链接,而不是立即改 DNS。
结论:先定位失败阶段
超时先检查网络与可达性;401、403、404 先核对服务商链接;请求成功却没有条目,再检查返回内容与订阅格式。按阶段处理,避免同时修改网络、配置和订阅三个变量。
按提示排查失败
下面列出常见的英文网络错误或 HTTP 状态。具体提示的语言和呈现方式可能随系统与界面而不同,应保留实际原文。单条提示只能缩小范围,不能独立证明账户过期或服务器故障。
报错:The request timed out.
原因:请求未在等待期限内完成,可能涉及当前网络、访问路径或订阅服务器响应。
解法:先停止连续刷新,分别在可用的 Wi-Fi 与蜂窝网络下重试一次;若只有一个网络失败,优先检查该网络的解析与访问限制。
报错:Could not connect to the server.
原因:客户端无法与目标服务建立连接,地址、端口、网络可达性或服务端状态均可能相关。
解法:核对 URL 的域名与显式端口是否完整,再向你的服务商确认订阅服务是否可访问,不要自行猜测替代域名。
状态:HTTP 401 Unauthorized
原因:订阅服务器拒绝当前请求的身份凭据,常见于 token 无效或需要重新授权。
解法:从你的服务商处获取当前有效的完整链接,替换原订阅 URL 后再刷新,不要只修改参数中的几个字符。
状态:HTTP 403 Forbidden
原因:服务器拒绝访问,可能涉及账户状态、来源限制或请求频率,不能仅凭此状态判定订阅过期。
解法:暂停高频重试,向你的服务商核对权限与访问限制,并提供已脱敏的错误状态及发生时间。
状态:HTTP 404 Not Found
原因:服务器没有提供所请求的路径,可能是复制不完整或原订阅路径已更换。
解法:重新获取完整订阅链接,核对路径与查询参数;不要把首页地址拼接成订阅地址。
遇到证书相关错误时,先确认设备日期与时间正确,再核对域名是否与服务商提供的一致。不要通过关闭证书校验来掩盖问题。若其他 HTTPS 服务可访问而只有该订阅失败,应将域名和错误提示反馈给你的服务商,确认其证书与服务状态。
格式变化与空列表
如果网络请求能够完成,却出现解析失败、空分组或条目明显缺失,应检查订阅内容是否变了。服务商可能调整输出格式、替换订阅路径,或者在原路径返回账户提示页面。网页能打开不代表正文符合 Shadowrocket 的订阅格式;不要把一个可浏览的 HTML 页面再次当作连接订阅导入。
| 观察现象 | 优先核对 | 下一步 |
|---|---|---|
| 提示成功,条目不变 | 服务商是否真的发布了变化 | 核对一个已知改名或新增的条目,不以总数作为唯一依据。 |
| 返回登录页或验证页 | 是否复制了账户网页地址 | 从你的服务商处获取供客户端使用的订阅链接。 |
| 原来可用,现在解析失败 | 服务商是否更换格式或路径 | 确认当前适用的订阅输出,保留原分组信息后再修改 URL。 |
| 只有部分条目缺失 | 服务商是否删除条目或改变字段 | 提供脱敏后的差异描述,请服务商检查输出,不手动猜填凭据。 |
不要把“删除订阅再添加”当作首要步骤。删除会丢失现有分组这个对照对象,也可能影响当前所选条目。先记下订阅名称、错误原文和变化情况,再决定是否替换地址;若确需重新添加,确认新分组已成功生成并能使用后,再整理重复条目。
更新后的连接检查
刷新完成后仍然无法访问网页,需要把订阅问题与连接问题分开。Home 中显示的新条目可能尚未被选中;原先选中的条目也可能已被服务商移除。先选择当前订阅中仍然存在的条目,完成连接与实际访问测试,再排查 DNS 或规则,不要只依赖延迟结果。
- 核对当前选择:在 Home 确认当前连接条目属于已更新的目标订阅,而不是同名的旧分组。
- 核对路由姿态:检查 Global Routing。Config 按配置规则处理请求,Proxy 与 Direct 用于不同的整体路由选择;刷新订阅本身不会替你切换这些姿态。
- 核对实际访问:用自己原本需要访问的服务验证。延迟测试有结果,不代表 DNS、TLS 与页面请求全部成功。
- 准备反馈信息:记录网络类型、发生时间、错误原文及失败阶段;隐藏 token、密码与完整订阅地址后再联系你的服务商。
日常使用时,可保留 Update On Open 作为获取变更的便利设置,并在服务商通知调整后手动刷新一次。若更新频繁失败,按“地址是否有效、网络是否可达、返回内容是否可解析”的顺序检查,比反复重装应用更有针对性。Shadowrocket 不提供、不销售、不推荐节点或订阅;本文所有操作均以用户已有自己的服务商与订阅为前提。