问题诊断

Clash Verge 报错、Clash Verge 无法连接:六类常见问题处理

更新于 · 约 13 分钟读完 · 登机口编辑整理

对号入座

现象 最常见的原因 对应小节
粘贴链接后提示导入失败 链接格式不对、订阅域名访问不了 导入订阅失败
开关都打开了,浏览器还是上不去 模式是直连、没选节点、浏览器插件接管了代理 系统代理没效果
TUN 开关打不开或自动弹回 没有管理员权限、服务没安装、与其他软件冲突 TUN 开启失败
启动报错,提示端口相关信息 端口被另一个程序占用 端口被占用
退出软件后所有网站都打不开 系统代理设置没有被还原 关闭后断网
升级后节点不见了或启动失败 配置格式变化、覆写内容不兼容 更新后配置异常

本文的界面描述尽量用通用说法,不同版本的菜单文字可能有出入,以你安装的版本为准。基础用法见 Clash Verge Rev 使用教程。

导入订阅失败

导入订阅这个动作,是软件去访问订阅链接、把配置文件下载下来。失败的原因就出在「访问」和「内容」两个环节。

  1. 检查链接是否完整。 重新到机场用户中心复制一次,不要从聊天记录里复制,长链接容易被截断或夹进空格。
  2. 确认是 Clash 格式。 机场通常提供多种格式的订阅链接。复制成了其他客户端专用的格式,软件就解析不了。在用户中心选择标着 Clash 或 Clash Meta 的那一个。
  3. 确认订阅域名能访问。 把链接粘贴到浏览器地址栏打开。能看到一大段配置文本或者触发下载,说明链接是通的;打不开,说明当前网络访问不了订阅域名。
  4. 域名访问不了时。 到机场公告里找备用订阅地址;或者在已经有可用节点的情况下,在订阅的编辑选项里开启「通过代理更新」一类的选项再试。
  5. 改用本地文件导入。 在浏览器里把配置文件下载下来,再拖进订阅页面,或者用新建本地配置的方式导入。
  6. 确认机场是否支持。 只提供自研客户端的机场没有通用订阅链接,无法在 Clash Verge Rev 里使用。

订阅相关的更多细节见订阅导入与更新教程。

系统代理开了没效果

开关显示已打开,但浏览器还是访问不了国外网站。按下面的顺序检查。

  1. 有没有选中订阅和节点。 订阅页里要点一下订阅卡片使其成为当前配置;代理页里要选中一个延迟正常的节点。
  2. 模式是不是「直连」。 直连模式下所有流量都不走代理。切回「规则」。
  3. 节点本身是否可用。 测一下延迟,全部超时的话问题不在系统代理,见节点全部超时怎么办。
  4. 浏览器插件是否接管了代理。 装过代理切换类插件的浏览器,会优先使用插件里的设置,系统代理对它无效。把插件切换到「使用系统代理」或暂时停用。
  5. 有没有其他代理软件在抢。 同时运行两个代理客户端,后启动的会覆盖系统代理设置。只保留一个。
  6. 到系统设置里确认。 Windows 在「设置 → 网络和 Internet → 代理」,macOS 在「系统设置 → 网络 → 当前网络的详细信息 → 代理」。里面的地址应该是 127.0.0.1,端口和软件里显示的一致。不一致说明设置没写进去或被别的程序改了。
  7. 这个程序是否遵守系统代理。 系统代理只对读取它的程序有效。终端、部分桌面软件和游戏不读,需要 TUN 模式或单独设置,见终端代理设置教程。

Windows 上还有一个特殊情况:从应用商店安装的应用默认不允许访问本机回环地址,所以它们用不了本地代理。软件的设置里一般有专门处理这个限制的工具入口,或者直接改用 TUN 模式。

TUN 模式开启失败

TUN 模式要在系统里创建虚拟网卡并修改路由,这些操作需要高权限,所以失败多与权限有关。

  1. 安装服务。 软件通过一个系统服务来获得所需权限。在设置页找到与服务模式相关的选项,按提示安装,过程中会要求输入系统密码或确认管理员授权。
  2. 确认服务在运行。 安装后设置页一般会显示服务状态。显示未运行时,尝试重新安装服务,或者重启电脑。
  3. Windows 上以管理员身份运行一次。 服务装不上时,退出软件,右键选择以管理员身份运行,再安装服务。
  4. macOS 上留意系统的授权弹窗。 弹窗被忽略或点了拒绝,服务就装不上,重新操作一次并允许。
  5. 关闭冲突的软件。 其他 VPN、另一个开着 TUN 的代理软件、部分带网络防护功能的安全软件,都可能占用或拦截虚拟网卡。先退出它们再试。
  6. TUN 开了但没网。 多与 DNS 有关。把 TUN 相关设置和 DNS 设置恢复为默认值,再对照 Clash DNS 设置检查。

系统代理和 TUN 的区别与取舍见系统代理与 TUN 模式。

端口被占用

软件启动时需要在本机监听一个端口来接收代理请求。这个端口被别的程序占着,内核就起不来,日志里会出现端口已被使用之类的字样(英文常见 address already in use)。

最简单的解决办法是换一个端口:

  1. 打开设置页,找到端口设置(混合端口);
  2. 改成另一个没人用的数字,比如在原来的基础上加 1;
  3. 保存并重启内核或重启软件;
  4. 之前在终端、git、编辑器里写死过旧端口的,记得同步改掉。

想知道是谁占了端口(以 7890 为例,换成你自己的端口号):

  • Windows:在命令提示符里执行 netstat -ano | findstr :7890,最后一列是进程编号,到任务管理器的详细信息里按编号找到对应程序。
  • macOS / Linux:在终端执行 lsof -i :7890,输出里有程序名称和进程编号。

常见的占用者是另一个代理客户端,或者软件上次没有正常退出、内核进程还残留在后台。后一种情况在任务管理器或活动监视器里结束残留进程,或者直接重启电脑。

关闭软件后断网

退出软件后所有网页都打不开,原因几乎都是:系统代理设置还指向本地端口,但软件已经不在了,请求发到一个没人接的地址。

  1. 重新打开软件,先在设置页关闭「系统代理」,再退出;
  2. 或者到操作系统的代理设置里手动关闭代理(位置见前文);
  3. 浏览器装了代理插件的,把插件切回直接连接或系统代理;
  4. TUN 模式下异常退出的,重新打开软件、关闭 TUN 再退出,仍不行就重启电脑,让网络设置恢复;
  5. 之前给 git、npm 或终端设置过代理的,它们会一直报连接被拒绝,直到你取消那些设置。

更新后配置异常

升级软件后出现节点列表为空、配置加载失败、启动报错,通常是三种原因。

  • 内核升级后对配置的检查更严格。 以前能容忍的写法现在报错。先更新一次订阅,让机场下发的配置重新拉取。
  • 自己写的覆写或脚本不兼容。 用过全局扩展配置、扩展脚本的,先把它们停用或清空,确认是不是它们引起的,再逐段加回去。
  • 旧数据残留。 跨了很多个版本升级时,旧的配置目录结构可能和新版本不匹配。

处理步骤:

  1. 查看日志页,报错信息里通常会指出是哪一行、哪一项配置有问题;
  2. 更新订阅;
  3. 停用自定义的覆写内容;
  4. 仍然不行,在设置页找到打开配置目录的入口,把整个目录备份到别处,然后删除订阅重新导入;
  5. 确认安装包来自官方 GitHub 发布页,并且选对了系统和芯片架构对应的版本。

提交问题给机场客服或开源社区时,带上软件版本、内核版本、操作系统和日志里的报错原文,比描述「用不了」有效得多。订阅链接等同于账号凭证,截图和粘贴日志时注意遮挡。

软件打不开或内核启动失败

前面几节的前提是软件能正常打开。如果连窗口都出不来,或者打开后提示内核没有运行,原因和订阅、节点都无关,要从软件本身查。

现象 常见原因 处理
双击后没有任何反应,或窗口一片空白 Windows 上缺少界面依赖的 WebView2 组件,或组件损坏 安装或修复系统的 WebView2 运行时;发布页有内置该组件的安装包时也可以换用它
窗口能开,但提示内核未运行、代理页为空 内核进程启动失败 看日志里的第一条错误,多数是端口冲突或配置有误
安装后程序文件不见了,或启动时报找不到文件 安全软件把内核或服务程序隔离了 确认安装包来自官方发布页后,在安全软件里恢复文件并加入信任
上次还好好的,重启电脑后起不来 上次异常退出,残留的内核进程占着端口 在任务管理器或活动监视器里结束残留进程,再启动

内核启动失败时,处理顺序是:先看日志定位,再换端口,然后在设置页里重启内核或重新安装服务,最后才考虑重装软件。重装之前把配置目录备份一下,订阅和自定义内容都在里面。

日志里常见的报错文字对应什么

日志看起来很长,真正有用的往往只有一两个关键词。下面是出现频率最高的几类,文字以内核实际输出为准,这里列的是其中的关键部分。

日志里的关键词 意思 往哪里查
i/o timeout、context deadline exceeded 在规定时间内没有等到对方回应 节点不通、套餐到期,或当前网络屏蔽了节点端口
connection refused 对方明确拒绝了连接 节点端口没有开放,或者本机要连的端口上没有程序在监听
no such host 域名解析不出来 DNS 设置,或节点域名已经更换,先更新订阅
x509、certificate、tls 相关报错 证书校验或加密握手失败 系统时间是否准确;所在网络是否对加密流量做了拦截
address already in use,或提示套接字地址只允许使用一次 端口被占用 见前面的「端口被占用」
permission denied、operation not permitted、拒绝访问 权限不够 TUN 相关操作没有拿到管理员权限,重新安装服务
unsupport、unsupported 加上协议或字段名 内核不认识配置里的某个协议或字段 更新软件和内核
yaml: 开头并带有行号 配置文件格式错误 到提示的那一行检查缩进、冒号和引号;多半出在自己写的扩展内容里
EOF、connection reset 连接被中途断开 节点不稳定或线路干扰,换节点对比

用日志排查有两个小技巧。一是先清空日志,再复现一次问题,这样留下的都是相关的记录。二是用日志页的筛选功能只看错误和警告,或者搜索出问题的域名,不用从头读到尾。

需要分清的是报错发生在哪一段。i/o timeout 出现在连接节点服务器的记录里,说明节点本身连不上;出现在通过节点访问某个网站的记录里,说明节点是通的,只是那个网站在这个节点上访问不了。前者换节点或查订阅,后者换一个地区的节点试试。

常见问题

日志在哪里看,看不懂怎么办?

软件侧边栏里一般有日志页。看不懂全文没关系,找级别为错误或警告的那几行,里面的关键词(端口、权限、解析失败、超时)基本就指明了问题属于本文的哪一类。

延迟测试全是超时,但网页能打开,正常吗?

可能是延迟测试用的网址在当前节点上访问不畅,属于测试结果不准,不影响使用。可以在设置里更换延迟测试网址,或者把超时时间调长。

用旧版 Clash Verge 可以吗,一定要换成 Rev 吗?

原版已经停止维护,不再适配新协议和新系统版本,遇到问题也没有人修。建议迁移到仍在更新的版本,其他可选客户端见客户端怎么选。

窗口一片空白或者根本打不开怎么办?

Windows 上最常见的原因是系统缺少 WebView2 组件或组件损坏,软件界面依赖它来显示。安装或修复 WebView2 运行时后再试;官方发布页如果提供了内置该组件的安装包,也可以改装那个版本。安全软件隔离了程序文件时也会出现类似现象。

日志里的 i/o timeout 是什么意思?

表示一次连接在规定时间里没有等到回应。看它出现在哪条记录里:连接节点服务器时超时,说明节点不通或被当前网络屏蔽;通过节点访问某个网站时超时,说明节点正常、目标网站在这个节点上不可达。前者先更新订阅和换节点,后者换其他地区的节点。

机场说节点正常,我这里部分节点却一直连不上,会是软件的原因吗?

有可能是内核版本过旧。机场启用较新的协议后,旧内核不认识这些节点,表现为节点不显示或一直超时。把软件更新到官方发布页的最新版本,再重新更新订阅对比一次。

接下来看什么

软件本身没问题、症状出在节点和线路上的,继续看订阅连不上排查。

本文中的套餐与价格整理自公开资料,核对日期为 2026年11月14日,未经本站实测,购买前请以官网为准。整理方法见这里。

接着读

问题诊断

机场连接不上怎么办:订阅连不上、节点超时按症状排查的 7 个步骤

机场节点全部超时、订阅更新失败、能连上但打不开网页、晚上特别慢?按症状一步步排查:套餐状态、订阅更新、系统时间、代理模式、DNS 与节点线路问题。

更新11/1612 分钟
问题诊断

安卓代理客户端后台被杀、锁屏后断网怎么办?四项通用设置与各品牌入口

安卓 VPN 后台被杀、Clash 安卓锁屏后断开,多半是定制系统的后台管理清理了客户端。通用处理是允许自启动、关闭电池优化、在多任务界面锁定、开启始终开启的 VPN。本文说明各品牌手机上该找哪一类设置项。

更新11/1612 分钟
问题诊断

机场订阅更新失败怎么办?Clash 订阅无法更新的五种常见原因与处理顺序

订阅更新失败、Clash 订阅无法更新,常见原因有订阅域名访问不了、链接被重置或失效、套餐到期、客户端通过失效的代理去更新、格式不匹配。本文给出对照表,以及浏览器验证、切换更新方式、手动导入配置文件的步骤。

更新11/1612 分钟
问题诊断

开了代理网页还是打不开?DNS 解析失败与 DNS 污染的原因和排查步骤

开了代理网页还是打不开,常见原因是 DNS 解析失败或 DNS 污染。本文讲清代理客户端如何处理 DNS,并给出恢复默认 DNS 设置、清除系统 DNS 缓存、检查浏览器安全 DNS 的排查顺序。

更新11/1613 分钟