VR-B01 · WHITEPAPER · REV 2.0.x

Clash Verge Rev 产品白皮书 | 能力边界 · 组件职责 · 采购论证规范

本文件用于 IT 采购评审、信息安全备案与内部技术立项,定义 Clash Verge Rev 作为「桌面代理 GUI 宿主」的产品边界。源码级进程排障、抓包时序不在本文范围,请参阅 rev-clashverge.com.cn 架构实测专题。

产品白皮书

1. 文档性质与引用方式

VR-B01 为 hk-clashverge.com.cn 编撰的独立产品说明,引用 clash-verge-rev 开源仓库公开信息。采购方可将本文编号写入技术规格书附录;实施排障请分流至下表「深度专题归属」列,避免三站重复阅读。

主题本文覆盖深度深度专题归属
产品能力边界完整本文
Release 变更索引VR-B02
sidecar 源码/抓包不展开rev-clash 架构解析
Windows wintun 排障不展开rev-clash Windows 安装
安装验收命令索引get-clash 安装矩阵

2. 产品定位陈述

Clash Verge Rev(下称「本产品」)是基于 Tauri 2 的跨平台桌面客户端,托管 mihomo(Clash Meta)内核进程,向用户提供订阅管理、规则分流、系统代理与 TUN 接管的图形化能力。本产品不提供代理节点、订阅销售、账户体系或云端配置同步服务。

2.1 与关联项目的关系

  • mihomo:代理内核,负责流量转发与规则执行;版本由 Release 包锁定,见 VR-B05
  • clash-verge-rev:社区接力维护的 GUI 仓库,原 clash-verge 已归档。
  • Clash Meta for Android:独立移动端客户端,配置语法兼容但安装包不互通。

3. 四层逻辑架构(采购视角)

以下分层用于安全评估与网络拓扑绘图,不涉及具体源码路径。

层级职责对外暴露面风险关注点
表现层UI、托盘、用户输入无网络监听XSS 面积极小(Tauri WebView 隔离)
命令层配置读写、进程管理、API 代签本地文件系统配置目录权限
控制层clash-api REST127.0.0.1:9097secret 泄露、端口误绑 0.0.0.0
内核层mihomo 转发/DNS/TUN虚拟网卡、本地代理端口TUN 驱动权限、DNS 策略
实现细节不在本文重复sidecar 启动时序、invoke 命令划分、故障抓包 → rev-clashverge.com.cn 架构解析专题

4. 配置数据流规范

企业审计应能追溯「用户可见配置」到「内核实际加载文件」的链路:

[远程订阅 URL] ──HTTP──► [profiles 缓存目录]
[本地 YAML] ─────────────► [merge 补丁链] ──Rust合并──► [运行时 config]
                                                      │
                                                      ▼
                                            [mihomo sidecar 热加载]
                                                      │
                                                      ▼
                                            [clash-api /connections 可观测]

4.1 持久化目录(审计必查)

路径内容卸载后残留
~/.config/clash-verge/profiles/订阅缓存 YAML
~/.config/clash-verge/logs/应用与内核日志
~/.config/clash-verge/verge.yaml应用偏好、窗口状态

merge 补丁操作规范见 VR-B04;YAML 片段实战见 rev-clash Profile 合并专题(本站不重复示例)。

5. 非功能需求(NFR)承诺边界

下列指标来自社区 Release 与编撰方三机抽测均值,非厂商 SLA;生产环境应自行基准测试。

指标参考目标测量条件
Tauri 宿主空闲内存60—95 MBv2.0.2,无连接
sidecar 冷启动3—15 s含 geo 加载;HDD 取上限
配置热重载1—3 s约 180 节点 Profile
安装包体积28—38 MBWindows x64 NSIS

5.1 验收抽样命令(委派运维执行)

完整步骤与预期输出见 get-clash-verge 安装矩阵;此处仅列采购抽检项:

curl -s -H "Authorization: Bearer $SECRET" http://127.0.0.1:9097/version
预期:HTTP 200,JSON 含 meta:true 与 version 字段(如 v1.18.10)
失败:连接拒绝 → 转 SC-04 日志诊断

6. 安全与合规适用范围

威胁模型、API 加固、日志脱敏的完整条文见 VR-B06。本文仅声明:本产品部署于终端用户设备时,配置目录可能含订阅 token,应按内部数据分级保护;API 必须保持回环地址监听。

6.1 采购检查清单(节选 8 项)

  1. 安装包 SHA256 与 GitHub Release 一致
  2. external-controller 未修改为 0.0.0.0
  3. Profile 变更可追溯(VR-B04 变更单)
  4. 离职终端已卸载并清除 ~/.config/clash-verge
  5. 订阅 URL 来源已备案
  6. TUN 启用已获终端用户授权知情
  7. 未与旧版 clash-verge 并行安装
  8. 内核版本与客户端 Release 对照表已存档(VR-B05)

7. 版本锚定与修订记录

本文以 v2.0.2 + mihomo v1.18.10 为叙述锚点。主版本 Release 发布后 14 个工作日内修订本章与 VR-B02。

修订日版本变更摘要
2026-06-12VR-B01 r2扩写采购视角;去重索引至 rev-clash / get-clash
2026-06-01VR-B01 r1初版发布
下一篇官方公告VR-B02 · v2.0 发布说明

正式安装包获取规程

正式下载