订阅链接更新失败 / 超时排障

故障排查约 4 分钟读完

订阅链接拉取失败是最常见的问题之一。表现有几种：一直转圈、提示「超时」、提示「解析失败」、更新成功但节点列表为空。这几种的原因完全不同，需要分开排查。

如果你还没成功导入过订阅，先看 Clash Verge 从零配置指南 的第二、三节。

一、先分类症状

先对号入座，再看下面具体步骤。

二、第一步：验证链接本身

把订阅链接直接粘贴到手机或电脑的浏览器里打开。

正常情况：会看到一大段 Base64 编码的乱码，或者 Clash 的 YAML 文本（如果链接带 &flag=clash）。

异常情况：

• 打开是空白页 → 链接不完整或域名失效
• 提示「订阅不存在」→ token 错误
• 提示「套餐已过期」→ 账号状态问题
• 一直加载不出来 → 域名被墙或 DNS 问题

这一步能排除掉一半的问题。如果浏览器都打不开，客户端当然也打不开。

三、第二步：检查链接完整性

订阅链接通常长这样：

https://vps.example.com/api/v1/client/subscribe?token=abc123def456

常见的复制错误：

• 少了 token= 后面的字符
• 末尾多了空格或换行
• 被聊天软件自动截断（微信、QQ 有时会把长链接截断）
• 中文输入法把 ? 打成了 ？

建议：从面板的订阅页面点「复制」按钮，不要手动选中复制。

四、第三步：检查账号状态

登录面板，看三个数字：

• 剩余流量：是否为 0
• 套餐到期时间：是否已过期
• 账号状态：是否被禁用

流量用尽或套餐过期后，订阅链接仍然可以访问，但返回的是空节点列表。这解释了「更新成功但节点为空」这个症状。

五、第四步：客户端格式兼容

不同客户端需要的订阅格式不同：

如果客户端要求的格式和订阅返回的格式不一致，就会提示解析失败。

解决方法：在订阅链接后加参数指定格式，例如：

&flag=clash
&flag=singbox

具体参数名各家不同，看机场文档。

六、第五步：DNS 与网络

如果浏览器打开订阅链接一直转圈，可能是 DNS 解析问题。

测试方法：在电脑上执行

nslookup vps.example.com

如果没有返回 IP，说明 DNS 解析失败。可以尝试：

• 换 DNS（改成 223.5.5.5 或 8.8.8.8）
• 用手机流量而不是 WiFi 测试（排除路由器问题）
• 用 curl -v 看具体卡在哪一步

七、第六步：时间同步

这个问题很隐蔽。如果设备时间与真实时间偏差超过 2 分钟，TLS 证书验证会失败，表现为「连接超时」或「证书错误」。

检查方法：手机设置 → 日期与时间 → 确认「自动设置」是打开的。

八、什么时候该找客服

排查完上面六步仍然失败，把以下信息发给客服：

• 订阅链接（可以打码 token 后半段）
• 浏览器打开链接的截图（显示具体报错）
• 客户端名称和版本号
• 报错截图
• 已经尝试过的排查步骤

有这些信息，客服能直接定位问题，不用来回问。