Clash 订阅导入失败排查
Clash订阅导入失败,多半是链接没复制完整、套餐过期、复制成了非 Clash 格式订阅,或本机网络和时间有问题。先重新复制 Clash 订阅并核对套餐和系统时间,仍不行就重置订阅链接,见 唯兔云使用教程。
Clash订阅导入失败是新手最常遇到的问题:粘贴链接后没反应、提示链接无效、导入成功但之后一直更新失败。这些现象背后的原因其实不多,按顺序排查基本都能解决。本文以 Clash Verge Rev(Mihomo 内核)为例讲菜单位置,示例订阅用唯兔云;不同客户端、不同版本的菜单名称可能不同,找意思相近的选项即可。
如果你还没装好客户端,先看 Clash 教程 完成下载和第一次导入,再回来看这篇。
Clash订阅导入失败:先做这 3 步快速排查
大部分 clash订阅导入失败,做完下面 3 步就好了,花不了两分钟:
- 重新复制 Clash 格式订阅。登录机场用户中心,点“复制订阅链接”时选 Clash 选项,而不是通用订阅或 Shadowrocket 订阅。粘贴前先清空客户端的输入框。
- 确认套餐状态。在用户中心看到期时间和剩余流量。过期或流量用完,订阅会返回空内容或直接拒绝请求。
- 检查本机网络和时间。确认电脑能正常打开国内网站,系统时间和手机时间一致(误差不要超过几分钟)。
三步都做了还不行,按下面的“报错速查表”找到对应小节。
报错信息速查表
客户端弹出的报错文字因版本而异,下面只列常见的关键词和现象,用来快速定位。以你屏幕上实际显示的信息为准,必要时到客户端左侧的“日志”页查看完整内容。
| 你看到的现象或关键词 | 最可能的原因 | 对应小节 |
|---|---|---|
| 点导入没反应、一直转圈 | 链接带空格、不完整,或下载超时 | 第 1 类 |
| 导入成功但没有节点,或节点名显示“已过期” | 套餐过期、流量用完 | 第 2 类 |
| 提示 YAML 解析错误、配置无效 | 复制了非 Clash 格式订阅 | 第 3 类 |
| timeout、连接超时、无法访问 | 本机没网、防火墙或安全软件拦截 | 第 4 类 |
| unsupport proxy type、不支持的代理类型 | 旧版客户端不支持新协议 | 第 5 类 |
| 第一次能导入,之后一直更新失败 | 更新方式(直连 / 代理)设置不对 | 第 6 类 |
| x509、certificate、证书相关错误 | 系统时间不准导致 TLS 握手失败 | 第 7 类 |
| 端口被占用、内核启动失败 | 配置语法错误或端口冲突 | 第 8 类 |
| 403、请求被拒绝、链接无效 | 订阅被风控或链接已被重置 | 第 9 类 |
第 1 类:链接复制不完整或多了空格
现象:粘贴后点“导入”没反应,或者提示链接格式不对、clash订阅链接无效。
原因:订阅链接通常很长,末尾带一串 token。用聊天软件转发、从截图里手打、在手机上长按复制时,很容易少了最后几位,或者首尾多出空格、换行符。有些聊天软件还会把链接自动转成短链或加上跳转前缀。
解决:
- 直接从机场用户中心点“复制”按钮获取,不要手动选中复制,也不要经过聊天软件中转。
- 把链接先粘到记事本里看一眼:开头应该是
https://,中间没有空格,末尾没有多余字符。 - 如果客户端有“剪贴板导入”或“一键导入”,优先用它,可以绕开手动粘贴的问题。
第 2 类:订阅已过期或流量用完
现象:导入后节点列表是空的,或只有几个写着“剩余流量”“到期时间”“已过期”的假节点;之前能用,突然 clash订阅更新失败。
原因:多数机场在套餐到期或流量耗尽后,订阅地址会返回空配置、提示节点或直接拒绝请求。客户端拿不到可用节点,就会表现为导入失败或更新失败。
解决:
- 登录用户中心看到期时间和剩余流量。Clash Verge Rev 的订阅卡片上通常也会显示已用流量和到期日(前提是机场返回了这些信息)。
- 续费或购买流量包后,回到客户端对订阅点“更新”,不需要重新导入。
- 如果流量消耗异常快,可能是链接泄露被别人在用,看第 9 类重置订阅。
第 3 类:用了不支持的订阅格式
现象:提示配置解析失败、YAML 格式错误,或者导入后完全没有节点。
原因:机场通常提供好几种订阅格式。V2Ray / 通用订阅返回的是一长串 base64 编码的文本,解码后是一行行 vmess://、trojan:// 这类节点链接;Clash 需要的却是一份 YAML 格式的完整配置,里面有 proxies(节点)、proxy-groups(策略组)和 rules(分流规则)。格式对不上,客户端就解析不了。部分新版 Mihomo 客户端能识别一些节点链接,但把它当完整配置导入并不稳定。
解决:
- 回到用户中心,明确选择“Clash 订阅”“Clash Meta 订阅”或“Mihomo 订阅”这类选项。
- 不确定复制的是什么格式时,可以在自己电脑的浏览器里打开订阅链接看内容:开头是
port:、mixed-port:或proxies:的是 Clash YAML;一整块看不出意义的字母数字是 base64 通用订阅。看完关掉,不要把内容截图发给别人。 - 有的机场会根据客户端的请求标识自动返回对应格式。如果用浏览器看是 base64、用 Clash 导入却正常,属于正常现象。
各种协议和订阅格式的区别,可以看 代理协议对比。只有通用订阅、需要自己转换格式的情况,建议先联系机场客服要 Clash 订阅,比自己用第三方转换服务更安全。
第 4 类:本机没网或被防火墙拦截
现象:导入或更新时提示超时、无法连接、网络错误,换哪个订阅都一样。
原因:客户端下载订阅本身需要联网。常见的拦截点有:电脑本身没联网;公司或学校网络限制了访问;Windows 防火墙或第三方安全软件拦截了客户端或内核程序;系统代理指向了一个没在运行的代理端口,导致所有请求都发不出去。
解决:
- 先用浏览器打开一个国内网站,确认网络正常。
- 检查系统代理:如果之前用过别的代理软件并且没正常退出,系统代理可能还指向它。在 Windows“设置 → 网络和 Internet → 代理”里关掉手动代理,macOS 在“系统设置 → 网络 → 详细信息 → 代理”里检查。
- 在 Windows 安全中心或安全软件里,把 Clash Verge Rev 和它的内核程序(文件名一般带 mihomo)加入信任,或者临时关闭拦截再试。
- 换个网络测试,比如用手机热点。手机热点下能导入,说明是原来网络的问题。
第 5 类:旧版 Clash for Windows 不支持新协议
现象:用 Clash for Windows、旧版 ClashX 导入时提示不支持的代理类型(日志里常见 unsupport proxy type 之类的字样),或者导入后部分节点消失。
原因:Clash for Windows 和原版 Clash 内核已经停止维护,不支持 VLESS(含 Reality)、Hysteria2、TUIC 等较新的协议。机场订阅只要有一个节点用了新协议,旧内核就可能整份配置都读不进去。
解决:换成使用 Mihomo 内核的客户端:
| 平台 | 推荐客户端 |
|---|---|
| Windows / macOS / Linux | Clash Verge Rev、Mihomo Party |
| macOS 菜单栏 | ClashX Meta |
| Android | Clash Meta for Android、FlClash |
全部客户端的官方下载入口见 代理客户端下载,Windows 用户也可以看 Windows 代理客户端 对比几个客户端的区别。只从 GitHub 官方仓库下载,不要用来路不明的“汉化版”。
第 6 类:订阅更新该走代理还是直连
现象:第一次导入成功,之后自动更新或手动更新一直失败;或者反过来,在某个网络下第一次导入就失败。
原因:客户端拉取订阅有两种方式:
- 直连更新:不经过代理,直接访问订阅地址。第一次导入时还没有可用节点,只能用这种方式。
- 使用 Clash 代理更新:通过当前选中的节点去访问订阅地址。如果订阅域名在你的网络下访问不稳定,这种方式成功率更高。
两种方式选错就会失败:订阅地址直连打不开却选了直连;或者当前节点已经失效(比如套餐刚续费、节点刚调整),却选了走代理。
解决(以 Clash Verge Rev 为例,菜单名称随版本可能不同):
- 在“订阅”页右键订阅卡片,选“编辑信息”。
- 找到“使用系统代理更新”“使用 Clash 代理更新”这类开关。
- 直连更新失败时,打开“使用 Clash 代理更新”,并确认当前有一个能用的节点;代理更新失败时,关掉它改回直连。
- 两种都失败,就回到第 2 类和第 9 类,检查套餐和链接本身。
更新间隔设 12 到 24 小时即可,没必要更频繁。
第 7 类:系统时间不对导致 TLS 失败
现象:提示证书错误、证书无效或过期,日志里出现 x509、certificate 等字样;或者订阅能导入,但所有节点都超时。
原因:订阅地址基本都用 HTTPS,TLS 握手要校验证书有效期。电脑时间偏差太大,客户端会认为证书“还没生效”或“已经过期”,于是拒绝连接。很多加密协议对时间也敏感,时间不准时节点同样连不上。
解决:
- Windows:设置 → 时间和语言 → 日期和时间,打开“自动设置时间”,点“立即同步”,并确认时区是你所在地的时区。
- macOS:系统设置 → 通用 → 日期与时间,打开“自动设置时间和日期”。
- 主板电池没电的旧电脑每次开机时间都会被重置,需要每次同步或更换电池。
第 8 类:配置文件语法错误或端口占用
现象:订阅导入成功,但切换到这个订阅时提示配置错误、内核启动失败,或提示端口被占用。
原因:
- 语法错误:手动编辑过订阅、加了“覆写”或“扩展脚本”,或者用第三方工具转换出的配置有缩进错误。YAML 对缩进很敏感,一个空格不对整份配置都会失败。
- 端口占用:Clash 默认要监听一个本地混合端口。其他代理软件(另一个 Clash 客户端、v2rayN 等)已经占用了同一端口,内核就启动不起来。
解决:
- 先把自己加的覆写、脚本全部停用,只用机场原始订阅测试。能用就说明问题出在自定义部分。
- 不要手动编辑机场订阅本身,下次更新会被覆盖。需要改规则,用客户端的覆写或合并功能。
- 端口冲突:彻底退出其他代理软件(包括系统托盘里的),或在 Clash Verge Rev 的“设置 → 端口设置”里把混合端口改成一个没被占用的数字,然后重启内核。
第 9 类:订阅被风控,需要重置链接
现象:提示 403、请求被拒绝、链接无效;或者流量莫名其妙消耗得很快。
原因:订阅链接相当于账号凭证。链接被分享、泄露到公开场合,或者短时间内被大量请求,机场可能会限制这个链接。你自己在用户中心重置过链接,旧链接也会立即失效。
解决:
- 登录用户中心,找到“重置订阅链接”(有的机场叫“重置订阅”“更换订阅地址”)。
- 重置后复制新的 Clash 订阅。
- 在每台设备上删除旧订阅,重新导入新链接。只更新不删除,旧链接会一直报错。
- 以后不要把订阅发到群里或截图分享。家人共用,直接导入同一个新链接即可。
完整演示:正确导入一次 Clash 订阅
唯兔云(WeituCloud)是一家以 IPLC 专线节点为主的机场服务,可以当作 VPN、外网加速器和代理 IP 使用,支持 Clash、Shadowrocket、v2rayN 等主流客户端。先打开 唯兔云官网 登录,再用它的订阅走一遍正确流程:
- 进入用户中心,确认套餐状态和剩余流量。
- 点“复制订阅链接”,选择 Clash 订阅。
- 打开 Clash Verge Rev,左侧点“订阅”,清空输入框后粘贴,点“导入”。
- 点击新出现的订阅卡片使它处于选中状态,到“代理”页选节点,再开启系统代理。
- 如果怀疑链接泄露,在用户中心点“重置订阅链接”,再按上面第 3 步重新导入。
完整的图文流程看 唯兔云使用教程。还没选好机场的话,可以看 唯兔云机场 的介绍,或者在 Clash 机场推荐 里对比其他支持 Clash 订阅的机场。
还解决不了怎么办
上面 9 类都排查过仍然失败,整理好下面这些信息再联系机场客服,能少来回好几轮:
- 客户端名称和版本号(在“设置”页底部能看到);
- 操作系统和版本;
- 报错截图,以及“日志”页里对应时间的几行记录(发之前把订阅链接里的 token 打码);
- 你已经做过的排查步骤。
同一个订阅在手机上能用、电脑上不能用,问题基本在电脑端;所有设备都不能用,问题更可能在订阅或账号本身。
结论
clash订阅导入失败,先做三件事:重新复制 Clash 格式订阅、确认套餐没过期、校准系统时间。客户端用 Clash Verge Rev 这类 Mihomo 内核客户端,别再用 Clash for Windows。更新失败时在“直连更新”和“代理更新”之间切换试试,链接可疑就直接重置。想系统了解客户端的设置,回到 Clash 教程。