mrkeyoor.com_
Wed 23 Sept 00:37 UTC
Self-Hostedevaluationupdated 26 Aug 2026

clash-verge-rev review

The primary documentation for Clash Verge Rev is written in Simplified Chinese, and a separate English README exists. It is a desktop interface for the Mihomo proxy core, giving Windows, macOS, and Linux users visual control over subscriptions, routing rules, system proxy settings, and TUN mode.

+1,343stars / 7d
Verdict

Our Clash Verge Rev install added 710 packages, but the build failed after 95 seconds because the Linux image lacked gdk-3.0; all 15 tests passed. Download the stable package if you already use Mihomo and want visual profile editing across desktop systems. Keep a recovery path for TUN and service changes, since open Windows reports show that those modes can interrupt the whole machine's connectivity.

We ran it

Lab card: what happened when we ran clash-verge-revScreenshot of clash-verge-rev (www.clashverge.dev)
Install✓ · 51s710 packages · 619 MB
Build✗ · 95s
Tests✓ · 9s15 passed · 0 failed of 15 (vitest)
Repo676 files~89,200 lines of source · 33.1 MB · 14 CI workflows · tests dir

Answers from our run

Does clash-verge-rev build from source?

Dependencies installed in 51 seconds (710 packages), and the build failed. We cloned commit 272c095 into a clean Debian container with 3 CPUs and no project-specific setup.

Do clash-verge-rev's tests pass?

Yes: 15 of 15 passed when we ran the project's own test command (vitest). Some failures need services or credentials a bare container does not have.

Who should not use clash-verge-rev?

Anyone looking for a proxy service or included access credentials: the application is a client, and the README's provider promotions are separate commercial offers.

What are the alternatives to clash-verge-rev?

Hiddify, GUI for SingBox, sing-box. Our Clash Verge Rev install added 710 packages, but the build failed after 95 seconds because the Linux image lacked gdk-3.

Setup3/5Easy packaged install, demanding native source prerequisites
Docs3/5Useful multilingual start, with deeper material centered on Chinese
Community5/5Recent push, active reports, and frequent maintenance releases
Maturity4/5Established daily-use client with ongoing platform-specific bugs

Who it’s for

Desktop users who already have a compatible proxy subscription or Mihomo configuration and want a graphical client.
People switching between proxy groups, profiles, rules, and routing modes often enough that a visual editor helps.
Windows, macOS, and Linux users who want one client family across several machines.
Experienced users who can inspect generated configurations and recover when a system proxy or TUN change interrupts networking.

Who it’s NOT for

Anyone looking for a proxy service or included access credentials: the application is a client, and the README's provider promotions are separate commercial offers.
Users who cannot risk a machine-wide network interruption: open issue #7743 reports Windows losing all connectivity when TUN mode is enabled until it is turned off.
Developers wanting a small source build with only JavaScript prerequisites: our checkout installed 710 packages into 619 MB, and the Tauri build stopped because gdk-3.0 was unavailable.
People who need fully English-first support material: an English README exists, but the default README, release notes, and much issue discussion are Chinese.
Operators who want a headless server: this project is a desktop GUI with tray, WebView, service, and virtual-adapter behavior.

Setup reality

At commit 272c095, pnpm installation succeeded in 51 seconds, adding 710 packages and using 619 MB. The build ran for 95 seconds, then failed with exit code 1 because gdk-sys could not find gdk-3.0.pc; the log also said PKG_CONFIG_PATH was unset. Vitest finished in 8 seconds with all 15 tests passing.

Most users can skip source setup and download a packaged release for Windows, macOS, or Linux. They still need a working Mihomo-compatible profile or subscription. System proxy control and TUN mode touch operating-system networking, while service mode can require elevated privileges. WebDAV backup needs a WebDAV server and its credentials.

The source tree is a pnpm workspace with Tauri and Rust prerequisites. It contained 676 files, about 89,200 lines of source, and occupied 33.1 MB before installation. There are 14 CI workflows, a tests directory, and no Dockerfile, which is sensible for a native desktop app but leaves a fresh Linux builder responsible for GUI system libraries.

A practical control panel for Mihomo

Clash Verge Rev wraps the Mihomo proxy core in a native desktop application. Its job is to make a complicated routing configuration manageable: import profiles, select proxy groups, edit nodes and rules, inspect connections, switch system proxy behavior, and enable a TUN virtual adapter. Tauri supplies the desktop shell, while the interface is largely TypeScript and the system layer is Rust.

The default README is in Simplified Chinese. An English version covers installation, release channels, features, development commands, and links to the project documentation. Spanish, Russian, Japanese, Korean, and Persian translations are linked too. English speakers can get started, though releases and much issue discussion still require translation.

This application does not provide proxy access by itself. You bring a subscription or configuration compatible with the embedded core. The promotions in the README and release notes point to commercial services, but those offers are separate from the GPL-licensed client. That distinction matters because a polished connection screen can look like a complete VPN product to a newcomer.

Why the desktop interface earns its place

Mihomo configurations can express proxy groups, routing rules, DNS behavior, providers, scripts, and several traffic modes. Editing all of that as YAML is workable for an administrator and unpleasant for a person who changes endpoints daily. Clash Verge Rev adds visual node and rule editors, syntax hints, profile merge and script helpers, theme controls, tray actions, and connection views.

System proxy mode is the lower-impact route for applications that honor operating-system proxy settings. TUN mode creates a virtual network adapter so more traffic can be routed, but it also reaches deeper into the host. The client includes a guard mode and a privileged service path for these jobs. Users should know how to disable the mode or restore network settings before experimenting, especially on a remote machine.

Profile backup through WebDAV is useful across several desktops. It also introduces another store containing sensitive connection details. Choose a server you control, protect its credentials, and understand what the selected backup includes. The README confirms the feature but does not turn that decision into a security policy for you.

What happened when we ran it

We cloned commit 272c095 into an unprivileged fresh Debian container with three CPUs, 8 GB of RAM, Node 22, and no secrets. The repository contained 676 files and about 89,200 lines of source. Its checkout occupied 33.1 MB. pnpm installation succeeded in 51 seconds, adding 710 packages and consuming 619 MB on disk.

The build failed after 95 seconds with exit code 1. The final log came from the Rust gdk-sys crate: gdk-3.0.pc could not be found, the gdk-3.0 package was unavailable to pkg-config, and PKG_CONFIG_PATH was not set. The error recommended installing the library metadata or pointing PKG_CONFIG_PATH to it. That is the evidence we have; the log did not show a JavaScript or application-code failure.

Vitest completed in 9 seconds. All 15 tests passed, with zero failures. The repository has a tests directory and 14 CI workflow files, yet those 15 tests are a small automated surface for a cross-platform networking application of this size. There is no Dockerfile, which fits software that must integrate with a real desktop, tray, service manager, WebView, and virtual network adapter.

For contributors, the README reduces development to installing Tauri's prerequisites, running pnpm i, running the prebuild task, and starting the development command. Our result shows how much weight sits inside that prerequisites clause. A clean Linux environment needs native GUI libraries before the Rust half can compile.

Packaged releases are the sensible default

Stable downloads cover Windows, macOS, Debian-family Linux, and RPM-based distributions across several processor architectures. The project also publishes rolling AutoBuild packages for testing. Its README labels that channel experimental and says defects should be expected. Most people should choose the stable installer matching their platform rather than recreating the release toolchain.

Release 2.5.2 arrived on July 19, 2026. Its long fix list spans subscription parsing, WebDAV behavior, Linux updates, macOS windows and tray behavior, Windows TUN startup, DNS editing, global hotkeys, traffic totals, and proxy-group state. The breadth shows active maintenance and also explains why desktop proxy clients need testing on each operating system. A fix in one integration path does not establish that every network stack behaves alike.

The repository was pushed on August 26, 2026. GitHub's open count of 415 includes issues and pull requests, and new reports were receiving updates the same day. This is an active project with an active support burden, not a finished utility.

Current bugs can affect the whole machine

Issue #7743 reports that enabling TUN in service mode on Windows disconnected all networking, while turning TUN off restored it. The report covers versions 2.5.2 and 2.4.7 and says changing stack mode did not help. One report does not prove a universal defect, but its consequence is serious enough to justify testing TUN locally before relying on it.

Issue #7688 describes the lightweight-mode control becoming unresponsive on Windows 11, temporarily recovering after restart, and producing no application log when clicked. That is less damaging than a network outage, yet it illustrates the debugging difficulty of a Tauri interface, service IPC, tray behavior, and core process sharing one product.

Clash Verge Rev is easiest to recommend to an experienced Mihomo user who values its configuration model and wants a good desktop surface. New proxy users may find Hiddify simpler, while server operators should use a headless core. For this client, prefer stable packages, export a known-good profile, and test privileged modes while you still have another way to reach the machine.

Alternatives

ProjectWhat it isPick it when
HiddifyA cross-platform proxy client built around several protocols and cores.pick this instead when protocol breadth and a mobile-friendly client family matter more than Mihomo-specific controls.
GUI for SingBoxA desktop interface for sing-box and other supported cores, built with Go and Vue.pick this instead when you want a desktop GUI centered on sing-box rather than the Clash and Mihomo configuration model.
sing-box gh↗A command-line universal proxy platform with broad inbound and outbound support.pick this instead when you prefer a headless, scriptable core and can manage configuration without a desktop interface.

What people are saying

  1. [github-trending] clash-verge-rev/clash-verge-rev

Sources

  1. Clash Verge Rev English README
  2. Clash Verge Rev release v2.5.2
  3. Windows TUN connectivity issue #7743
  4. Lightweight mode issue #7688

More self-hosted reviews

radar · sftpgo · mailcow-dockerized · openGym · BackPack · PanWatch · the whole board →