选择系统和架构对应的安装包
从 官方稳定版 Releases 下载,展开 Assets 后核对系统与处理器架构。日常使用选正式版,AutoBuild 用于测试反馈。GitHub 的 Source code 是源码压缩包,不能当安装程序运行。
| 设备 | 选择方法 |
|---|---|
| Windows | 在系统信息中查看架构;Intel/AMD 常见为 x64,ARM 设备选择发布页对应包。 |
| macOS | 在“关于本机”查看芯片,Intel 与 Apple 芯片分别选择对应 DMG。 |
| Linux | Debian/Ubuntu 选 DEB,Fedora 等选 RPM,同时核对 x64 或 ARM 架构。 |
当前安装文档要求 Windows 10/11、macOS 12 及以上;仓库简介仍出现 macOS 11+ 的表述,旧系统应以 安装文档与该版本发布说明 为准。这个项目没有 Android 或 iOS 安装包。
2026 年 11 月 3 日核查,官方正式版为 Clash Verge Rev 2.5.10。本次发行说明以问题修复为主,没有另列新的内核版本;此前 2.5.9 的发行说明列出 Mihomo 1.19.33,实际运行版本仍应在应用内确认。客户端与内核版本是两个编号,不能互相替代。Windows 仍提供 x64、ARM64 普通包及 fixed_webview2 包;Linux DEB/RPM 另有 ARMv7 构建。按设备与发行版选择,不下载 Source code 当安装包。
2.5.9 虽修复了 macOS Big Sur 的首页图表显示,当前安装文档仍将 macOS 12 及以上列为支持范围;单项修复不能等同于重新承诺完整支持 macOS 11。Linux 本版修复 DEB/RPM 误含多余 frontend-contract 文件的问题,使用发行版包管理器升级,不手工删除不认识的程序文件。
安装与首次启动
- Windows 运行官方安装程序,保留明确的安装位置,首次启动观察界面和服务状态。不要同时启动旧版 Clash Verge 与新版客户端。
- macOS 打开 DMG,把应用拖到 Applications 后再启动;遇到系统拦截,先核对来源和发布说明,再按系统给出的应用授权入口处理。
- Linux 使用发行版包管理器安装对应 DEB/RPM,让它同时处理依赖;不要把其他发行版的包强行解压替代安装。
Windows 如果只有托盘图标、窗口白屏或点击没有反应,检查 WebView2 是否被卸载或禁用。官方另外提供带 WebView2 的安装包,具体名称以当前 Assets 为准。先解决界面启动问题,再配置节点,避免把运行环境故障误判为订阅不可用。
2.5.10 修复 Windows 重新安装或覆盖安装时未提示退出运行中应用的问题。操作前仍先保存配置并正常退出客户端,按安装器提示处理;不要为了覆盖失败强删正在运行的程序文件。安装后重新确认应用版本、配置与服务状态。
导入订阅或本地 YAML
- 准备兼容 Clash/mihomo 的订阅地址或 YAML 配置文件。普通网站首页、账户登录页与订阅 URL 不相同。
- 进入订阅管理区域,使用链接导入功能粘贴完整地址;成功后确认新增配置中出现预期的节点与策略组。
- 已有本地文件时使用本地配置导入;官方也支持把配置文件拖入界面。导入后启用该配置,不能只停留在“已经下载”这一步。
- 为配置起一个自己能识别的名称,记录来源与最后更新时间,后续只更新需要使用的订阅。
如果收到的是 vmess://、vless:// 等单节点分享链接,先确认提供方是否有 Clash 格式,不要把不同格式直接改后缀为 YAML。导入方式见 官方订阅文档。订阅 URL 常含账户令牌,截图和求助时隐藏完整地址。
2.5.9 修复了通过 URL 导入非当前订阅时仍重载当前配置的问题。已有可用配置时,导入后先确认当前选中项未变,再检查新订阅的节点;只有决定切换时才启用它。新增配置与切换当前配置应分开验证。
选择节点和流量接管方式
配置启用后,先给承担流量的策略组选一个节点。规则模式按 YAML 分流,全局模式使用全局策略;浏览器是否进入客户端,则由系统代理或应用设置决定。
第一次配置先开启系统代理,使用浏览器验证。系统代理修改操作系统的代理设置,许多浏览器会遵循,但部分命令行、游戏或其他应用不会。需要处理这类应用时,再考虑 TUN 虚拟网卡模式,并按授权提示安装或启用所需服务。
TUN 涉及网卡、DNS 和路由,启动失败时先关闭它,确认系统代理路径仍能工作。公司网络、虚拟机或另一个 VPN 已有路由设置时,逐项核对冲突。官方快速入门 给出了节点选择与两种接管方式。
2.5.9 在虚拟网卡设置中新增“DNS 模式”,用于配置 Mihomo 的系统 DNS 行为。升级不意味着必须切换该选项;先记录原值,一次只改一项并验证解析与连接,异常时恢复原值及原接管方式。Windows 系统代理默认绕过 *.local:局域网设备的这类主机名可能直接连接,不应仅因它未出现在代理连接里就判定客户端失效;显式代理和 TUN 路径另行验证。
2.5.10 修复全局模式缺少 GLOBAL 策略组、无法单独选择全局出口的问题。确需全局模式时,切换后检查 GLOBAL 与选中节点,再用实际请求核对出口;完成排查后恢复原模式。它还修复了订阅 DNS 配置变化后“DNS 覆写”实际关闭但开关仍显示开启的问题:更新订阅后同时查看提示、实际生效配置与解析结果,不只看开关外观;不要为此盲目重设所有 DNS 选项。
验证浏览器与本地代理入口
- 查看客户端是否显示内核正常运行,并记下当前 HTTP 或混合代理端口,不照抄其他教程的默认端口。
- 打开你实际需要使用的网站,同时观察连接列表:目标域名、匹配规则、策略组和节点应符合预期。
- 在 首页验证工具 选择 HTTP 代理和实际端口,生成 curl 命令。在 Windows PowerShell 使用
curl.exe,避免同名命令别名造成差异。 - 分别测试一个应直连的目标和一个应代理的目标,最后关闭代理,确认普通网络恢复。
延迟测试成功只说明测试目标在当时能够响应,不代表所有网站、UDP 应用或吞吐量都满足要求。显式 curl 请求成功而浏览器失败时,优先检查浏览器独立代理设置、系统代理开关和绕过列表,而不是立即更换全部配置。
2.5.9 已移除托盘“测试延迟”入口,测速请到代理页面操作。该版本也修复分组展开后结果不刷新、全局模式分组无法展开及首页网站测速失败后一直显示测试中的问题。若旧教程要求从托盘测速,按当前代理页入口完成;延迟结果仍不代表实际下载速度。
白屏、订阅失败和 TUN 故障
- 订阅导入失败:核对 URL 是否完整、是否返回配置内容以及当前网络能否访问订阅域名。证书报错先检查系统时间和服务端证书,不把关闭证书校验作为常规解决办法。
- 节点或策略组空白:检查已启用的配置和内核日志,区分配置解析失败与客户端连接内核失败。
- 系统代理正常、TUN 失败:检查服务状态、权限和其他虚拟网卡;若提示服务安全检查失败,阅读官方说明,不自行放宽整个安装目录的写入权限。
- 退出客户端后断网:先检查是否残留指向本机端口的手动代理。macOS 旧版本还可能在关闭 TUN 或退出后留下
114.114.114.114的 DNS 设置,2.5.8 已修复这一问题;保留备份并更新正式版后,再确认 DNS 恢复到原网络设置。
Windows 的具体错误见 官方故障说明。向项目反馈时提供系统、版本、接管方式和复现步骤,日志中的订阅令牌、UUID 与节点密码先脱敏。
备份、规则修改与更新
更新前导出配置和设置,并记下常用策略组、端口和 TUN 状态。使用 WebDAV 时,额外保存一份本地备份,恢复时不必依赖远端服务。
订阅更新可能替换远程 YAML。需要长期保留的自定义分流应放到客户端提供的扩展配置或规则管理机制中,先用少量规则验证,避免直接改完远程文件后下次更新全部丢失。备份本身也可能包含访问凭据,应放在受控存储中。
从正式发布渠道更新后,重复导入检查、真实请求与退出恢复三项验证。如果迁移后出现问题,保留原备份与错误日志,不急于清空配置目录;先区分应用升级、内核变化和订阅内容变化。
2.5.9 修复了重启应用后定时自动备份不执行,以及清空 WebDAV 设置后无法保存的问题。升级前仍先做一次手动本地备份;升级后重启客户端,核对定时设置,并在计划触发后检查是否产生新的备份文件与时间。启用了远端备份时另核远端结果,不把开关开启视为备份已成功。若验证失败,保留备份和脱敏日志,先恢复原配置,不清空整个配置目录。
2.5.10 修复服务模式下 GEO 数据库更新后未同步回应用目录、使新分类规则校验失败的问题。遇到这类错误时,先保存规则与配置备份,使用应用支持的数据更新方式,再重新校验原配置并检查命中结果;不要从不明来源替换数据库。若服务模式使用 SSH 节点且 private-key 指向私钥文件,本版也修复相关内核启动问题;只在自己的授权配置上验证启动与连接,不上传私钥,不放宽整个目录权限。失败时保留脱敏日志并按已有备份恢复。
常见问题
Clash Verge Rev 可以在 iPhone 或 Android 上使用吗?
它是 Windows、macOS 和 Linux 桌面客户端,没有官方 Android 或 iOS 安装包。手机可在工具目录查看 FlClash、Hiddify 等对应平台客户端,配置格式仍需分别确认。
Windows 界面打不开,是否应该重新买订阅?
先检查 WebView2 和安装包架构。只有托盘图标或白屏通常属于界面运行环境问题,与订阅是否有效没有直接关系。按官方安装与 Windows 故障文档处理后再验证连接。
为什么手动改好的规则在更新订阅后消失了?
远程订阅更新可能重新写入配置文件。把需要保留的修改放到扩展配置或规则管理功能中,更新前备份,并在更新后检查规则优先级和实际命中结果。
参考资料
下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。