On 2026-07-19 Clash Verge Rev published v2.5.2 on GitHub. Versus May’s v2.5.1, it’s mostly fixes—not a flashy feature drop. This site’s download center now serves v2.5.2 packages.
If you’ve been fighting gzip subscription imports, sticky “communication error” cards, macOS blank windows, or phones that can’t use the PC proxy, update. New installs should skip v2.5.1 entirely.
Release facts and packaging
Tag v2.5.2, stable (not prerelease). Get the installer from this site’s download center. Practical Linux change: no AppImage—portable builds are .app.tar.gz; keep DEB/RPM for distro installs.
Bundled Mihomo v1.19.29
Daily users shouldn’t swap core binaries by hand. Earlier notes on v1.19.27 security fixes are carried by later cores; trust what the desktop build ships.
Fixes that matter on a desktop
- Subscriptions: gzip misread as bad YAML; empty-password Basic Auth; clearer old-TLS errors.
- Stability: connections-page leak; macOS WebView blank under memory pressure; false home communication errors; UI jump while the core starts slowly.
- Networking: Allow-LAN still failing; URLTest groups missing from pickers.
- Backup/advanced: quirky WebDAV; script validation tripped by console; DNS override editor; missing fake-ip-range6 with Fake-IP + IPv6.
Also see subscription update failed, core communication, and WebDAV backup.
Smaller UX wins
Group filter/sort/jump, configurable fake-ip-range6, restore-default for global scripts, lighter WebSocket when the page is hidden. Chain/script deep dives: chain proxy, scripts.
A calm upgrade path
- Optional backup (export or WebDAV).
- Quit the app; over-install from the download center.
- Refresh the subscription, ping a few nodes, confirm System Proxy/Tun still match your habit.
- Port mismatches: ports; empty groups: blank groups.
Coming from older builds, skim v2.5.1 / v2.5.0 then jump to v2.5.2. Over-install usually keeps config.
Quick FAQ
Will I lose subscriptions? Usually no—back up first if you ever wiped the config folder.
Separate Mihomo binary? No; use bundled v1.19.29.
Windows 7? Dropped since v2.5.1; v2.5.2 targets Win10/11.