安装:从发布页选择对应系统的包
从 Clash Verge Rev 发布页进入下载。项目的安装文档说明,程序通过 GitHub Releases 发布。需要查看其他系统的入口,可到按系统查找客户端发布页。
截至 2026-11-08,安装前可核对以下信息:
| 系统 | 发布页中的安装包与限制 |
|---|---|
| Windows | 有 x64、ARM64 安装包;发布说明明确不支持 Windows 7 |
| macOS | 有 DMG 安装包;最低系统要求存在两种表述,见下文 |
| Linux | 有 DEB、RPM 安装包;没有图形界面时,官方 FAQ 指向 mihomo 内核二进制 |
Windows 的架构说明有出入:README 把 x86 列入支持范围,但截至 2026-11-08 的 v2.5.10 发布资产没有 x86 安装包,只有 x64 和 ARM64。不要仅凭 README 的平台介绍寻找对应文件。
macOS 也要分别看来源。截至 2026-11-08,README 写 macOS 11 及以上;安装文档则写 macOS 12 及以上,并说明 macOS 11 需要自行替换内核。两处要求不一致,安装前应对照项目安装文档核实。
Windows 另有包含 WebView2 的安装包。按发布说明,它用于系统缺少 WebView2 且无法安装的情况。更新或覆盖安装前,应退出正在运行的程序;macOS FAQ 提醒,旧程序运行时安装新版存在损坏风险。
导入配置:远程链接与本地文件分开处理
截至 2026-11-08,配置导入文档列出三条远程导入路径:通过链接直接导入、建立链接配置,以及 URL Schemes。本地文件则可以通过新建配置或拖拽导入。
已有远程配置链接
添加远程配置时,应用会向所填地址请求配置内容。启用自动更新后,它还会按设定的间隔重复请求。
这类请求默认携带标识客户端的 User-Agent,也可以按配置单独修改。提供配置的一方能看到请求 IP。隐私文档还说明,请求可以按配置指定为直连、使用系统代理,或经过应用自身的代理端口。
如果直接导入出现 client error(Connect),导入文档给出的处理方向是换用其他导入方式。不要把这个提示直接理解为安装失败:它出现在获取远程配置的环节,应先沿导入路径检查。
已有本地配置文件
本地文件可通过新建配置时选择文件来导入,也可以拖拽导入。
通过文件选择导入后,应用会把文件复制进 profiles 目录。此后移动或删除原文件,不会影响这份已复制的配置。
新建配置时也允许不选文件,但直接保存得到的是空配置。因此,“已经新建”不能代替“已经导入现有内容”。后续需要理解配置各部分的作用,可查看端口、代理组与规则说明。
遇到证书提示
若报错包含 invalid peer certificate: UnknownIssuer,官方其他问题页给出的选项是「允许无效证书(危险)」。
该选项名称已经标出风险,不应当作每次导入都要执行的步骤。只有出现对应错误时,才对照文档处理。导入文档也提到,在链接配置仍出现连接错误的情况下,可保存这一选项后重试。
选择模式:先区分运行模式与流量接管方式
运行模式与系统代理、TUN 不宜混为一谈。前者涉及配置的运行方式;后两者回答的是应用怎样接到需要处理的流量。
现有官方说明没有提供运行模式的完整界面操作顺序,也没有说明相关按钮的确切位置。操作时可对照所用客户端的界面与配置说明,避免照搬其他客户端的菜单路径。
接下来要确认的是流量接管方式。系统代理依靠应用遵守系统设置;TUN 则通过虚拟网卡和路由重定向处理流量。两者的工作机制不同。
开启系统代理或 TUN:按流量与权限判断
| 方式 | 工作机制 | 使用时要检查什么 |
|---|---|---|
| 系统代理 | 在操作系统约定的位置写入代理端口信息 | 目标程序是否遵守系统代理设置 |
| TUN | 建立虚拟网卡,并通过路由重定向处理 TCP、UDP 流量 | 内核权限、服务状态与防火墙放行情况 |
系统代理不能接管 UDP。部分程序也不会遵守操作系统的代理设置,所以开关已经开启,并不代表每个程序的流量都已进入客户端。
TUN 不依赖程序读取系统代理设置。项目名词解释还要求,使用 TUN 时在系统防火墙中放行 verge-mihomo 和 verge-mihomo-alpha。
Windows 出现服务安全检查提示
截至 2026-11-08,官方文档说明,服务模式让用户能够在主程序未以管理员身份启动时使用 TUN。服务安装并获得授权后,由服务进程启动内核。
若提示服务内核未通过安全检查,并切换至 Sidecar,普通用户权限下无法使用 TUN。Windows FAQ 给出两种处理方向:
- 退出应用,再以管理员身份启动;遇到服务安装或修复提示时选择「继续使用 Sidecar」。以后使用这条路径仍需管理员启动。
- 修复安装目录权限,再到「设置 → 服务模式」重装服务。首页显示服务模式后,再开启 TUN。
服务会检查内核文件及其上级目录的所有者与权限。处理时应围绕报错所指向的位置核对;官方明确提醒,不要对整个 C 盘递归重置权限。
验证是否生效:沿失败环节检查
完成操作后,可按下面的顺序排查,避免反复重新安装。
- 配置是否真正导入。 本地新建后直接保存得到空配置,与选择文件导入不是同一结果;远程配置则需要先处理请求或证书报错。
- 系统代理是否覆盖目标程序。 如果程序不读取系统代理设置,开启系统代理仍不足以接管它;UDP 也不在这种方式的处理范围内。
- TUN 是否具备启动权限。 Windows 已退回 Sidecar 且以普通用户权限运行时,应先处理权限或服务状态。
- 防火墙是否放行内核。 使用 TUN 时,对照项目文档检查内核放行要求。
这些检查用于定位导入、接管方式和权限问题,不能仅凭其中一个状态判断所有连接都已成功。仍有下载、安装或连接错误时,可继续查阅按故障环节排查常见问题。
第三方整理,与项目方无关。