订阅更新失败时的排查顺序

先保留可用配置和错误证据

订阅更新失败不一定意味着当前节点全部失效,也不一定是客户端安装损坏。不要一开始就删除现有订阅;先记录最后成功更新时间、此次失败时间和错误原文,并备份仍能工作的配置。区分下载失败、下载成功但解析失败,以及导入成功但节点无法连接,这三类问题需要不同的排查路径。

确认导入的是订阅地址

重新从可信提供方获取地址,检查是否复制了多余空格、缺少字符,或误用了控制台登录页。链接参数中的令牌可能是认证信息,不能随意删除,也不要为了截图方便把完整地址暴露出来。如果服务额度耗尽、订阅过期或提供方重置了令牌,需要由提供方处理,反复重装客户端通常无效。

根据 HTTP 错误缩小范围

401 或 403 通常提示认证或访问限制,404 可能表示地址失效,429 可能是请求过于频繁,5xx 则应检查服务端状态;这些只是线索,仍要结合响应内容判断。超时和域名解析错误更偏向网络可达性问题。避免短时间连续点击更新,按提供方要求等待后重试,并记录不同网络环境下是否一致。

检查更新请求走哪条路线

浏览器能打开一个网站,不代表客户端的订阅更新请求使用相同网络路径。检查当前版本是否支持选择订阅更新的代理方式,并在你有权使用的网络中做单变量对照。核对系统日期时间;如果出现证书错误,应检查时间、地址与可信证书链,不要以永久跳过证书验证作为解决方案。

下载成功但解析失败

返回的内容可能是登录提示、错误页面或客户端不支持的格式。结合错误中的行号与字段名判断,但不要把完整私有配置贴到公共论坛。若配置由提供方生成,请提供脱敏错误并要求检查兼容性;若自己编辑,先恢复最小可用版本,确认缩进、列表结构和引用的代理组名称。

确认恢复,并关闭泄露风险

更新成功后确认当前选中的是新配置,代理组和节点列表完整,再对一个目标执行连接测试。记录是哪一步解决了问题,避免下次再次盲目修改。如果订阅链接已公开泄露,应在提供方处撤销或重新生成凭据;只删除公开帖子不能保证旧链接已失效。

下一步

下载中心 · 常见问题

参考资料(项目官方文档)