本文适用于已经持有自己服务商订阅链接的用户。先区分 Home 中的节点订阅与 Config 中的配置文件,再手动刷新一次,确认成功后设置打开应用时更新;遇到失败,按链接有效性、请求网络路径、返回格式的顺序排查。订阅更新成功只表示列表已获取并解析,不代表列表里的每条连接都可用。
一、先确认更新对象:节点订阅不是规则配置
Shadowrocket(小火箭)中的订阅更新,是用已保存的 URL 再向服务商请求一次内容,并据此更新对应的节点分组。服务商更换服务器地址、端口、认证信息或节点名称后,重新获取订阅才能让本地列表与远端内容保持一致。单纯关闭再打开连接开关,不等于重新下载订阅。
本文以 iPhone / iPad 的 Home、Config、Settings 界面词说明操作。其他平台可按相同设置名称查找对应入口,具体布局可能不同。开始前先确认更新的是节点列表,不要把 Config 页远程规则文件的更新当作节点订阅刷新。
| 对象与入口 | 更新内容 | 不代表什么 |
|---|---|---|
| Home 中的 Subscribe 分组 | 服务商返回的节点地址、端口及协议参数。 | 不代表每条节点均已通过连接测试。 |
| Config 中的远程配置 | 配置文件内的规则及相关设置。 | 不等同于刷新 Home 中所有节点订阅。 |
| Settings → Subscribe | 订阅获取行为,例如打开时更新、通过代理更新。 | 不负责续期服务商的套餐或恢复失效链接。 |
本站不提供、不销售、不推荐节点或订阅。操作以用户已有服务商与有效订阅为前提;服务状态、流量余额、设备数量限制及订阅 URL 是否被重置,需要到自己的服务商账户中核对。
二、手动更新:从 Home 刷新并核对结果
首次排查时先做一次手动更新,便于观察错误提示和刷新结果。不要先删除原分组:旧列表中的连接可能仍可使用,删除后反而失去可用于恢复访问的路径。订阅中的认证信息属于敏感数据,记录问题时只保留错误文字,不公开完整 URL。
-
核对分组
进入 Home,找到已有的 Subscribe 分组,核对名称及订阅地址。若尚未添加,可从 Home 右上角“+”进入,Type 选择 Subscribe,在 URL 中填写自己的订阅链接并保存。
-
下拉刷新
在 Home 列表顶部下拉并释放,触发订阅刷新,等待本次请求结束。多个订阅存在时逐组核对结果;不要连续下拉发起重复请求,以免混淆提示或触发服务商频率限制。
-
检查列表
展开目标分组,核对节点名称、数量以及服务商明确通知已调整的条目。若远端内容未变化,刷新前后数量相同是正常现象,不能仅据此判断更新失败。
-
验证连接
选择更新后的节点,在 Home 运行 Connectivity Test,再尝试实际访问目标服务。若列表已经更新但连接失败,应转为检查节点参数与链路,不要反复刷新同一个订阅。
订阅维护的条目可能在下一次刷新时被重建或替换,因此不宜把分组内手动修改的端口、密码当作长期配置。确需保留独立条目时,先记录其来源与用途,再与订阅管理的条目区分,避免后续把旧参数误认为服务商最新参数。
三、打开时自动更新:设置入口与触发边界
手动刷新成功后,再进入 Settings → Subscribe,启用 Update on Open。该选项用于在打开应用时触发订阅更新;它不是固定间隔的全天候下载任务,也不保证应用留在后台时持续刷新。界面大小写及选项排列可能随平台不同,以当前界面显示为准。
- 设置顺序:Home 手动刷新成功,再到 Settings → Subscribe → Update on Open 开启,避免把既有链接故障误判为自动更新失效。
- 验证方式:离开应用后重新打开,等待网络请求结束,再查看目标分组;仅在页面间切换,不能作为必定重新触发更新的依据。
- 网络条件:打开应用时若处于 Wi-Fi 登录认证页面、信号切换或网络不可用状态,更新可能失败,恢复网络后应手动刷新。
- 功能边界:Settings → On Demand 用于按条件发起连接,不是订阅更新定时器。开启 On Demand 不会替代 Update on Open。
若希望保留当前列表以便定位问题,可以暂时关闭 Update on Open,再手动更新目标订阅。排查结束后按需要恢复。自动化只改变请求触发方式,不改变服务商的访问权限、返回格式或套餐有效期。
四、更新经过哪些环节,Update via Proxy 何时使用
订阅更新先要访问 URL 所在的服务器,再解析响应中的内容。域名解析失败、TCP 连接失败、TLS 握手失败、HTTP 拒绝访问与正文格式错误,发生在不同环节。只有把失败阶段分开,才知道应更换网络、修正链接,还是联系服务商确认输出格式。
Settings → Subscribe → Update via Proxy 用于让订阅请求尝试通过代理访问。当订阅域名在当前直连网络无法访问,而已有节点仍可用时,可以先在 Home 选中可用节点并打开连接,再启用该选项后手动刷新。开关本身不会创建一条可用线路,也无法修复过期的认证令牌。
避免更新依赖失效节点
如果更新请求依赖代理,而当前代理节点也已失效,就可能出现“必须更新才能连接,又必须连接才能更新”的循环。此时先保留原分组,测试关闭 Update via Proxy 后的直连更新,或换到能够访问订阅域名的可信网络;不要通过关闭 TLS 验证绕过证书错误。
例如,未显式指定端口的 HTTPS 订阅通常访问 TCP 443;节点自身可能使用完全不同的地址与端口。节点延迟测试成功,并不能证明订阅服务器的 TCP 443 可达。Global Routing 的 Proxy、Direct、Config、Scene 属于连接路由姿态,不是四种订阅刷新方式;诊断时一次只改变一个设置,避免同时切换路由、节点和网络后无法判断原因。
五、更新失败原因:按响应与现象处理
先记录完整错误文字及出现条件:是仅 Wi-Fi 失败、仅启用 Update via Proxy 后失败,还是所有网络都返回相同状态。以下是服务器或网络层可能返回的英文报错原文;应用也可能显示本地化描述,应按对应含义排查,而不是要求字面完全相同。
报错:401 Unauthorized
原因:订阅服务未接受当前请求的认证信息,可能是令牌失效或 URL 被重置。
解法:登录自己的服务商账户重新复制有效订阅链接,替换目标分组的 URL 后手动刷新,不要自行猜测 token。
报错:403 Forbidden
原因:服务器拒绝访问,可能涉及账户状态、来源 IP、设备限制或访问防护规则。
解法:核对账户与设备限制,并向服务商提供状态码和请求时间;不要把更换节点当作必然有效的处理方式。
报错:404 Not Found
原因:请求路径不存在,常见于复制不完整、订阅入口迁移或链接已被撤销。
解法:从账户页面重新完整复制链接,核对路径及查询参数,避免只复制到问号之前。
报错:429 Too Many Requests
原因:服务端限制了短时间内的请求次数,连续刷新可能继续触发限制。
解法:停止重复刷新,按服务商说明或响应中的 Retry-After 等待后重试,并检查是否有多台设备同时更新。
报错:The request timed out.
原因:请求未在允许时间内完成,可能是解析、连接、服务器响应或当前代理路径受阻。
解法:先切换 Wi-Fi 与蜂窝网络做对照,再检查 Update via Proxy 及所选节点是否可用,每次只改变一项。
没有明确状态码,但提示内容无法识别
HTTP 请求完成不等于订阅内容有效。服务器即使返回 200,也可能给出登录网页、验证码页面、到期说明或空白正文,客户端无法将其解析为节点列表。向服务商确认该 URL 返回的是适用于 Shadowrocket 的节点订阅,而非账户管理页或另一类配置文件。
- 链接完整性:检查首尾空格、换行和复制时混入的中文标点。示意地址
https://example.com/sub?token=xxxx中的查询参数属于 URL 的一部分,此示例不可用于实际更新。 - 内容与数量:更新后分组为空时,先核对账户状态和服务商返回内容,不要立即删除所有本地条目。
- 时间与证书:出现证书尚未生效或已过期提示时,先检查设备日期、时间及时区是否准确,再确认服务端证书状态。
- 反馈材料:提供错误文字、网络类型、是否启用 Update via Proxy,以及可复现步骤;截图需遮住 URL 查询参数和认证信息。
六、订阅自动更新常见问题
开了自动更新,为什么节点数量没变?
数量不变不代表没有更新。先在 Home 手动下拉一次,检查是否有错误,再核对服务商明确变更的节点名称或参数。远端列表本身没变化时,本地保持原样符合预期。
要一直开着应用才能更新吗?
Update on Open 的重点是打开应用时触发,不是要求界面始终停留在前台。需要立即获取最新列表时,回到 Home 手动刷新并等待完成,不依赖后台运行状态推断是否更新成功。
订阅更新成功,为什么仍然连不上?
先在 Home 对新列表运行 Connectivity Test,再核对所选节点和 Global Routing。获取订阅与使用节点是两个请求过程;节点端口、认证参数或目标服务访问问题,需要单独排查。
链接重置后,要重新安装应用吗?
通常只需编辑对应 Subscribe 分组,将 URL 替换为自己的新链接并保存,再回到 Home 下拉刷新。重新安装不会让旧 token 恢复有效,还可能使尚未备份的本地设置丢失。
能把完整订阅链接发给别人排查吗?
订阅 URL 往往包含可直接获取账户节点信息的令牌,不宜公开。提交反馈时遮住 token 等敏感参数;如果链接已经泄露,到自己的服务商账户重置链接,并更新各设备保存的 URL。