Open-source project · mihomo core

Clash Verge
Downloads

An open-source proxy client built on the mihomo core, with built-in subscription management, rule-based routing, and TUN mode, plus Chinese configuration docs and multi-platform installers.

Download platforms: Windows macOS Linux

Download by platform

Clash Verge is an open-source proxy client built on the mihomo core, supporting Windows, macOS, Linux, Android, and iOS. The client handles subscription management, config generation, and the UI, while the core handles traffic forwarding; the config format is compatible with the broader Clash ecosystem. The download page lists available clients, package formats, and system requirements for each platform, with installers kept in sync with official release channels. The links below jump directly to the download card for each platform.

Core Features

Clash Verge turns common proxy client features into ready-to-use settings: importing a subscription generates a complete config automatically, rule-based routing matches domains and IPs to policy groups, TUN mode takes over system traffic, and the DNS section gives fine-grained control over the resolution chain. The four panels below mirror the real modules in the client's settings page, and each one has corresponding configuration docs and troubleshooting steps in the usage documentation and advanced pages.

Subscription Management

Subscription management imports the subscription URL from your provider into the client and automatically parses it into three config sections: proxies, proxy-groups, and rules. Multiple subscriptions can coexist, and each profile has its own update interval and enabled state; updates only pull remote changes and never overwrite your local override layer. Compared with hand-editing YAML, subscription management collapses node additions/removals and policy group tweaks into a single import. When a link goes bad, the panel shows a parse error that helps you tell whether the link expired, the content format is wrong, or the network is blocked.

Open-source Ecosystem

Both the Clash Verge client and its core are hosted in public repositories, with release history, issue discussions, and commit records all traceable. The information below helps you gauge the project's maintenance status and update cadence.

Project History

Clash Verge originally emerged as a replacement for Clash for Windows, solving the lack of a unified entry point for Windows and macOS users after the original client stopped being maintained. The project uses Tauri for the UI layer and delegates config generation and traffic forwarding to the core, keeping the UI decoupled from the core. As a result, core upgrades don't wait for UI rewrites, and UI updates don't affect already-generated configs.

Core Relationship

mihomo is the actively maintained core in the Clash ecosystem. It's compatible with Clash's config file format and adds rule sets, domain sniffing, and more transport protocols. Clash Verge ships with mihomo built in, and the config.yaml generated after importing a subscription can be read directly by other Clash-family clients, so migration costs are low and configs are interchangeable with ClashX Meta and Clash for Android.

Update Mechanism

The client and core are versioned separately: UI updates focus on settings layout, subscription management, and TUN behavior, while core updates focus on protocol implementations and security fixes. The download page provides installers for each platform, and updates preserve local configs so you don't need to re-import subscriptions; the core binary is also available separately for server and router users.

License and Community

The project is open source under GPL-3.0, with source code, build scripts, and release notes in public repositories. The Issues section tracks reported problems and fix progress. Community-maintained Chinese documentation covers installation, subscription import, rule writing, and troubleshooting; when you run into a problem, search existing discussions by keyword.

Terminal
git clone https://github.com/clash-verge-rev/clash-verge-rev.git

The repository contains client source code, build scripts, and release notes under GPL-3.0. After cloning, follow the build steps in the README to compile installers for your platform locally.

Technical Notes

Hands-on notes on installation, DNS resolution, TUN mode, and subscription troubleshooting, with the three latest posts in reverse chronological order. See the technical notes page for the full list.

The complete Clash Verge Windows setup walkthrough: 7 common pitfalls from downloading the installer to service mode

Walk through the full Windows setup in order: install, import subscription, enable system proxy, switch to TUN. Then break down the issues beginners hit most, one by one — missing WebView2, service installation failures, firewall blocks, and more.

Read more →

Clash DNS configuration explained: how to fill in the nameserver, fallback, and DNS hijacking sections

Starting with enable and listen in the dns section, this post explains field by field how nameserver and fallback divide the work, how fallback-filter filters, and why DNS hijacking in TUN mode only works when paired with Fake-IP.

Read more →

TUN mode vs. system proxy: which layer actually takes over your traffic

Compares how system proxy depends on apps reading proxy settings on their own while TUN takes over all IP traffic through a virtual adapter, explains why command-line tools, games, and UDP apps behave differently under each mode, and covers which scenarios suit each one.

Read more →