Clash Verge Rev v2.5.2 已经取代 v2.5.1 成为 GitHub Latest。遇到 gzip 订阅导入后报无效 YAML、Windows 管理员模式打开 TUN 多等约 30 秒、macOS 内存压力下白屏，或 DNS 覆写高级模式无法编辑，可以安排升级。当前没有这些症状，也建议先备份，等到不影响工作的时间窗口再换版本。

GitHub API 给出的发布时间是 2026-07-19T17:00:26Z；Release 正文按中国标准时间写成 2026 年 7 月 20 日。两者是同一条发布记录，不是两个版本。

这里的版本、文件名、体积和备份内容来自 v2.5.2 Release、API 与对应标签源码，不代表三种系统均已逐台安装。升级后仍要在自己的 Profile、TUN 和 DNS 配置上验收。

v2.5.2 到底修了什么？

这不是只换 Mihomo 内核的版本。Release notes 列出的修复覆盖订阅下载、桌面界面、TUN、DNS 覆写、WebDAV、局域网监听和配置文件编辑。先按你正在遇到的症状找对应项：

当前表现v2.5.2 的对应变化升级后先验证什么
gzip 订阅被提示为无效 YAML修复压缩响应未正确处理更新同一订阅，确认 Profiles 不再报 YAML 无效
Basic Auth 用户名存在、密码为空时认证失败修复未发送空密码认证信息保留原 URL，重新更新一次，不要同时换 User-Agent
Windows 管理员模式打开 TUN 要多等约 30 秒不再等待不可用的 Service记录开关 TUN 到状态生效的时间，并查看 service 日志
macOS 内存压力后白屏处理 WebView 渲染进程终止和主进程内存泄漏从菜单栏重新打开窗口，确认首页和连接页能恢复
DNS 覆写高级模式不能编辑修复高级编辑器改一项、保存、重新打开，确认内容没有被还原
开启 IPv6 的 Fake-IP 配置缺少 IPv6 地址池新增 fake-ip-range6 生成与配置在最终配置里查 fake-ip-range6，不要只看界面开关
WebDAV 目录已存在时备份失败兼容部分非标准 WebDAV 服务器创建一份新备份，再从记录页确认文件能列出
允许局域网连接后其他设备仍连不上修复监听及网络接口显示相关问题查看绑定接口和监听地址，再从另一台设备访问

内置 Mihomo 也从 v1.19.25 升到 v1.19.29：v2.5.0 Release 记录的是 v1.19.25，v2.5.1 只列出备份和 Windows 节点交互修复，v2.5.2 才写明升至 v1.19.29。界面新增 TrustTunnel、OpenVPN、Tailscale、GostRelay 节点显示支持，同时补上代理组筛选、排序、延迟测试和快速定位。这里的“显示支持”不等于任何旧配置都能无改动运行；节点字段仍以 Mihomo v1.19.29 能否解析为准。

哪些人应该现在升级？

升级优先级最高的是订阅更新、TUN 或配置编辑已经命中上表的人。尤其是 gzip 响应和空密码 Basic Auth，这两类故障发生在订阅下载层。反复删除 Profiles 或重装内核不会修正 HTTP 响应处理，换到 v2.5.2 才是对应动作。

依赖 macOS 菜单栏、Linux 托盘、WebDAV 自动备份或大量订阅卡片的人，也适合尽快在维护窗口升级。v2.5.2 对这些路径同时做了内存、拖拽性能和服务生命周期修复，不是单个平台的小补丁。

下面三类设备先别直接覆盖：

  • Windows 7：Release 明确不再支持。
  • 正在运行不可中断 TUN 或局域网共享的设备：先准备旧安装包和配置 ZIP。
  • 当前问题与订阅返回登录页、链接过期、YAML 字段错误有关：升级可能没有作用，先看 Clash Verge Rev 订阅更新失败排查。

如果 v2.5.1 运行稳定，升级并不紧急。但 v2.5.2 距离前版已经积累了多项订阅和进程管理修复，不建议长期停留在旧版又完全不留备份。

Windows、macOS、Linux 该下哪个包？

安装包只按两个条件选：操作系统包格式和处理器架构。x64、amd64、x86_64 都指常见的 64 位 Intel/AMD 平台；arm64、aarch64 指 64 位 ARM；armhf、armhfp 是 32 位 ARM。

设备默认安装包不该误下的文件
Windows 10/11 Intel 或 AMDClash.Verge_2.5.2_x64-setup.exearm64-setup.exe、.sig
Windows 10/11 ARMClash.Verge_2.5.2_arm64-setup.exex64-setup.exe
企业 Windows 或缺 WebView2对应架构的 fixed_webview2-setup.exe普通设备不要为“更完整”而选它
Apple Silicon MacClash.Verge_2.5.2_aarch64.dmgx64.dmg
Intel MacClash.Verge_2.5.2_x64.dmgaarch64.dmg
Debian / Ubuntu x64Clash.Verge_2.5.2_amd64.debRPM、ARM 包
Fedora / RHEL x64Clash.Verge-2.5.2-1.x86_64.rpmDEB、ARM 包
ARM64 Linux对应发行版的 arm64.deb 或 aarch64.rpmarmhf、armhfp

普通 Windows x64 安装包是 46,964,366 字节；内置 WebView2 的 x64 包是 237,316,704 字节。后者约 226 MiB，官方只把它留给企业版系统或无法安装 WebView2 的环境。体积大不是功能更多。

.sig 是更新签名文件，不是安装程序。latest.json 和 .app.tar.gz 主要服务于更新分发，也不适合普通用户替代 DMG 或 setup。完整资产仍从 v2.5.2 官方 Release 选择。

升级前备份哪些东西？

打开 Clash Verge Rev 的 设置 → 备份设置 → 手动备份 → 本地备份，点击“备份”。随后进入“查看记录”，确认新记录已经出现；需要把副本放到应用目录之外时，再从记录页导出 ZIP。

v2.5.2 的备份源码显示，ZIP 会收入 profiles/、config.yaml、verge.yaml、profiles.yaml，存在时还会加入 DNS 配置。WebDAV 地址、用户名和密码会从 verge.yaml 里移除，所以迁移设备前要单独记下 WebDAV 服务器地址和账号，不能假设 ZIP 里全有。

升级前再留两条信息：

客户端版本：Clash Verge Rev v2.5.1
内核版本：Mihomo v1.19.25
当前 Profile：<名称>
系统代理：开 / 关
TUN：开 / 关
服务模式：已安装 / 未安装

这不是做表格留档。回滚后若只有 TUN 失效，你能先恢复服务模式，而不是把整份配置覆盖回去。

怎么核对安装包没有拿错？

GitHub REST API 文档说明 Release 查询结果包含 asset 列表；当前接口会为这些文件返回 digest。下载完成后，先算本地 SHA-256，再和同名 asset 的 digest 比较。文件名必须完全一致；拿 x64-setup.exe 的摘要去比 fixed_webview2-setup.exe 一定不相等。

macOS 或 Linux 可以这样查：

FILE="Clash.Verge_2.5.2_x64-setup.exe"
shasum -a 256 "$FILE"
gh api repos/clash-verge-rev/clash-verge-rev/releases/tags/v2.5.2 \
  --jq ".assets[] | select(.name == \"$FILE\") | .digest"

Windows PowerShell 先计算本地文件：

$File = ".\Clash.Verge_2.5.2_x64-setup.exe"
(Get-FileHash $File -Algorithm SHA256).Hash.ToLower()

没有安装 GitHub CLI 时，浏览器打开 Release API，在页面里搜索完整文件名，再看紧邻的 digest。本地输出应和 sha256: 后面的 64 位十六进制字符串一致。摘要不一致就停止安装，删掉文件并重新从官方 Release 获取。需要保留校验记录时，可照着 GitHub Release SHA-256 校验步骤 把文件名、来源 URL 和摘要放在同一份记录里。

安装后用 5 个信号验收

安装完成后一次只验一个层面。先别同时重导订阅、换覆写脚本、改 DNS 和重装服务模式。

  1. 打开关于页，确认客户端版本是 v2.5.2。
  2. 查看内核版本，确认当前运行的是 Mihomo v1.19.29，不是残留的旧 core。
  3. 更新一份原有 Profile，确认订阅时间刷新；如果来源使用 gzip 或 Basic Auth，重点看日志里是否仍报无效 YAML 或认证失败。
  4. 打开最终 Clash 配置，检查 DNS 覆写与 fake-ip-range6 是否符合你的开关状态。
  5. 只在原先就使用 TUN 的设备上开关一次，确认服务状态、系统路由和首页状态同步。

Linux 用户可用官方 Release 给出的包管理器路径安装。DEB 和 RPM 不要交叉使用：

# Debian / Ubuntu x64
sudo apt install ./Clash.Verge_2.5.2_amd64.deb

# Fedora / RHEL x64
sudo dnf install ./Clash.Verge-2.5.2-1.x86_64.rpm

验证时看日志里的具体错误。订阅更新失败属于 HTTP 或 YAML 层，TUN 启动失败属于 service、接口或路由层，窗口白屏属于 WebView 层。把三类问题混在一起重装，只会丢掉现场。

这些未关闭 Issue 怎么看？

截至 2026-07-25，仓库里仍有与 v2.5.2 或 2.5.x 相关的开放报告。它们是用户提交、尚未关闭的 Issue，不等于维护者已经确认所有设备都存在同一回归。

Issue报告环境与表现遇到相同表现时的动作
#7521Windows 2.5.x 安装 TUN 服务提示 IPC path not ready，提交者同时附了内容损坏的 desired-state.json保留 service 日志和备份；按 Issue 里的关联讨论核对该文件，不要把删除整个配置目录当成通用修复
#7576macOS 使用手机热点时 auto-detect-interface 返回空接口手动记录热点接口、DNS 和出站日志，换普通网络做交叉判断
#7580高级节点编辑时把 name 留空，重新打开页面崩溃不要保存空名称；已经触发时从备份恢复该 Profile

是否延后升级，取决于你的工作路径是否正好命中这些报告。比如你完全不用 TUN、手机热点和高级节点编辑，不必因为三条 Issue 拒绝所有订阅修复。反过来，Mac 长期靠手机热点跑 TUN，就该先保留 v2.5.1 DMG，再在副本配置上试。

出问题时按原路径回滚

只回退程序，不要第一步就覆盖配置。Windows 退出托盘和后台进程后，用保留的 v2.5.1 官方 setup 安装；macOS 退出应用后，用旧 DMG 替换应用；Linux 用对应发行版的旧 DEB 或 RPM 处理降级。操作前再次复制刚才导出的 ZIP。

回到旧版后先看关于页和 Mihomo 版本，再导入升级前的 Profile。只有订阅、覆写或 DNS 配置确实发生变化时，才从 备份设置 → 查看记录 恢复 ZIP。服务模式出错则单独重装服务，不要为了一个 IPC path not ready 把全部 Profiles 清空。

旧版动态仍保留在 Clash Verge Rev v2.5.1 修复说明。如果回滚后故障消失，把 v2.5.1 与 v2.5.2 的客户端版本、Mihomo 版本和第一条错误日志一起附到 GitHub Issue；只有“新版不能用”四个字，维护者无法定位是订阅、TUN 还是 WebView。