Clash Verge 报错、Clash Verge 无法连接:六类常见问题处理
对号入座
| 现象 | 最常见的原因 | 对应小节 |
|---|---|---|
| 粘贴链接后提示导入失败 | 链接格式不对、订阅域名访问不了 | 导入订阅失败 |
| 开关都打开了,浏览器还是上不去 | 模式是直连、没选节点、浏览器插件接管了代理 | 系统代理没效果 |
| TUN 开关打不开或自动弹回 | 没有管理员权限、服务没安装、与其他软件冲突 | TUN 开启失败 |
| 启动报错,提示端口相关信息 | 端口被另一个程序占用 | 端口被占用 |
| 退出软件后所有网站都打不开 | 系统代理设置没有被还原 | 关闭后断网 |
| 升级后节点不见了或启动失败 | 配置格式变化、覆写内容不兼容 | 更新后配置异常 |
本文的界面描述尽量用通用说法,不同版本的菜单文字可能有出入,以你安装的版本为准。基础用法见 Clash Verge Rev 使用教程。
导入订阅失败
导入订阅这个动作,是软件去访问订阅链接、把配置文件下载下来。失败的原因就出在「访问」和「内容」两个环节。
- 检查链接是否完整。 重新到机场用户中心复制一次,不要从聊天记录里复制,长链接容易被截断或夹进空格。
- 确认是 Clash 格式。 机场通常提供多种格式的订阅链接。复制成了其他客户端专用的格式,软件就解析不了。在用户中心选择标着 Clash 或 Clash Meta 的那一个。
- 确认订阅域名能访问。 把链接粘贴到浏览器地址栏打开。能看到一大段配置文本或者触发下载,说明链接是通的;打不开,说明当前网络访问不了订阅域名。
- 域名访问不了时。 到机场公告里找备用订阅地址;或者在已经有可用节点的情况下,在订阅的编辑选项里开启「通过代理更新」一类的选项再试。
- 改用本地文件导入。 在浏览器里把配置文件下载下来,再拖进订阅页面,或者用新建本地配置的方式导入。
- 确认机场是否支持。 只提供自研客户端的机场没有通用订阅链接,无法在 Clash Verge Rev 里使用。
订阅相关的更多细节见订阅导入与更新教程。
系统代理开了没效果
开关显示已打开,但浏览器还是访问不了国外网站。按下面的顺序检查。
- 有没有选中订阅和节点。 订阅页里要点一下订阅卡片使其成为当前配置;代理页里要选中一个延迟正常的节点。
- 模式是不是「直连」。 直连模式下所有流量都不走代理。切回「规则」。
- 节点本身是否可用。 测一下延迟,全部超时的话问题不在系统代理,见节点全部超时怎么办。
- 浏览器插件是否接管了代理。 装过代理切换类插件的浏览器,会优先使用插件里的设置,系统代理对它无效。把插件切换到「使用系统代理」或暂时停用。
- 有没有其他代理软件在抢。 同时运行两个代理客户端,后启动的会覆盖系统代理设置。只保留一个。
- 到系统设置里确认。 Windows 在「设置 → 网络和 Internet → 代理」,macOS 在「系统设置 → 网络 → 当前网络的详细信息 → 代理」。里面的地址应该是
127.0.0.1,端口和软件里显示的一致。不一致说明设置没写进去或被别的程序改了。 - 这个程序是否遵守系统代理。 系统代理只对读取它的程序有效。终端、部分桌面软件和游戏不读,需要 TUN 模式或单独设置,见终端代理设置教程。
Windows 上还有一个特殊情况:从应用商店安装的应用默认不允许访问本机回环地址,所以它们用不了本地代理。软件的设置里一般有专门处理这个限制的工具入口,或者直接改用 TUN 模式。
TUN 模式开启失败
TUN 模式要在系统里创建虚拟网卡并修改路由,这些操作需要高权限,所以失败多与权限有关。
- 安装服务。 软件通过一个系统服务来获得所需权限。在设置页找到与服务模式相关的选项,按提示安装,过程中会要求输入系统密码或确认管理员授权。
- 确认服务在运行。 安装后设置页一般会显示服务状态。显示未运行时,尝试重新安装服务,或者重启电脑。
- Windows 上以管理员身份运行一次。 服务装不上时,退出软件,右键选择以管理员身份运行,再安装服务。
- macOS 上留意系统的授权弹窗。 弹窗被忽略或点了拒绝,服务就装不上,重新操作一次并允许。
- 关闭冲突的软件。 其他 VPN、另一个开着 TUN 的代理软件、部分带网络防护功能的安全软件,都可能占用或拦截虚拟网卡。先退出它们再试。
- TUN 开了但没网。 多与 DNS 有关。把 TUN 相关设置和 DNS 设置恢复为默认值,再对照 Clash DNS 设置检查。
系统代理和 TUN 的区别与取舍见系统代理与 TUN 模式。
端口被占用
软件启动时需要在本机监听一个端口来接收代理请求。这个端口被别的程序占着,内核就起不来,日志里会出现端口已被使用之类的字样(英文常见 address already in use)。
最简单的解决办法是换一个端口:
- 打开设置页,找到端口设置(混合端口);
- 改成另一个没人用的数字,比如在原来的基础上加 1;
- 保存并重启内核或重启软件;
- 之前在终端、git、编辑器里写死过旧端口的,记得同步改掉。
想知道是谁占了端口(以 7890 为例,换成你自己的端口号):
- Windows:在命令提示符里执行
netstat -ano | findstr :7890,最后一列是进程编号,到任务管理器的详细信息里按编号找到对应程序。 - macOS / Linux:在终端执行
lsof -i :7890,输出里有程序名称和进程编号。
常见的占用者是另一个代理客户端,或者软件上次没有正常退出、内核进程还残留在后台。后一种情况在任务管理器或活动监视器里结束残留进程,或者直接重启电脑。
关闭软件后断网
退出软件后所有网页都打不开,原因几乎都是:系统代理设置还指向本地端口,但软件已经不在了,请求发到一个没人接的地址。
- 重新打开软件,先在设置页关闭「系统代理」,再退出;
- 或者到操作系统的代理设置里手动关闭代理(位置见前文);
- 浏览器装了代理插件的,把插件切回直接连接或系统代理;
- TUN 模式下异常退出的,重新打开软件、关闭 TUN 再退出,仍不行就重启电脑,让网络设置恢复;
- 之前给 git、npm 或终端设置过代理的,它们会一直报连接被拒绝,直到你取消那些设置。
更新后配置异常
升级软件后出现节点列表为空、配置加载失败、启动报错,通常是三种原因。
- 内核升级后对配置的检查更严格。 以前能容忍的写法现在报错。先更新一次订阅,让机场下发的配置重新拉取。
- 自己写的覆写或脚本不兼容。 用过全局扩展配置、扩展脚本的,先把它们停用或清空,确认是不是它们引起的,再逐段加回去。
- 旧数据残留。 跨了很多个版本升级时,旧的配置目录结构可能和新版本不匹配。
处理步骤:
- 查看日志页,报错信息里通常会指出是哪一行、哪一项配置有问题;
- 更新订阅;
- 停用自定义的覆写内容;
- 仍然不行,在设置页找到打开配置目录的入口,把整个目录备份到别处,然后删除订阅重新导入;
- 确认安装包来自官方 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 与节点线路问题。
安卓代理客户端后台被杀、锁屏后断网怎么办?四项通用设置与各品牌入口
安卓 VPN 后台被杀、Clash 安卓锁屏后断开,多半是定制系统的后台管理清理了客户端。通用处理是允许自启动、关闭电池优化、在多任务界面锁定、开启始终开启的 VPN。本文说明各品牌手机上该找哪一类设置项。
机场订阅更新失败怎么办?Clash 订阅无法更新的五种常见原因与处理顺序
订阅更新失败、Clash 订阅无法更新,常见原因有订阅域名访问不了、链接被重置或失效、套餐到期、客户端通过失效的代理去更新、格式不匹配。本文给出对照表,以及浏览器验证、切换更新方式、手动导入配置文件的步骤。
开了代理网页还是打不开?DNS 解析失败与 DNS 污染的原因和排查步骤
开了代理网页还是打不开,常见原因是 DNS 解析失败或 DNS 污染。本文讲清代理客户端如何处理 DNS,并给出恢复默认 DNS 设置、清除系统 DNS 缓存、检查浏览器安全 DNS 的排查顺序。