Clash 导入订阅失败或导入后没有节点:逐项排查
一句话回答:Clash 导入订阅失败,最常见的是链接复制不完整,或复制的是通用链接而不是 Clash 专用链接。先从面板重新复制 Clash 链接,用浏览器打开确认返回的是 YAML 内容,再把更新方式改为直连后重试。
Clash 系客户端(Clash Verge Rev、FlClash、Clash for Windows 的旧用户,以及各种基于 Mihomo 内核的软件)导入订阅出问题,大致有两种表现:一种是弹出报错,直接告诉你下载失败、解析失败、超时;另一种是悄悄成功,但节点列表空了,或者只有「剩余流量」「距离到期」两三行信息。这两种表现对应的原因几乎不重叠,所以先分清自己是哪一种,再往下查。
本文只讨论 Clash 一族。小火箭和 v2rayN 各有自己的坑,对应篇目分别是 小火箭导入失败 与 v2rayN 无法连接。如果你的问题是各种客户端都拉不到订阅,更通用的排查在 订阅更新失败。
导入这件事,客户端到底做了什么
理解这一点,排查会快很多。你把一个链接粘贴进去,客户端做三件事:向这个链接发起 HTTP 请求,下载返回的内容;检查内容是不是自己能解析的格式(YAML 配置文件,或者 Base64 编码的节点列表);解析成功后,把里面的节点和规则写进本地配置。
三步各有各的失败方式:
| 阶段 | 失败表现 | 典型原因 |
|---|---|---|
| 下载 | 提示超时、连接失败、404、403 | 链接错误、域名失效、网络不通、被限制请求 |
| 解析 | 提示配置错误、YAML 解析失败 | 拿到的是别的格式、内容被网关改写、文件被截断 |
| 写入 | 导入成功但没节点 | 订阅本身只含信息条、节点被客户端的过滤规则过滤、协议不被内核支持 |
Clash 导入订阅失败的常见原因
| 原因 | 现象 | 验证办法 |
|---|---|---|
| 链接复制不完整(末尾缺字符、被换行截断) | 报 404 或 token 无效 | 重新从面板复制,粘贴到记事本里检查是否单行 |
| 复制的是通用链接,不是 Clash 专用链接 | 能下载但解析失败 | 浏览器打开链接,看内容是 YAML 还是一长串乱码字符 |
| 订阅域名被阻断 | 浏览器也打不开 | 手机流量下打开试试;联系机场换新域名 |
| 下载时走了代理,且代理已失效 | 浏览器能开、客户端更新超时 | 把更新方式改为直连 |
| 客户端内核太旧,不认某些协议 | 导入成功但节点被丢弃 | 升级客户端;对照机场使用的协议(见协议表) |
配置文件里 proxies 为空 | 只有信息条 | 浏览器看订阅内容,确认里面有没有节点 |
| 订阅被机场重置或已过期 | 403 或空内容 | 登录面板,看套餐状态与订阅是否重置过 |
| 系统时间错误引起 HTTPS 证书校验失败 | 下载阶段证书错误 | 同步系统时间 |
| 开启了 TUN 或系统代理,形成回环 | 更新时一直转圈 | 临时关闭 TUN 与系统代理再更新 |
Clash 导入订阅失败:按顺序排查
一、先用浏览器验证订阅本身(最重要)
不要在客户端里反复点更新,先把客户端排除掉:把订阅链接粘贴到浏览器地址栏。
- 看到一大屏文字,开头类似
proxies:或port::这是 YAML 格式的 Clash 配置,机场侧完全正常。 - 看到一长串没有空格的字母数字:这是 Base64 编码的节点列表,通用格式。Clash 系客户端通常可以解析,但部分旧版本只认 YAML。如果客户端报解析失败,回面板找「Clash 订阅」专用链接。
- 提示下载文件:保存后用记事本打开看内容,判断同上。
- 浏览器也打不开、404、403:问题在链接或机场。重新复制链接;仍然不行,联系机场。
这一步用一分钟,就把「机场的锅」和「客户端的锅」分开了。
二、检查链接本身
从面板重新复制,不要从聊天软件、邮件里转了一手的文本复制。聊天软件有时会把链接里的 & 之后的内容截断,或者给长链接自动插入换行。粘贴到纯文本编辑器里,确认它是完整的一整行,参数没被吞掉。
另外,如果你近期点过面板上的「重置订阅链接」,旧链接就立即失效了——别在别的设备上还在用老链接。这时需要在所有设备上换新链接。订阅被泄露后需要重置的情形,见 订阅被别人用。
三、把更新方式调成直连
在 Clash Verge Rev 里,订阅卡片上通常有「使用代理更新」或类似的选项;FlClash 在订阅设置里有类似开关。不同版本名称略有差异。关键逻辑是:首次导入时,客户端里还没有任何可用节点,用代理更新等于让它借一个不存在的代理去下载,必然超时。
操作:先把代理模式切到「直连」(或关闭系统代理),再更新订阅。更新成功后,再切回规则模式。
四、升级客户端与内核
如果机场用的是 VLESS 等较新协议,旧内核会直接忽略不认识的节点,表现就是「导入成功,节点比预期少很多,甚至为零」。用 airports.ts 里的信息举例:EdgeNova 的协议里有 VLESS,二猫云等多家以 Trojan 和 Shadowsocks 为主。前者对内核新旧更敏感。
升级到当前稳定版的 Clash Verge Rev 或 FlClash,通常就能解决。不再维护的老版 Clash for Windows 不建议继续使用,转到上述客户端更省心。
五、检查自带的过滤与覆写
新版 Clash 系客户端支持「订阅覆写」「节点过滤」「脚本」。如果你或某个教程在订阅上加了过滤正则,可能把全部节点都过滤掉了。去订阅的编辑页,临时清空覆写、脚本和过滤条件,重新更新,看节点是否出现。
六、看日志里的具体字样
| 日志字样 | 含义与处理 |
|---|---|
context deadline exceeded | 下载超时,参考第三步 |
x509: certificate 相关 | 证书校验失败,查系统时间 |
yaml: unmarshal / cannot unmarshal | 内容不是预期的 YAML,重新取 Clash 专用链接 |
status code 403 | 链接被拒绝,可能被重置或限制请求头,联系机场 |
status code 404 | 链接不存在,重新复制或订阅域名已更换 |
unsupported protocol / unknown type | 内核不认协议,升级客户端 |
七、导入成功但节点全不通
这就从导入问题转成了连接问题。去看 节点全部超时 的排查链。如果是只在开启 TUN 模式 后才出问题,问题多半在虚拟网卡与系统 DNS 的配合上,先关闭 TUN,用系统代理模式确认节点是否正常。
决策树
- 浏览器能打开订阅链接并看到节点内容?
- 否:联系机场,或重新复制链接。
- 是:往下。
- 内容是 YAML 吗?
- 否(乱码长串):换专用的 Clash 链接,或升级客户端。
- 是:往下。
- 把更新方式改成直连后能成功吗?
- 是:结束,以后更新也用直连。
- 否:往下。
- 客户端版本是不是很旧?
- 是:升级后重导。
- 否:往下。
- 关闭所有覆写与过滤后有节点吗?
- 是:问题在你自己加的规则。
- 否:带日志去提工单。
仍然不行怎么办
如果以上都做了,在浏览器里能看到完整节点内容、客户端却始终导不进去,那么问题很可能出在客户端的某个特定版本上。先尝试换一个客户端导入同一个链接(比如在电脑上换成 Clash Verge Rev,在安卓上换成 FlClash),判断是不是单一软件的问题。
提工单时写清下面这些:
- 你用的客户端名称和版本号、操作系统。
- 你在浏览器里打开订阅链接的结果:能看到什么、是 YAML 还是乱码长串、是否下载文件。
- 客户端报的原文错误,直接复制或截图日志,不要概括成「导入失败」。
- 你是否改过覆写、脚本、自定义规则。
- 同一订阅在其他客户端(手机小火箭或 v2rayN)是否可用。
不要把完整订阅链接贴在公开群或评论里,链接等同于你的账号凭证。客服能在后台根据账号查到,你只需要提供注册邮箱。
如果你正在挑一家本身就对 Clash 友好的机场,可以先看 Clash 机场推荐,那里只列了提供 Clash 订阅格式的机场。而要把订阅原理弄清楚,可以读 订阅链接是什么,它能帮你理解为什么「同一个链接、不同格式」会导致解析失败。
常见问题
Clash 导入订阅后一片空白,一个节点都没有,是机场的问题吗?
先别下结论。最常见的原因是链接复制不完整、订阅格式选错,或客户端下载订阅时走了错误的网络。先用浏览器打开订阅链接,如果能看到一大段文字或下载到配置文件,说明机场侧没问题,毛病在客户端。
订阅链接里的 flag=clash 或 clash=1 参数要不要改?
按机场面板提供的链接原样使用,不要自己删改参数。不同机场用不同参数区分输出格式,改错了会拿到别的格式的内容,Clash 解析不了。面板里一般有「复制 Clash 订阅」的专用按钮。
更新订阅提示超时,但浏览器能打开链接,为什么?
客户端下载订阅时可能走了系统代理或某个已失效的节点,绕了一圈反而不通。把订阅更新设为直连,或者先把代理模式切换为「直连」,再点更新。
导入后节点有,但名字全是乱码,影响使用吗?
通常不影响连接,只是编码显示问题,多出现在旧版本客户端。升级到较新的 Clash Verge Rev 或 FlClash 一般就能解决,同时也能获得更好的新协议支持。
提工单需要附订阅链接吗?
不要把完整订阅链接发在公开场合。发工单时可以只附链接的域名部分,并说明在浏览器里打开的结果;机场客服能在后台按你的账号查到订阅,不需要你贴出全文。
机场订阅:本站推荐的 3 家
从 机场订阅 榜单里取前 3 家,本站主推的合作品牌排在前面(已标注合作);价格以官网为准。