订阅导入失败有两种常见情形:提示格式错误,说明链接返回的内容客户端读不懂;导入成功但没有节点,说明内容为空或被客户端忽略。先用站内格式检测看内容是 Clash 配置、base64 节点列表,还是一个网页错误页,再决定是换格式的链接、换客户端,还是回后台检查订阅状态。
订阅导入失败,是新手最常遇到的第二个关卡:第一个关卡是买,第二个就是把订阅导进客户端。有人看到“格式错误”,有人导入后一片空白,还有人明明提示成功,节点列表却空空如也。表面上都是“导入失败”,原因其实截然不同。这篇教你先分清是哪一种,再对症处理。
先分清两种失败
| 类型 | 表现 | 本质 |
|---|---|---|
| 格式错误 | 导入时直接提示格式不对、解析失败 | 链接返回的内容,客户端读不懂 |
| 导入后没有节点 | 提示成功,但节点列表为空 | 内容为空,或被客户端忽略 |
两种问题的排查路径不同,所以第一步是看提示:有报错的走“格式”这条路,没报错但没节点的走“内容”这条路。
第一步:用站内格式检测,看看内容是什么
最省事的判断办法是用站内的 订阅格式检测:把订阅链接或内容放进去,它在你的浏览器里运行,不会上传内容。检测结果大致有这几种:
| 检测结果 | 含义 | 下一步 |
|---|---|---|
| Clash 风格的配置 | 带 proxies、rules 等段的 YAML | 用 Clash 系客户端导入 |
| base64 编码的节点列表 | 解码后每行一个节点链接 | 用能读节点列表的客户端导入 |
| sing-box 风格的 JSON | 花括号包起来的结构 | 用 sing-box 系客户端导入 |
| 网页或错误页 | 返回的是 HTML,比如错误提示、登录页 | 订阅链接本身有问题,回后台核对 |
| 内容为空 | 没有任何有效内容 | 订阅过期、被重置或为空 |
三种常见格式的外观与对应客户端,详见 订阅有哪几种格式。
订阅导入失败之“格式错误”:怎么处理
如果检测出来格式是有效的,只是和你的客户端不匹配:
- 看客户端能读哪几种格式,以官方说明为准;
- 看机场后台是否提供多种格式的链接,很多服务商会让你选择客户端类型;
- 后台没有的话,考虑换用能读这种格式的客户端;
- 实在需要转换,参考 订阅转换怎么做,并遵守“在本机完成”的原则。
如果检测出来是网页或错误页,说明链接指向的不是订阅内容:回后台重新复制完整链接,注意不要夹带空格或换行。
导入后没有节点:怎么处理
对照下表逐项排查:
| 可能原因 | 怎么确认 | 怎么处理 |
|---|---|---|
| 订阅内容为空 | 检测结果显示为空,或后台套餐过期 | 续费或重新获取链接 |
| 没有选中新导入的配置 | 客户端当前使用的是默认配置 | 在配置列表里选中新导入的这份 |
| 部分协议不被客户端支持 | 节点数量明显少于后台说明 | 更新客户端,或换用支持更全的客户端 |
| 订阅被重置 | 旧链接已失效 | 回后台复制新链接 |
| 客户端缓存 | 更新后列表没有变化 | 重启客户端,重新更新订阅 |
第二项最容易被漏掉:导入了,但没有“选中”,客户端用的还是原来的配置,当然看不到新节点。具体的导入步骤,读 Clash 订阅怎么导入。
复制链接时,几个常见的失误
很多“导入失败”,其实出在复制这一步:
| 失误 | 后果 | 怎么避免 |
|---|---|---|
| 漏掉了末尾几个字符 | 链接指向错误,返回错误页 | 用后台的“复制”按钮,别手动选取 |
| 前后夹带了空格或换行 | 客户端无法识别地址 | 粘贴后检查两端 |
| 复制了页面上的说明文字 | 内容混入了无关字符 | 只复制链接本身 |
| 用了过期的旧链接 | 返回为空或被拒绝 | 以后台当前显示的为准 |
| 把不同客户端的链接混用 | 格式不匹配 | 按客户端类型复制对应链接 |
养成“复制后在浏览器里打开确认一下”的习惯,能避开大部分这类问题;注意只在本机浏览器里打开,不要贴到别的网站。
客户端的缓存和重启,也值得试一次
如果前面都没问题,仍然没有节点,还可以尝试:
- 删除刚才导入的那一条订阅,重新导入一次;
- 关闭客户端并重新启动,让它重新读取配置;
- 确认客户端版本不是过旧的,必要时更新;
- 导入之后手动更新一次,而不是等自动更新。
这些操作成本很低,往往能解决一些莫名其妙的问题。
一个快速的自查流程
按下面的顺序走一遍,大多数问题能在几分钟内定位:
- 登录后台,确认套餐没有过期、流量没有用尽;
- 重新完整复制订阅链接;
- 用格式检测判断内容;
- 对照客户端支持的格式,决定是否需要换链接或换客户端;
- 导入后确认已选中这份配置,并更新一次;
- 节点数量与后台说明大致相符,才算成功。
什么时候联系客服
自己排查之后仍然失败,再联系客服。带上:客户端名称与系统、格式检测的结果、报错提示的原文、你已经做过的步骤。不要把完整链接贴在公开群里。如果问题表现为更新失败而不是导入失败,另外读 订阅更新失败怎么办。
预防
- 复制链接时顺手记下后台标注的客户端类型;
- 导入后马上核对节点数量;
- 留一条备用格式的链接,主用客户端出问题时可以临时换;
- 换客户端之前,先确认它能读你的订阅格式。
一个提醒:导入成功不等于能用
导入完成,节点列表里出现节点,只是第一步。真正能不能用,还需要在客户端里选中节点、确认模式和系统代理,再打开几个网站验证。如果节点能看到但连不上,那就进入另一类问题,读 机场连不上怎么办,按分层的顺序继续排查。把“导入”和“连通”分成两个阶段来对待,排错时思路会清楚很多。
下一步
如果你还没有订阅,选购时就把“支持的订阅格式”当成一个筛选条件:用 选机场向导 确认自己的客户端,再到 机场推荐榜 核对各家资料。订阅导入失败多数时候不是大问题,先分清格式还是内容,路径就清楚了;处理订阅导入失败时,保持“一次只改一个变量”最重要。
最后一个小提醒:每次排查之后,把最终奏效的那一步记下来。订阅导入失败的原因其实就那么几类,下次再遇到,你会发现自己已经有了一份属于自己的速查表。
- 本文只讲判断与排查思路,不涉及具体字段写法,字段请以各内核官方文档为准。
- 站内格式检测只能判断大致格式,无法判断订阅里的节点是否可用。
- 转换订阅会经手你的订阅凭证,请尽量在本机完成,不要把链接交给来路不明的网站。
这篇的几个常见问题
提示格式错误,是订阅坏了吗?
不一定。格式错误通常是链接返回的内容和客户端期望的不一致,比如客户端要 Clash 配置,拿到的却是 base64 列表,或者是一个网页错误页。先用格式检测看内容是什么,再决定换格式的链接,或换一个能读这种格式的客户端。
导入成功但没有节点,怎么回事?
常见原因有:订阅内容为空(过期、流量用尽或链接被重置)、客户端没有选中新导入的配置、部分节点的协议客户端不支持而被忽略。先在后台确认套餐状态,再确认客户端里选中了这份配置,必要时更新订阅。
浏览器打开订阅链接,看到一大段乱码,正常吗?
可能正常。base64 订阅的内容就是一大段看不懂的字母数字,这是编码的结果。如果看到的是一个网页,比如错误提示或登录页,则说明链接有问题。用站内的格式检测可以帮你快速判断。
需要转换格式时,该注意什么?
转换会经手你的订阅链接,而链接是账号凭证,所以尽量选择在本机完成的工具,不要把完整链接交给来路不明的网站。转换之后,核对节点数量和协议是否合理,再导入客户端,并保留原始链接以备核对。