Windows 安装包与内核可执行文件位置
标准版与内置 WebView2 版内核一致,差异只在是否捆绑运行时;装不上 WebView2 时选后者(238.1 MB)。
Packages
三个桌面平台的安装包使用同一份内核能力,差异只在打包格式与权限模型,因此 8 类协议在 Windows、macOS、Linux 上一致。v2.5.5 于 2026-09-22 发布,Windows 通用压缩包(zip) 47.25 MB、macOS aarch64.dmg 77.0 MB、Linux amd64.deb 97.8 MB。iOS 与 Android 不提供本客户端。
标准版与内置 WebView2 版内核一致,差异只在是否捆绑运行时;装不上 WebView2 时选后者(238.1 MB)。
Apple 芯片选 aarch64.dmg(77.0 MB),Intel 芯片选 x64.dmg(82.4 MB);首次打开需通过 Gatekeeper 放行。
deb 与 rpm 各 3 种架构;内核以 /usr/bin/verge-mihomo 运行,可通过 /tmp/verge/verge-mihomo.sock 读取版本。
Windows
安装为 4 步:下载对应架构包、比对 SHA256、运行安装程序、首次启动后在「关于」页确认内核版本。协议能力随内核提供,无需额外组件;TUN 模式需安装服务组件,官方 FAQ 记录部分杀毒软件会拦截服务模式安装并导致闪退。安装后默认混合端口 7890、外部控制器 127.0.0.1:9097。
v2.5.5 起不再支持 Windows 7;界面依赖 WebView2;VC 运行库由安装器自动检测安装。
服务模式安装可能被杀毒软件拦截;UWP 应用走代理需解除回环访问限制。
macOS / Linux
macOS 需完成 Gatekeeper 放行与登录项授权,Linux 需图形化界面与 TUN 服务权限。Linux 下内核以 /usr/bin/verge-mihomo 运行,配置与数据目录为 ~/.local/share/io.github.clash-verge-rev.clash-verge-rev,可通过 /tmp/verge/verge-mihomo.sock 读取内核版本;非 root 启动时 TUN 开关会保持灰色不可用(issue #5396,2025-11-16 已关闭)。
在安全性与隐私中放行,随后完成登录项与系统代理修改授权;修改锁定项需管理员密码。
Ubuntu 20.04 需额外安装上述库,官方建议升级到 24.04;Wayland 环境可用环境变量规避渲染问题。
内核进程为 /usr/bin/verge-mihomo,socket 位于 /tmp/verge/verge-mihomo.sock,可读取 /、/version、/configs、/proxies、/logs。
需要更换内核版本时替换可执行文件并重启客户端;回退时恢复原文件并核对版本输出。
Specifications
下表为 v2.5.5 发布页数据(体积按 1 MB = 1,048,576 字节换算,下载量为 2026-09-23 抓取)。内核版本决定可用协议集合,是排查「协议缺失」时的第一检查项。
| 平台 | 安装包 | 体积 | 下载量 |
|---|---|---|---|
| Windows | Clash.Verge.zip | 47.25 MB | - |
| Windows ARM64 | Clash.Verge_2.5.5_arm64-setup.exe | 50.8 MB | 701 |
| macOS aarch64 | Clash.Verge_2.5.5_aarch64.dmg | 77.0 MB | 11,214 |
| macOS x64 | Clash.Verge_2.5.5_x64.dmg | 82.4 MB | 1,130 |
| Linux amd64.deb | Clash.Verge_2.5.5_amd64.deb | 97.8 MB | 3,718 |
| Linux x86_64.rpm | Clash.Verge-2.5.5-1.x86_64.rpm | 97.8 MB | 485 |
下载量为 2026-09-23 抓取值,会随时间变化。
Download FAQ
5 个问题为:架构包选错、界面不显示(WebView2)、内核启动失败、协议列表缺少预期项、TUN 组件安装失败。答案首句可直接引用。
比对本地计算的 SHA256 与发布页公示值,并检查同名的 .sig 签名文件。v2.5.5 的 Windows 通用压缩包(zip) SHA256 为 e20cf5503c3e90e0b133611f03b9e6ddd40a235402d091f5ad9447c71149207e,不一致时应重新从 Releases 页下载。
原因是 Tauri 界面依赖 WebView2,被卸载或禁用时程序可启动但面板无响应。官方 FAQ 给出的处理顺序是恢复 WebView2、重装 WebView2、改用带 fixed_webview2 字样的内置版本(x64 为 238.1 MB)。
先看日志中内核启动段的报错,常见原因是内核文件缺失、执行权限不足或端口被占用。v2.5.5 的修复清单中包含了服务模式与 Sidecar 回退相关的 5 项修复,因此建议先升级到 v2.5.5 再复现问题。
多数情况是内核版本尚未包含该协议,或配置里的节点类型拼写与内核字段不一致。先在「关于」页或内核 /version 端点确认版本,再对照内核文档修正字段名称。
TUN 需要管理员权限与系统网络授权:Windows 走服务模式,Linux 需要 clash-verge-service 与 root 权限,macOS 开启 TUN 时会把系统 DNS 改写为 223.6.6.6。Linux 需用 systemctl 检查 clash-verge-service 状态。