Open-source desktop client · Subscriptions and overrides

Clash Verge RevOfficial site

Download Clash View guides

Desktop downloads and setup guides for a proxy client powered by Mihomo, bringing subscriptions, rules, and local overrides together. Start with your platform for desktop setup and mobile client recommendations.

Mihomo core·GPL-3.0 open source·Tauri desktop framework

CONFIGURATION DESK

Mihomo, TUN, and subscription overrides

Follow the client from configuration sources to connection logs. This diagram shows how settings are organized; available switches, permission prompts, and fields depend on your installed client and core documentation.

Runtime components / Core

The interface manages settings; the core parses the configuration and handles connections.

How the core and client work together

Mihomo reads the configuration, matches rules, resolves domains, and establishes proxy connections; Clash Verge Rev provides subscription management and desktop settings. If a protocol or configuration field is unavailable, first distinguish interface options from core capabilities, then inspect the runtime configuration and startup logs. Unlike editing static files alone, a desktop client brings profile selection, mode switching, and error messages together in one place. That does not make extension syntax interchangeable across clients. Before migrating, keep a copy of the original configuration and check each field against the core's supported options.

Explore advanced usage →

Check the configuration layers before changing settings

A running configuration may combine a remote subscription, local files, global extensions, and subscription-specific extensions. What you see in an editor may not be what the core ultimately receives. If a saved setting has no effect, first confirm which profile is selected, then check the corresponding field in the runtime configuration. Don't infer the outcome from a switch's position alone, and avoid putting temporary changes in files that subscription updates will replace.

For your first setup, enable only the system proxy and rule mode. Once your browser works, add TUN, rule providers, or DNS changes as needed. Change one configuration layer at a time and note how things behaved before and after; this makes it easier to restore a working setup if DNS resolution fails, LAN access breaks, or a particular app can't connect. For complete examples covering proxy groups, rule providers, and domain sniffing, see the Advanced Configuration Guide.

CLIENT SELECTION

Choose a Clash client for your platform

Clash Verge Rev is for desktop systems. Phones and tablets need a client designed for their platform; desktop installers won't run on them. Interfaces and extension settings also vary between clients.

Windows

A good fit for desktop users who need a system proxy, service mode, and TUN. Choose the installer for your system architecture, confirm the client starts normally, then import your configuration. If you already use another proxy app, turn off its system proxy and virtual interface routing first to prevent both clients from changing network settings. The download center also lists options such as Clash Plus and Clash Verge Rev; archived apps are clearly marked with their maintenance status.

Go to downloads

macOS

Check System Information to see whether your Mac has Apple silicon or an Intel processor, then choose the matching build. The system proxy works for everyday browser use; TUN requires service permissions and routes network traffic. If you see a security prompt on first launch, verify the source of the app and read the prompt carefully. Don't weaken your security settings long-term for a single app. You can migrate subscriptions from an older client, but check any client-specific scripts and shortcuts again.

Go to downloads

Android

Mobile clients route traffic through the system VPN interface and require your approval when enabled. Background activity, per-app proxy settings, and battery optimization can all affect connection stability. Test access with the app in the foreground first, then adjust background restrictions if you experience disconnections. The download center links to Clash Plus, Clash Meta for Android, FlClash, and Surfboard. Check each app's supported configuration formats and rule features before importing.

Go to downloads

iOS

Use the download center to open the Clash Plus page on the App Store. The project's official site is clashplus.io. After installing, import a valid configuration and follow the system prompts to authorize a VPN configuration. Desktop global extension scripts and settings are not necessarily available on mobile. When migrating, first check that the subscription parses, then test rules, DNS, and required protocols one by one instead of copying every desktop extension at once.

Go to downloads

Linux

Desktop users can choose Clash Verge Rev or FlClash based on their distribution's package format. Read the relevant dependency requirements before installing. Launching the graphical interface, configuring the system proxy, and granting TUN service permissions are separate checks; an interface that opens normally doesn't mean traffic is being routed. Server and router users can find the Mihomo core in the download center and manage configuration, processes, and logs independently, rather than applying desktop steps to a remote environment.

Go to downloads

Compare platform support, maintenance status, and configuration options before migrating from your current client.

View all clients →
FIRST CONNECTION

From subscription import to connection testing: three checks

The client itself does not provide proxy service. Before you start, prepare a working subscription URL or local configuration, and keep your current network settings so you can restore them if something goes wrong.

  1. Import a subscription and select the profile

    Add a subscription URL on the Profiles page, or import a local YAML file. Wait for parsing to finish, make sure the profile is selected, then open Proxies to check its groups. Seeing a subscription card doesn't mean the configuration loaded successfully. If you get a parse error, check the file contents and whether the format is supported before enabling more network settings.

  2. Choose rule mode and an outbound

    For everyday use, start with rule mode and choose an available outbound in a proxy group defined by your subscription. Turn on the system proxy, then open a new browser connection. Rule mode determines which policy handles each request; the system proxy determines whether an app sends requests to the client. They are not interchangeable. Leave TUN off for now and verify the simplest connection path first.

  3. Verify requests on the Connections page

    Visit a site that needs testing and check whether its request appears on the Connections page and matches the expected rule. If there's no entry, check the app's proxy settings first. If an entry appears but fails, check DNS, the proxy group, and the outbound. Only after the browser works should you consider enabling TUN for apps that ignore the system proxy; then repeat the same checks.

Set up startup and background behavior after verifying the connection, so a broken configuration doesn't load every time you start the app.

View the complete guide →
SOURCE & MAINTENANCE

Open source and configuration maintenance

Use the source code, release notes, and runtime logs to understand how the software works. The client, proxy core, and subscription service are separate components, and should be maintained and troubleshot separately.

How Clash Verge Rev fits into the project

Clash Verge Rev builds on Clash Verge's approach to desktop configuration management, using Tauri for its desktop interface and Mihomo as its proxy core. The source code is available under the GPL-3.0 license. The Profiles, Connections, Rules, and Logs pages provide ways to manage core features; protocol support, DNS handling, and rule syntax are documented by Mihomo. To check whether a feature is available, consult the relevant project's release notes and test the actual configuration rather than relying on the app's name.

Community contributions and reproducible issues

The open-source repository includes source code, issue discussions, and change history. When reporting a problem, include your operating system, installation method, reproduction steps, and where the error occurred, along with redacted logs. Simply saying that you can't connect makes it hard to tell whether the issue comes from configuration parsing, traffic routing, or the remote outbound. A minimal reproducible example is more useful than a full subscription and reduces the risk of exposing credentials or browsing history.

Updating the client and the core

The desktop interface and proxy core change in different ways; updating the client doesn't mean you need to rewrite every local override. Before updating, save your subscription sources and extension settings, then read release notes about the system proxy, service mode, and configuration merging. After updating, test your original minimal configuration before restoring advanced features. If an error appears only after enabling an extension, reduce that extension first rather than changing the subscription, core, and DNS all at once.

Back up subscriptions and local settings separately

Remote subscription updates can change proxies and rules, while local overrides store your personal preferences. Keep separate records of subscription sources, proxy group selections, port settings, and extensions instead of saving only a temporary runtime file. The runtime configuration is useful for checking the merged result, but may not be suitable as the source for your next import. When switching clients, migrate reusable subscriptions first, recreate client-specific settings, and keep a restorable copy of your original setup.

GPL-3.0Open source

View Clash Verge Rev source code

These commands download the source code only. To run the desktop client, use an installer from the download center. Building from source requires the tools specified by the project.

git clone https://github.com/clash-verge-rev/clash-verge-rev.git
Open project repository ↗

RECENT NOTES

Client setup and migration guides

Find instructions for everything from your first import to migrating an existing configuration. Mobile background settings and desktop overrides are covered separately, so you can avoid applying steps meant for another platform.

View all articles →