Clash Verge 安装教程:Windows、macOS、Linux 下载与首次配置
简答:先从 Clash Verge Rev 项目的 GitHub Releases 下载对应系统和架构的安装包,再完成安装、导入兼容的 Clash 配置、选择节点并开启系统代理;TUN 模式应在基础连接正常后再启用。
定义:Clash Verge Rev 是面向 Windows、macOS 和 Linux 的桌面图形客户端,用于导入配置、管理节点并控制系统代理,本身不提供订阅或节点。
先确认下载来源和安装包:优先选择 Stable 发布版
本文是第三方使用指南站内容,与 Clash Verge Rev 项目及开发者无隶属关系。Clash Verge Rev 项目文档说明,用户应前往发布页下载匹配平台的安装包,并区分 Stable、Alpha 和 AutoBuild 发布渠道;日常安装优先选择 Stable。请直接查看Clash Verge Rev GitHub Releases,不要仅凭搜索结果、网盘文件名或第三方下载页判断来源。
截至 2026 年 10 月 23 日,发布页显示 v2.5.8 为当前页面中的最新稳定发布。版本会变化,本文不把版本号当作永久下载依据;实际安装时应以发布页当前显示的 Stable 版本和资产列表为准。
| 系统 | 优先选择 | 判断方法 | 不确定时 |
|---|---|---|---|
| Windows | x64;明确为 ARM 设备时选 ARM64 | 打开“设置→系统→系统信息”,查看系统类型 | 大多数 Intel 或 AMD 电脑先核对是否为 x64,不要凭外观猜测 |
| macOS | Apple 芯片或 Intel 芯片对应版本 | 打开“苹果菜单→关于本机”,查看芯片或处理器 | 显示 M 系列芯片选 Apple 芯片,显示 Intel 选 Intel |
| Linux | DEB 或 RPM,并匹配 CPU 架构 | 运行 uname -m 和 cat /etc/os-release | 先确认发行版和架构,再从发布页选择对应文件 |
下载核对清单:文件来自项目 Releases 页面;系统和架构一致;选择的是 Stable 而不是测试构建;Windows 安装包是否为普通 WebView2 版本要结合本机环境判断。项目安装文档说明,内置 WebView2 包主要用于系统缺少且无法正常安装 WebView2,或普通包无法打开面板的情况。
Windows 安装:先选 x64 或 ARM64,再检查 WebView2
- 打开项目发布页,找到当前 Stable 发布,在 Windows 资产中选择 x64 或 ARM64 安装包。普通 Intel、AMD 电脑通常对应 x64;只有系统信息明确显示 ARM 架构时才选择 ARM64。
- 双击安装包并按安装向导完成安装。若 Windows SmartScreen 弹出提示,先回到发布页核对来源、版本和文件名;无法确认文件来源时,不要强行运行。
- 首次启动后检查主窗口、设置页面和右下角托盘图标。能打开主窗口并进入设置,说明程序本体已完成基本安装。
- 如果窗口空白、面板无法加载或启动后立即退出,先确认系统 WebView2 环境。项目安装文档列出带内置 WebView2 的替代安装包;只有在普通安装包无法正常打开面板,且文件仍来自同一 Releases 页面时,再尝试该版本。
Windows 验收标准:客户端可以稳定启动;设置页可以打开;托盘图标存在;退出后再次启动仍能显示主窗口。不要把桌面快捷方式是否出现作为唯一判断标准。
macOS 安装:按 Apple 芯片或 Intel 选择 DMG
- 打开“苹果菜单→关于本机”,查看设备使用的是 Apple 芯片还是 Intel 处理器。
- 在项目 Releases 页面下载对应的 macOS 安装包。Apple 芯片设备选择 aarch64 或 Apple 芯片文件,Intel 设备选择 x64 或 Intel 文件;最终以发布页当前资产名称为准。
- 打开 DMG,将应用拖入“应用程序”文件夹,再从“应用程序”启动。首次启动若提示无法验证开发者或阻止打开,先确认安装包来自项目发布页。
- 进入“系统设置→隐私与安全性”,查看是否出现允许打开的选项。不同 macOS 版本的提示文字可能不同,优先使用系统界面提供的操作,不要直接执行来源不明的命令。
- 启动成功后检查窗口、设置页和菜单栏或托盘入口。若应用只能打开一次、每次启动都被拦截,先处理系统授权,再继续导入配置。
macOS 验收标准:应用能够打开设置页面,退出后可再次启动,并且没有持续出现“无法打开”或“应用已损坏”提示。无法确认 DMG 来源时,不建议绕过系统安全拦截。
Linux 安装:匹配 DEB、RPM 与 CPU 架构
项目发布页列出 Linux 的 DEB 和 RPM 安装包,并提供 64 位、ARM64、ARMv7 等架构选项。先在终端执行:
uname -m
cat /etc/os-releaseuname -m 用于查看 CPU 架构,cat /etc/os-release 用于查看发行版信息。输出为 x86_64 时,通常选择 amd64 或 x86_64 文件;输出为 aarch64 时,选择 ARM64 文件;输出为 armv7l 时,选择 ARMv7 文件。文件名和发布页资产不一致时,以发布页实际提供的文件为准。
Debian、Ubuntu 等 Debian 系发行版可使用 DEB 包。下面的文件名是示例,必须替换为你实际下载的文件名:
sudo apt install ./Clash.Verge_版本_amd64.debFedora、RHEL 等 Red Hat 系发行版可使用 RPM 包:
sudo dnf install ./Clash.Verge-版本-1.x86_64.rpm命令目的分别是安装当前目录中的本地 DEB 或 RPM 文件。如果提示“文件不存在”,先运行 ls 查看真实文件名和所在目录,不要随意删除架构后缀。安装后从应用菜单启动,确认窗口能打开并且设置可以保存。
首次配置:导入配置、选择节点并开启系统代理
- 准备兼容 Clash 或项目支持格式的订阅链接,或准备本地配置文件。客户端只负责读取配置和管理连接,订阅来源、内容和可用性需要由提供方确认。
- 打开客户端的“订阅”或“Profiles”页面,将订阅链接粘贴到输入框,点击导入或更新。成功后应能看到配置名称、更新时间或配置内容。
- 进入代理页面,检查代理组和节点列表。先选中一个节点,再确认当前代理组显示已选状态;如果列表为空,回到订阅页面更新配置,不要立即开启 TUN。
- 首次测试优先选择规则模式。项目快速入门文档说明,系统代理通过修改操作系统代理设置,通常适用于浏览器等遵循系统代理的应用;TUN 模式通过虚拟网卡接管不支持系统代理的程序。
- 打开系统代理开关,用浏览器访问一个平时能够访问的网页。浏览器能正常加载,且客户端连接详情能看到当前策略或节点,说明基础链路已经生效。
| 检查项 | 正常表现 | 异常时先做什么 |
|---|---|---|
| 配置 | 配置名称出现并且可以选中 | 重新检查链接是否完整,再手动更新 |
| 节点 | 代理组中能看到节点并能选中 | 检查配置内容、订阅格式和提供方状态 |
| 系统代理 | 开关保持开启,浏览器连接行为发生变化 | 检查端口冲突以及其他代理软件是否同时运行 |
| 网页 | 网页能加载,连接详情显示实际使用的策略 | 先切换节点或模式,再查看日志和连接详情 |
系统代理和 TUN 模式有什么区别:先用简单方式验收
系统代理主要影响遵循操作系统代理设置的应用;TUN 模式通过虚拟网卡扩大接管范围,适合系统代理无法覆盖的程序,但对权限、DNS、路由和服务状态更敏感。项目快速入门文档也将两者区分为系统代理和虚拟网卡接管。
- 只需要让浏览器等常规应用使用代理:先开启系统代理,不必一开始启用 TUN。
- 某个应用不读取系统代理:在配置、节点和浏览器测试都正常后,再考虑开启 TUN。
- 开启 TUN 后网页不通:先关闭 TUN,保留系统代理测试;如果系统代理正常,再检查权限、DNS、路由和其他网络工具。
- 关闭客户端后仍无法上网:重新打开客户端,关闭系统代理和 TUN,再退出程序,确认系统网络设置恢复。
推荐顺序:安装成功 → 导入配置 → 节点可选 → 开启系统代理 → 浏览器验收 → 必要时再开启 TUN。
常见安装与配置问题:按现象逐项排查
| 现象 | 优先检查 | 判定标准 |
|---|---|---|
| 找不到合适安装包 | 系统架构、发行版和发布渠道 | 架构与文件名一致,文件来自项目 Releases 页面 |
| Windows 面板空白 | WebView2 和安装包类型 | 普通包无法打开面板时,再尝试同一发布页中的内置 WebView2 包 |
| macOS 无法打开 | 芯片版本、DMG 来源和系统授权 | 应用来自发布页,并且系统设置允许打开 |
| 订阅导入后没有节点 | 链接完整性、配置内容和更新时间 | 配置页面有内容,代理组中出现节点 |
| 节点测速失败 | 节点状态、测试目标和网络环境 | 测速失败不等于客户端安装失败,应先看日志和连接详情 |
| 网页打不开 | 模式、系统代理、端口冲突 | 关闭 TUN,仅使用系统代理测试,再逐项恢复 |
| 关闭软件后断网 | 系统代理或 TUN 是否残留 | 关闭系统代理和 TUN 后,系统网络恢复正常 |
如果问题只在升级某个版本后出现,记录客户端版本、系统、安装包架构和完整错误提示,再对照发布说明核查。没有打开并核对过的 Issue 或第三方教程,不应直接当作确定原因。
卸载与重新安装:先恢复网络,再删除程序
- 打开客户端,关闭系统代理和 TUN,确认浏览器可以恢复正常连接后再退出程序。
- Windows 从“设置→应用→已安装的应用”卸载;macOS 将应用移到废纸篓;Linux 使用与安装包对应的包管理器卸载。
- 如果准备重装,先保存仍需使用的配置文件或订阅链接。不要在未备份前直接删除配置目录。
- 重新安装时再次核对 Stable 发布渠道、系统架构和安装包名称。若问题只出现在升级后,保留旧版本信息和错误提示,方便对照。
卸载验收标准:系统代理已关闭,TUN 或相关服务不再运行,浏览器可以直接使用当前网络。如果仍无法联网,应先检查系统代理、DNS、网络适配器和其他网络工具,而不是重复安装。
常见问题
Clash Verge 和 Clash Verge Rev 应该安装哪一个?
本文按 Clash Verge Rev 编写。项目文档将其说明为 Clash Verge 的延续,并要求用户从项目发布页下载匹配平台的安装包。安装前应核对 Stable 发布渠道、系统架构和当前文件名,不要只看第三方下载页。
Windows 不知道选 x64 还是 ARM64,怎么判断?
打开“设置→系统→系统信息”,查看系统类型。普通 Intel 或 AMD 电脑通常选择 x64;只有系统明确显示 ARM 架构时才选择 ARM64。无法确认时先记录系统类型,不要凭文件大小猜测。
Windows 安装后窗口空白怎么办?
先确认安装包来自项目 GitHub Releases,并重新启动客户端。如果普通安装包仍无法加载面板,再根据项目安装文档尝试同一发布页中的内置 WebView2 版本;不要从不明网站下载所谓修复包。
macOS 提示无法验证开发者或应用无法打开怎么办?
先确认 DMG 来自项目 GitHub Releases,并核对 Apple 芯片或 Intel 版本是否选对。然后到“系统设置→隐私与安全性”查看允许打开的选项;如果来源无法核实,不建议绕过系统安全拦截。
订阅导入成功但没有节点,应该检查什么?
先确认订阅链接完整,配置页面出现内容,再手动更新并检查代理组。如果仍无节点,可能与订阅格式、配置内容或提供方状态有关;先不要开启 TUN,也不要把空节点列表直接判断为安装失败。
安装后网页打不开,是不是必须开启 TUN?
不一定。先选择有效配置和节点,只开启系统代理测试浏览器;如果系统代理正常而某些应用仍不走代理,再考虑 TUN。开启 TUN 后异常,应先关闭 TUN并检查权限、DNS、路由和其他网络软件冲突。
相关阅读
参考资料
- Clash Verge Rev GitHub Releases:版本、安装包与发布说明
- Clash Verge Rev 项目 README:平台支持与发布渠道
- Clash Verge Rev 安装文档:系统架构、WebView2 与发布地址
- Clash Verge Rev Docs 快速入门:导入订阅、选择节点与系统代理(clashverge.dev)