Clash Verge Rev 内核绑定策略 | 版本对照 · 自定义准入 · 验证脚本

规定客户端 Release 与内置 mihomo 的绑定关系，以及生产环境是否允许替换自定义内核的准入条件。

1. 绑定原则

每个 Clash Verge Rev Release 在 CI 构建时锁定特定 mihomo commit。企业标准部署应使用内置内核；自定义内核仅用于隔离实验环境，且须通过第 4 节验证脚本。

2. 官方对照表（维护至 2026-06）

Verge Rev	内置 mihomo	Release 标签
v2.0.2	v1.18.10	v2.0.2
v2.0.0	v1.18.9	Releases 历史
v1.7.7	v1.18.8	Releases 历史
v1.6.5	v1.18.4	Releases 历史

终端验收：设置页「内核信息」必须与上表一致；否则视为非官方组合或自定义内核未报备。

3. 跨版本升级对内核的影响

升级 Verge Rev 通常同步升级内置 mihomo。跨 mihomo 大版本（如 v1.17→v1.18）可能存在配置字段更名。升级前须：

阅读 VR-B02
在测试 Profile 执行完整规则命中验证
确认 Hysteria2 / Reality 等出站 UI 与内核能力匹配

4. 自定义内核准入条件

条件	要求
来源	自行编译或官方 mihomo Release，禁止未知第三方裁剪版
API	兼容 clash-api（/version、/configs、/proxies）
监听	接受 Verge Rev 注入的 127.0.0.1:9097 与 secret
审批	变更单 + 30 天试运行

4.1 验证脚本与预期输出

# 步骤 1：二进制版本
./mihomo -v

# 步骤 2：Verge Rev 指向自定义路径后，API 探测
curl -s -H "Authorization: Bearer $SECRET" http://127.0.0.1:9097/version

# 步骤 3：配置语法（合并后文件路径因系统而异）
mihomo -t -f /path/to/runtime-config.yaml

步骤 1 预期：mihomo version v1.18.x ...（或自编译标注 commit）
步骤 2 预期：{"meta":true,"version":"..."} HTTP 200
步骤 3 预期：configuration file ... test is successful

5. 禁止场景

生产终端使用落后多个大版本的 mihomo 以「兼容旧节点」
未验证 API 兼容即指向自定义内核
内核与 GUI 版本无对照记录

6. 架构级说明委派

sidecar 如何拉起内核、进程崩溃如何传递至 UI → rev-clash 架构解析

7. 档案留存要求

每次 Release 升级存档：安装包 SHA256、内置 mihomo 版本截图、/version API 响应 JSON。保存期限不少于 12 个月。