先保留旧配置,别把能用的节点一起删掉

订阅链接通常含有可用于获取节点的凭据。处理失败前,先在客户端复制一份配置或导出到自己可控的位置,记下当前可用节点及更新时间。不要把链接贴到公共转换站、截图评论区或在线 YAML 校验器;排障只需要报错,不需要公开整条链接。

如果旧节点还能用而更新失败,优先修复订阅下载路径;如果订阅更新正常但所有节点不能连接,则应转到连接排障。这两个阶段由不同请求完成,不能通过“刷新成功”推断节点可用。

按错误分类,确定下一步

错误或表现含义边界下一步
401 / 403凭据、授权或访问策略可能拒绝了请求从账户内重新复制链接,查看响应说明
404 / 410路径不存在或资源被移除确认完整链接、是否换过订阅入口
429请求过于频繁或服务端限流停止连续刷新,按服务端提示稍后重试
超时 / DNS 错误尚未正常取得内容对照直连和现有代理下载
200 但 YAML / JSON 解析失败取得了内容,但内容或格式不对检查登录页、格式选择和客户端版本

不要把 403 简化成“套餐到期”。同一状态码也可能来自防护页面或网关。应结合账户内的套餐状态、原始错误和下载内容判断。只有服务商账户页面或支持人员才能确认凭据是否有效。

第一步:重新复制正确入口

  1. 登录你实际购买或创建订阅的账户,找到“订阅”“配置”或相应客户端的导入入口。普通网站首页、邀请链接、二维码图片地址都不等于订阅链接。
  2. 按客户端支持的格式复制。例如 Clash/Mihomo 配置、sing-box 配置、通用节点分享链接不是同一种数据。以当前客户端的导入说明为准,不只看扩展名。
  3. 从剪贴板粘贴到本地文本编辑器查看首尾,去掉多余空格、换行、中文引号和聊天软件附加的标点;不要改动查询参数或把 & 误写成 &。
  4. 优先用软件官方支持的一键导入或粘贴入口,导入后检查配置名称和节点数量,再决定是否替换正在用的配置。

第二步:看响应内容,而不是只看 HTTP 200

支持查看下载错误详情的客户端里,先看响应开头。若是 <!DOCTYPE html>、登录提示、人机验证或维护页,就不是有效节点配置。200 只说明 HTTP 请求收到成功状态,并不保证文件内容符合客户端格式。不要把网页源码继续转换成订阅。

Clash/Mihomo 完整 YAML 常见 proxies、proxy-groups、rules 等键;sing-box 完整 JSON 常见 inbounds、outbounds、route 等键。但代理集合、单节点和按客户端动态返回的内容可能不同,不能仅凭是否有某个键判定有效。以导入器的实际报错位置和服务商选择的输出格式为准。

如果服务端按 User-Agent 识别客户端,浏览器下载到的内容与软件请求得到的内容也可能不同。浏览器能打开链接不等于该客户端一定能解析。应优先选择明确标注对应客户端的专用链接,必要时把客户端名称、版本和报错给服务方。

第三步:解决“要先有代理才能更新代理”的循环

  1. 如果客户端提供订阅下载方式选择,先记录原值。尝试一次直连下载;失败后再用仍可工作的旧配置经过代理下载。每次只改变下载方式。
  2. 如果旧节点全失效,尝试另一张可信网络,或者从账户后台重新获取可访问的订阅入口。不要靠反复清空配置解决下载链路问题。
  3. 如果更新日志显示不认识某个协议、字段或 transport,核对客户端与内核版本。通过项目官方渠道更新后先导入为新配置测试;不要为了让解析通过而删掉 TLS、安全验证或关键认证字段。

验证节点与规则,再切换主配置

导入成功后先看更新时间、是否存在实际节点以及策略组是否有候选。固定一个节点访问日常目标,再恢复你使用的规则模式,验证国内直连和需要代理的目标各自走正确路径。节点数量变化不一定是错误,也可能是套餐或服务方调整。

如果新配置异常,切回备份,保留新配置供排查;不要同时覆盖旧配置和删除旧链接。只有确认旧链接泄露或需要轮换时才在账户内重置,重置通常会让原链接在所有设备上失效。

向服务方反馈时,提供这五项就够了

  1. 客户端名称、应用版本与内核版本。
  2. 错误发生在下载阶段还是解析阶段,附完整错误文字。
  3. 状态码、时间与时区,以及直连/代理下载的对照。
  4. 账户内对应订阅格式的名称;把 URL 的 token 等参数完全遮盖。
  5. 旧配置能否连接、新配置有无节点、换网络后的结果。

这套信息能帮助服务方判断是链接过期、内容格式、访问链路还是客户端兼容问题,比只发一句“订阅坏了”更容易定位。