1 为什么 Clash Verge Rev 会提示内核更新失败
Clash Verge Rev 在启动或你点击「更新内核」时,需要从上游拉取与当前客户端匹配的 Mihomo(Clash.Meta) 可执行文件。若本机完全离线、DNS 异常、HTTPS 被中间人替换,或公司网络禁止访问 GitHub / 对象存储类域名,下载阶段就会报错,界面便表现为内核更新失败。
另一类常见情况是权限:Windows 默认把主程序与内核装在受保护的 Program Files 目录,普通用户会话内发起的自动更新若未提升到管理员,可能无法覆盖旧的 verge-mihomo.exe。macOS 上若你使用非管理员账户、或安全软件锁定应用包,也可能出现同类现象——这与「机场订阅坏了」无关,却常被误判成线路问题。
手动替换的思路是:在已确认架构的前提下,用你信任渠道获得的 Mihomo 产物,以与客户端约定完全一致的文件名覆盖安装目录内的内核,再完全退出并重启客户端,让服务或子进程重新加载新二进制。下文按 Windows、macOS 分别给出默认路径与推荐顺序。
2 动手前:务必完全退出,并分清稳定版与 Alpha
替换前请完全退出 Clash Verge Rev:托盘图标右键退出,并确认任务管理器或活动监视器里不再长期驻留 verge-mihomo 相关进程。Windows 若启用了服务模式,日志里常见由服务拉起内核,此时仅关 UI 窗口不够,需在客户端内先停核心或服务,再执行文件替换,否则会遇到「文件正在使用无法覆盖」。
客户端通常提供稳定版与 Alpha 两套内核通道,对应文件名并不相同。Windows 默认安装目录下常见为 verge-mihomo.exe(稳定)与 verge-mihomo-alpha.exe(Alpha);macOS 则在应用包的 Contents/MacOS/ 下对应 verge-mihomo 与 verge-mihomo-alpha。你在设置里当前选中哪条通道,就替换哪一个文件,避免「界面显示 Alpha、磁盘上却是稳定版」的错位。
强烈建议先把原文件重命名备份(例如改为 verge-mihomo.exe.bak),而不是直接删除。一旦新文件不兼容或权限异常,可快速改回旧名恢复在线。若尚未安装客户端,可先到本站 下载页 获取对应系统的安装包,完成安装后再按本文替换内核。
3 Windows:Mihomo 内核默认装在哪
使用官方安装包默认路径时,GUI 主程序与内核通常位于 C:\Program Files\Clash Verge\。其中与本文相关的文件名为 verge-mihomo.exe(稳定通道)以及 verge-mihomo-alpha.exe(Alpha 通道)。社区 Issue 与日志中常见的 bin_path 亦指向该目录下的可执行文件。
配置与日志并不和内核挤在同一目录:应用数据多在 %APPDATA%\io.github.clash-verge-rev.clash-verge-rev\(展开为 C:\Users\用户名\AppData\Roaming\io.github.clash-verge-rev.clash-verge-rev\)。手动更新内核时一般不需要动这里,除非你同时在做整夹备份——那属于换机迁移范畴。
若安装时自定义了目录,请以资源管理器打开实际安装路径,搜索 verge-mihomo 确认文件名与数量。便携版或解压运行的场景,内核可能与 clash-verge.exe 同级,原则不变:谁被日志里的 bin_path 指向,就替换谁。
4 Windows:手动替换步骤(含权限)
- 退出 Clash Verge Rev;若使用服务,先在应用内停止核心或按文档卸载服务后再继续。
- 以管理员身份打开资源管理器,或使用「复制—在目标目录粘贴」时同意 UAC 提升。
- 进入
C:\Program Files\Clash Verge\,将当前的verge-mihomo.exe(或 alpha 对应文件)重命名为带.bak的备份。 - 把新下载的内核文件复制进来,并重命名为与被替换文件完全一致的原名。
- 重新启动 Clash Verge Rev,在关于或内核信息处确认版本号;必要时在日志中查看本次启动的
bin_path是否仍指向预期位置。
若粘贴时持续提示拒绝访问,优先检查是否仍有 verge-mihomo.exe 被服务账户占用;可在「服务」管理器中临时停止 Clash Verge 相关服务后再试。完成替换后别忘了按客户端引导重新启用服务,以免 TUN 或系统代理无法拉起内核。
5 macOS:内核在应用包里的什么位置
将应用拖入「应用程序」后,默认路径为 /Applications/Clash Verge.app。Mihomo 内核作为 sidecar 二进制,位于 Clash Verge.app/Contents/MacOS/ 目录下:稳定通道文件名为 verge-mihomo,Alpha 为 verge-mihomo-alpha。这与官方日志里 bin_path 字段的常见写法一致。
资源文件(如 Country.mmdb、geoip.dat)多在 Contents/Resources/resources/ 下由客户端同步到用户 Application Support;它们与「内核可执行文件」是两条更新线。若你遇到的是分流误判、GEOIP 过期,应优先阅读《GeoIP / Geosite 手动更新》,而不是只换内核。
用户配置与运行时 YAML 仍在 ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/,替换内核前同样建议完全退出应用,避免文件占用。
6 macOS:替换步骤、隔离属性与签名说明
- 退出 Clash Verge Rev(菜单栏图标退出,并确认活动监视器无残留相关进程)。
- 在 Finder 中对
Clash Verge.app右键「显示包内容」,进入Contents/MacOS/。 - 将现有
verge-mihomo(或 alpha)重命名为备份文件名。 - 拷入新二进制并命名为与原文件完全一致;若从网络下载,建议在终端对新文件执行清除隔离属性(见下方示例)。
- 重新打开应用,在界面或日志中确认内核版本;若系统提示安全性相关拦截,按官方发行说明或「隐私与安全性」中的提示处理。
手动替换会改变应用包内容,可能与原始公证状态不一致;若遇「应用已损坏」类提示,可先核对是否拷错架构(Intel vs Apple Silicon),再尝试从本站 下载页 获取完整 .app 安装包覆盖安装——往往比长期手工维护包内二进制更省心。
# Clear quarantine on the newly copied binary (adjust path to your file)
xattr -cr "/Applications/Clash Verge.app/Contents/MacOS/verge-mihomo"
7 如何校验 Mihomo 版本真的已经更新
最直观的方式是在 Clash Verge Rev 的关于 / 内核信息界面查看当前核心版本号,是否与预期一致。若界面缓存未刷新,可完全退出再打开,或切换一次内核通道后再切回,强制触发重新探测。
进阶用户可在终端直接对二进制查询版本(需使用你在磁盘上实际替换的那份路径)。Mihomo 系核心普遍支持 -v 打印版本;若命令无输出,以客户端界面与启动日志为准。
# Windows (cmd or PowerShell, adjust path if install dir differs)
"C:\Program Files\Clash Verge\verge-mihomo.exe" -v
# macOS
"/Applications/Clash Verge.app/Contents/MacOS/verge-mihomo" -v
同时建议在日志中搜索最近一次 start service 记录,确认 bin_path 指向你刚替换的文件,而不是备份名或旧路径。这样可以把「文件拷对了但进程仍读旧文件」的情况一次性排除。
8 去哪里下载与当前系统匹配的内核文件
Mihomo 上游会在 Release 页提供各平台、各架构的预编译产物。你需要选择与本机 CPU 架构一致的包:Windows 常见为 amd64;macOS 需区分 Apple Silicon(arm64)与 Intel(amd64)。下载后解压得到的核心可执行文件,往往名为 mihomo 或带平台后缀的 .exe,必须重命名为客户端正在使用的那份文件名(verge-mihomo.exe、verge-mihomo-alpha.exe 或 macOS 下无扩展名的对应名),否则 GUI 仍会去加载旧路径下的旧名字。
内核版本与 Clash Verge Rev 主程序版本之间存在兼容区间;跨度过大的组合可能导致 API 不匹配。优先选择与当前客户端发行说明推荐接近的 Mihomo 版本,或在社区 Release 说明中核对「最低内核版本」。若你只追求「能跑起来」,宁可略保守也不要盲目追最新 commit 构建。
需要自行拉取上游预编译包时,可查阅 MetaCubeX Mihomo 仓库的 Release 说明与校验方式;这与「获取 Clash Verge Rev 安装包」不同——安装/升级 GUI 客户端仍建议以本站 下载页 为入口,便于版本管理与安全提示,与从 Release 单独取内核文件并不冲突。
9 别把「内核更新失败」与 Geo 数据库搞混
有时日志里同时出现 Geo 文件下载失败与内核更新失败,症状都像「上不了网」,但修法不同。GeoIP、Geosite 数据多落在用户 Application Support 或应用资源目录,由客户端的「更新 Geo」一类入口维护;单纯替换 verge-mihomo 不会自动修复损坏或过期的 Country.mmdb。
若规则大量依赖 GEOIP,CN 或 geosite 分类,而数据库版本过旧,会表现为国内站点误走代理或海外站点直连。此时应按Geo 手动更新专题替换数据文件,并与本文内核步骤分开验收,避免反复在同一个错误层级上打转。
10 替换后仍异常:按顺序排查
- 进程未停干净:Windows 查服务与任务管理器;macOS 查活动监视器是否仍有
verge-mihomo。 - 文件名或通道不一致:界面选 Alpha 却只替换了稳定文件名,或反之。
- 架构错误:在 arm64 Mac 上误放 amd64 二进制,或 Windows on ARM 误用 x64 包而未使用兼容层。
- 权限与只读挂载:安装目录在受管控磁盘、网络盘或只读卷上,导致无法覆盖。
- 版本不兼容:内核过新或过旧,日志出现 API、字段解析类错误——此时回滚
.bak并换与客户端匹配的 Release 版本。
若以上均排除,可暂时回退到备份内核,改用完整重装最新版 Clash Verge Rev 的方式获取官方捆绑核心,再导入原有配置目录。对大多数用户而言,这比长期手工维护 Program Files 或 .app 内二进制更稳定。
bin_path 正确、Rule 模式下国内外站点各抽测一两个域名。四项都过,即可认为本次手动更新成功。
11 总结
Clash Verge Rev 的 Mihomo 内核更新失败,多数可归结为网络拉取失败、安装目录权限不足或通道与文件名不一致。通过本文给出的 Windows(Program Files\Clash Verge\verge-mihomo.exe 等)与 macOS(Clash Verge.app/Contents/MacOS/verge-mihomo)默认内核文件路径,在完全退出进程、做好 .bak 备份后手动覆盖,再配合界面与命令行校验版本与日志 bin_path,通常能一次性恢复自动更新不可用时的自救能力。
与 mixin 覆写、订阅转换等「配置层」话题不同,内核替换属于「运行时二进制层」操作:步骤少但对权限与命名要求苛刻。把 Geo 数据、应用数据目录与内核文件三条线分开理解,排查会清晰很多。相比在论坛零散搜路径,按平台对照执行更不容易漏掉服务模式或 Alpha 文件名这类细节。
若你希望从可信渠道先装好客户端,再在必要时按本文替换 Mihomo 内核,整体可预期性会明显好于盲目重装系统或反复导入订阅。Clash Verge Rev 在图形界面、规则生态与 Mihomo 能力之间折中得较好,日常以自动更新为主、手动替换为备援,是多数技术用户更省心的组合。