连接排障 · Clash 技术博客

Clash Verge Rev 内核通信错误、代理页空白怎么修?

首页提示内核通信错误、代理页却一片空白时,先判断内核是否仍在转发,再按版本修复、重复进程、端口和防火墙顺序处理,避免误删订阅或盲目重装。

  • Clash Verge Rev
  • 内核通信错误
  • 代理页空白
  • Windows
本文目录

先确认是界面失联,还是内核真的没有启动

首页显示“内核通信错误”、当前节点为空,通常会让人以为代理已经完全停止。先不要删除订阅,也不要立刻改 DNS。打开“日志”和“连接”页面,再用浏览器访问一个新网页,观察是否出现刚才的域名和出站记录。

如果网页仍能打开,日志也持续出现 TCP 或 UDP 连接,说明 Mihomo 可能还在转发,只是桌面界面没有读到代理组和当前节点。近期官方 issue 就记录过这种状态:系统代理指向的本地端口仍能工作,运行时配置也包含节点,但首页和代理页无法读取控制信息。

先按表现分组

你看到的现象更可能的问题本文从哪里开始
网页能访问,日志持续新增,代理页空白界面与内核的控制通信异常先更新版本,再检查服务模式
网页不能访问,日志没有新连接内核未启动或请求没有进入客户端检查配置验证、服务和本地端口
订阅更新后节点数量为零订阅内容或解析失败回到订阅更新错误,不处理控制通道
只有一个网站失败规则、DNS 或目标站点兼容问题固定节点并查看该域名的命中记录

优先安装包含通信状态修复的正式版本

Clash Verge Rev v2.5.2 的官方发布说明列出了“修复首页代理卡片可能错误显示通信异常”“修复首页当前代理状态偶尔不同步”和“修复重新加载 Clash 配置后规则页面数据未及时刷新”。如果问题出现在 v2.5.1 或更早版本,更新正式版比修改控制器端口更直接。

从项目官方 Release 或本站标明来源的下载页选择与 Windows 架构一致的安装包。更新前导出日志并记下当前订阅名称,安装完成后完整退出一次客户端,再重新打开。不要同时改订阅、TUN、DNS 和服务模式,否则无法判断是哪一步起效。

一次可核对的更新

  1. 记录当前版本和错误

    在关于页面记下版本,截图首页提示和代理页状态,导出一份不含订阅链接的日志。

  2. 下载匹配架构的正式包

    大多数 Windows 电脑使用 x64,ARM Windows 设备才选择 ARM64;只从可追溯发布来源下载。

  3. 关闭客户端后安装

    先退出托盘中的 Clash Verge Rev,确认安装程序完成,再用普通用户身份启动。

  4. 只测试原来的 Profile

    暂时保持原节点、Rule 模式和系统代理设置,查看代理组是否恢复。

代理页仍为空时,查有没有两份内核抢同一个端口

更新后仍报错,先打开任务管理器的“详细信息”。正常服务模式下会看到桌面程序、服务进程和一份 Mihomo 内核;如果同时存在两份 verge-mihomo.exe,旧进程可能占着 mixed-port 或命名管道,新内核就无法完整启动。

不要一看到多个带 Clash 名称的进程就全部强制结束。先从托盘退出客户端,等几秒后再看 verge-mihomo.exe 是否仍有两份。若日志出现 bind、Only one usage、Access is denied 或 pipe listen error,才把重点放在残留进程、端口占用和服务状态。

把 7897 换成客户端当前显示的 Mixed 端口后检查
Get-Process clash-verge, verge-mihomo -ErrorAction SilentlyContinue

Get-NetTCPConnection -State Listen |
  Where-Object LocalPort -eq 7897 |
  Select-Object LocalAddress, LocalPort, OwningProcess

Get-Process -Id (Get-NetTCPConnection -State Listen |
  Where-Object LocalPort -eq 7897 |
  Select-Object -First 1 -ExpandProperty OwningProcess)

命令只用于确认监听者,不会结束进程。Mixed 端口可能不是 7897,应以客户端设置或日志里的实际值替换。看到单个 verge-mihomo.exe 正常监听,且日志已经出现代理请求,就不要继续把问题当成端口冲突。

日志里的第一条错误决定下一步

服务模式启动时,客户端会先生成运行时配置并验证,再让服务启动内核,最后通过控制接口读取代理组。只看末尾的“通信错误”会漏掉真正失败的位置。重新启动一次后,从日志顶部往下找第一条 error。

配置验证失败、Invalid YAML 或 unsupported field

问题发生在 Profile 或覆写。切回未修改的订阅,暂时停用 Merge、脚本和自定义字段,再重新验证。

mixed port bind failed、Only one usage

本地端口已被旧内核或其他程序占用。退出客户端,确认监听进程,再重启 Windows 清理残留状态。

pipe listen error、Access is denied

服务创建控制通道失败或权限不一致。先重启客户端服务,仍失败再重新安装服务模式。

配置验证成功、端口和 pipe 都在监听,但界面仍报错

更像桌面界面读取控制信息失败。确认已经更新正式版,并导出日志提交给项目 issue,不要继续改节点。

内核启动成功,但没有任何新连接

检查 Windows 系统代理是否仍指向当前 Mixed 端口;若使用 TUN,再确认虚拟网卡是否真正开启。

Windows 防火墙只做一次可回退的刷新

Clash Verge Rev 官方 Windows FAQ 把“代理菜单空白”归因到内核通信失败,并建议关闭再开启 Windows 防火墙。这里的重点是让防火墙规则重新加载,不是长期关闭防护。

先在 Windows 安全中心打开“防火墙和网络保护”,记下当前网络类型。短暂关闭对应网络的 Microsoft Defender 防火墙,立即重新打开,然后退出并重启 Clash Verge Rev。若公司电脑由管理员策略控制,不要绕过策略,直接把日志交给管理员检查应用和本地通信规则。

防火墙刷新后确认

  • Microsoft Defender 防火墙已经重新开启
  • 没有为了测试而新增面向公网的入站端口
  • Clash Verge Rev 和服务进程没有被安全软件隔离
  • 重新打开客户端后,代理组能显示并可切换节点

配置里有节点,不代表界面一定能读到

订阅下载、运行时配置和代理页展示是三个不同阶段。订阅页显示更新时间,只能证明地址保存并完成过一次处理;运行时 YAML 里出现 proxies 和 proxy-groups,说明内核拿到了节点;代理页还要通过控制接口读取这些组。

近期官方诊断记录中,运行时配置包含代理与策略组,Mixed 端口也在转发,但 external-controller 为空,只剩命名管道供桌面界面读取。这种情况下自行开放 HTTP 控制器并不是首选修复,还可能扩大管理接口暴露。应先完成正式版更新、服务重启和防火墙刷新。

三个阶段怎么验证

阶段有效证据失败时不要做什么
订阅下载更新成功并显示真实节点数量不要只看订阅名称已经出现
内核运行日志显示配置验证成功、端口监听和真实连接不要用首页卡片单独判断内核已死
界面控制代理组可见、当前节点可读且切换生效不要为让界面恢复而公开 external-controller

确认服务异常后,再重装服务模式

只有日志明确指向服务、管道权限或重复内核,并且更新与防火墙刷新都无效时,才处理服务模式。先关闭系统代理和 TUN,确认普通网络恢复,再从客户端设置中的服务模式入口卸载服务,重启 Windows 后重新安装。

重装服务不会修复失效订阅,也不该成为每次代理页空白的固定动作。若重启后没有管理员权限、按钮被策略禁用或服务安装被安全软件拦截,应停止反复尝试,保留导出的应用日志与服务日志。

安全恢复顺序

  1. 先恢复 Windows 直连

    关闭系统代理和 TUN,用浏览器确认退出客户端后普通网页仍能打开。

  2. 备份 Profile 与日志

    不要公开订阅 URL、节点密码或控制器 secret,问题报告只附脱敏片段。

  3. 卸载并重启

    通过客户端提供的服务模式入口卸载,不手动删除系统服务文件;完成后重启 Windows。

  4. 重新安装服务模式

    用客户端正常入口申请管理员权限,启动后只启用原 Profile 做验证。

  5. 仍失败就停止改配置

    附版本、系统架构、第一条 error、进程与端口结果,提交到官方 issue。

修复完成要同时通过五项检查

代理页重新出现并不等于问题彻底结束。最后用同一份 Profile、同一个节点完成一次从界面到真实访问的闭环,才能确认服务、控制通道和转发都恢复。

完成标准

  • 首页不再显示内核通信错误,当前代理模式与节点名称可读
  • 代理页能看到完整策略组,切换节点后选中状态立即更新
  • 任务管理器中只有一份正在工作的 verge-mihomo.exe
  • 浏览器访问测试网站时,连接页出现对应域名、规则和出站
  • 退出客户端后 Windows 系统代理会关闭,普通网络能够恢复

参考资料

核对日期:2026.07.29