v2.5.5 · 2026-09-22 发布 · GPL-3.0

Clash Verge v2.5.5 的入门路径覆盖首次配置、迁移与故障排查

首次使用 Clash Verge 需完成 4 步:安装客户端、导入订阅或配置文件、选择代理模式、验证节点连通与规则命中。官方文档在「使用教程」下设有快速入门、订阅导入、导出日志、名词解释等条目。

沿用 Clash 配置格式,通常无需重写规则 订阅链接可直接复用 官方文档含快速入门与 4 项使用案例

Getting started

Clash Verge 是什么,第一次使用需要完成哪些步骤?

Clash Verge 是基于 Tauri 与 Mihomo(原 Clash Meta)内核的开源图形客户端,当前稳定版 v2.5.5 于 2026 年 9 月 22 日发布,采用 GPL-3.0 许可证。首次使用需完成 4 步:安装客户端、导入订阅或配置文件、选择代理模式、验证节点连通与规则命中。官方文档在「使用教程」下设有快速入门、订阅导入、导出日志、名词解释等条目。

订阅导入与本地配置文件两种方式

有订阅链接时用订阅导入,无订阅时用本地配置文件导入,两者可并存。

系统代理模式与 TUN 模式的选择

只需浏览器等程序走分流选系统代理;需要接管全部流量时选 TUN 模式。

节点连通性与延迟测试

导入后先做延迟测试,确认节点可用再核对规则命中结果。

官方文档入口(快速入门 / 订阅导入 / 名词解释 / 导出日志)

文档按平台分类提供 FAQ,是排障时的第一入口。

Core features

Clash Verge 的 6 项核心功能如何降低上手门槛?

6 项功能为图形化配置编辑、保存时内核校验、一键测速与切换、订阅导入向导、分级日志与连接面板、配置备份与恢复。保存时的校验会先生成 clash-verge-check.yaml 交给 verge-mihomo 验证,日志显示「验证成功」后才写入运行时配置,可在启动前拦截字段与语法错误。官方文档的「使用案例」另提供自定义规则、链式代理、扩展配置与脚本、自定义脚本 4 个可照抄的示例。

图形化配置编辑与字段提示

无需命令行,界面内完成节点、规则与策略组编辑。

保存阶段的内核校验

保存即校验,失败时给出字段级提示,避免带错配置启动。

一键测速与手动切换节点

测速后可直接手动指定节点,验证特定线路时更快。

订阅导入向导

按向导填入订阅链接即可拉取节点,失败时给出日志原因。

分级日志与连接面板

连接面板显示命中规则名,日志分级输出便于定位问题。

配置备份与恢复

复制配置目录即可备份,装回原路径完成恢复。

Download

第一次下载 Clash Verge,各平台应该选哪个安装包?

v2.5.5 提供 Windows、macOS、Linux 三个桌面平台的安装包,下载前建议先导出旧客户端的配置与订阅链接。iOS 与 Android 不提供本客户端,需使用对应平台的独立应用。迁移前的备份清单、首次启动检查项与 5 个下载常见问题见下载页。

Windows

Windows 10 及以上,不支持 Windows 7

  • 安装包Clash.Verge.zip
  • 体积47.25 MB
  • 内置 WebView2 版238.1 MB
下载 Windows 版(zip · 47.25 MB)

SHA256(前 16 位):e20cf5503c3e90e0

macOS

Apple 芯片 aarch64 / Intel x64

  • 安装包Clash.Verge_2.5.5_aarch64.dmg
  • 体积77.0 MB
  • Intel 版本82.4 MB
下载 macOS 版(Apple 芯片)

SHA256(前 16 位):67e1da80eee9dcab

Linux

deb / rpm,需图形化界面

  • 安装包Clash.Verge_2.5.5_amd64.deb
  • 体积97.8 MB
  • 数据目录~/.local/share/io.github.clash-verge-rev.clash-verge-rev
下载 Linux 版(amd64.deb)

SHA256(前 16 位):53f03c6911778330

Comparison

从其他 Clash 系客户端迁移到 Clash Verge 的成本有多高?

迁移成本取决于配置来源:使用标准 Clash 配置文件的用户通常可直接导入,规则顺序与节点列表保留;依赖客户端私有格式或插件的用户需逐项核对字段。官方文档设有「多订阅合并」「策略组图标」两个配置案例。竞品两列未做同口径实测,留空并禁止预估。

对比维度Clash Verge竞品A竞品B
配置格式标准 Clash YAML 配置自有配置格式,迁移需转换兼容 Clash 配置,字段有增删
从其他 Clash 系客户端导入直接导入,规则沿用需使用导入向导逐项迁移可导入,部分设置需手动调整
迁移后规则是否需重写通常不需要多数情况需按新语法重写少量字段需按文档调整
订阅链接可否复用可复用可复用,导入方式以应用为准可复用,导入方式以应用为准
是否需命令行操作否,界面可完成部分高级功能需命令行配合基础使用无需命令行
排障入口连接面板 + 分级日志 + 官方文档 4 类 FAQ以应用内帮助中心为准以社区文档与 issue 为准
官方教程条目数使用教程 8 项、使用案例 4 项、配置案例 2 项以官方文档目录为准以社区文档目录为准

口径说明:竞品A 指闭源商业客户端的常见做法,竞品B 指开源轻量客户端的常见做法,均为基于公开资料的定性描述,未做同口径实测;迁移成本以竞品官方文档为准。

User feedback

刚迁移过来的用户反馈了哪些问题?

4 条反馈全部来自公开 issue 原文,其中 3 条已关闭、1 项仍开放,覆盖订阅导入、局域网连接、Linux TUN 权限与内核稳定性。每条附 issue 编号与日期,可逐条回溯;未做任何改写或补充评价。

已关闭 · issue #4301
「ERROR - failed to fetch remote profile: Failed to send HTTP request」

来源:GitHub issue #4301,2025-08-01,52 条评论,2025-10-16 关闭 · 查看原文

已关闭 · issue #777
「电脑开启局域网连接后,iPad上设置代理,同一网络下,网络显示:无互联网连接……端口使用的7897」

来源:GitHub issue #777,2024-03-27,55 条评论,2024-10-21 关闭 · 查看原文

已关闭 · issue #5396
「非 root 启动:TUN 开关仍显示灰色,无法开启」

来源:GitHub issue #5396,2025-11-10,49 条评论,2025-11-16 关闭 · 查看原文

仍开放 · issue #5702
「必须重启内核才能解决问题。」

来源:GitHub issue #5702,2025-12-02,100 条评论,仍开放 · 查看原文

Trust

Clash Verge 的入门资料与排障入口有哪些?

入门资料有 3 类:官方文档的「简介 / 下载安装与卸载 / 使用教程」三大板块、客户端内的字段提示与校验信息、资讯页的分场景教程。排障入口有 3 个:连接面板定位单条连接的命中规则、分级日志查看内核报错、官方文档按 Windows / macOS / Linux / 其他问题分类的 FAQ。项目为 GPL-3.0 开源,Release 页逐包提供 .sig 签名文件可核对来源。

  • 官方文档的板块结构简介、下载安装与卸载、使用教程三大板块,含使用案例与配置案例。
  • 连接面板的规则命中定位按连接查看命中规则名,与预期不符时回到配置核对顺序。
  • 分级日志与导出日志日志按等级输出,默认 30 天清理,长期留档需提前导出。
  • 按平台分类的 FAQ 入口Windows、macOS、Linux 与其他问题四类,覆盖自启动、TUN、端口等高频问题。

FAQ

新手与迁移用户最常问的 6 个问题是什么?

Clash Verge 可以和其他 Clash 系客户端同时运行吗?

不建议同时运行。多个客户端会争夺同一代理端口与系统代理设置,表现为分流结果不稳定或启动失败。迁移期间应先关闭旧客户端,再启动 Clash Verge 验证配置。

Clash Verge 导入配置后无法上网怎么办?

按顺序检查三项:代理模式是否已开启、所选节点是否通过延迟测试、规则是否把流量指向了不可用策略组。多数「导入后无网络」来自代理模式未开启或节点本身不可用。

Clash Verge 客户端应该从哪里下载?

Clash Verge 客户端应从项目仓库的 Releases 发布页下载,本页下载模块的 Windows 入口为通用压缩包(zip),macOS 与 Linux 指向官方安装包。下载后应比对发布页公示的 SHA256 与同名 .sig 签名文件,Windows 通用压缩包(zip)为 e20cf5503c3e90e0b133611f03b9e6ddd40a235402d091f5ad9447c71149207e。

Clash Verge 的系统代理模式和 TUN 模式怎么选?

只需浏览器等遵循系统代理的程序走分流时选系统代理模式,需要接管全部流量(包括不读系统代理的程序)时选 TUN 模式。macOS 开启 TUN 时客户端会把系统 DNS 改为 223.6.6.6,关闭 TUN 后恢复。

从其他客户端迁移到 Clash Verge 需要重写规则吗?

使用标准 Clash 配置规则时通常不需要重写,导入后规则按原顺序保留。需要调整的是客户端特有字段与路径相关配置,例如外部配置文件路径与界面相关设置。

迁移到 Clash Verge 前如何备份旧配置?

从旧客户端导出配置文件或复制其配置目录,同时保存订阅链接。备份应包含配置文件、订阅链接与自定义规则三份内容;Clash Verge 侧的配置目录在 Windows 为 AppData\Roaming\io.github.clash-verge-rev.clash-verge-rev,Linux 为 ~/.local/share/io.github.clash-verge-rev.clash-verge-rev。