How to Install Clash Verge on Windows
Step-by-step install of Clash Verge Rev v2.5.1 on Windows 10/11: picking the right x64 or ARM64 installer, getting past …
Guides
From first install to advanced debugging — 40 tutorials grouped by topic, written against the latest Clash Verge Rev v2.5.x and kept up to date.
Setup8
Install Clash Verge on macOS and Fix the “Damaged” Error
Installing Clash Verge Rev on a Mac: choosing between the Intel and Apple Silicon images, the one-line fix for the “Clas…
Install Clash Verge on Linux: deb, rpm and AUR
Ubuntu and Debian take the deb, Fedora and openSUSE take the rpm, Arch installs straight from the AUR. Plus fixes for Li…
Three Ways to Import a Subscription
Every way to get your provider's subscription into Clash Verge: pasting the URL, importing a local YAML file, and what t…
Migrating from Clash for Windows to Clash Verge
Clash for Windows is archived and unmaintained. Moving to Clash Verge Rev takes ten minutes: subscriptions work as-is, r…
How to Spot the Official Clash Verge Installer
Repackaged Clash Verge installers can carry malware or silently reroute your traffic. The checks that identify the offic…
Uninstall Clash Verge Cleanly and Restore Your Network
Two things you must do before uninstalling Clash Verge: turn off the system proxy and remove service mode. Then delete l…
Updating to the Latest Version — and Rolling Back
Does installing over the old build wipe your profiles? What if the new version refuses your config? How to go back a rel…
Core features10
System Proxy vs TUN Mode: Which One Should You Use?
System proxy relies on apps volunteering to use it; TUN mode captures everything at the network-adapter level. How each …
TUN Mode Explained: Setup and Every Setting
Enable TUN mode in Clash Verge the right way: install service mode, flip the switch, verify traffic capture — plus what …
Rule, Global and Direct Modes Explained
What the Rule / Global / Direct switch in Clash Verge actually changes: rule matching order, when Global mode makes sens…
Proxy Group Types: url-test, fallback and load-balance
Make sense of the groups in your provider's config: url-test picks the fastest node, fallback provides ordered failover,…
What the Latency Numbers Really Mean
The milliseconds in Clash Verge are full HTTP round-trips through the node, not ping. How the test works, what green/yel…
DNS and Leak Protection: How fake-ip Works
Why DNS can leak even with the proxy on, the difference between fake-ip and redir-host, and how to write a fake-ip-filte…
Autostart and Silent Launch
Make Clash Verge start with the OS and go straight to the tray: the autostart toggle, silent start, auto-enabled system …
Global Hotkeys: Toggle the Proxy Without the Window
Bind system-wide shortcuts for system proxy, TUN mode and the main window in Clash Verge: setup, a sensible key scheme, …
Reading the Connections Page: Who Is Eating Your Bandwidth
The Connections page lists every live connection with its destination, traffic, proxy chain and matched rule. Sort it an…
Juggling Multiple Profiles: Switching, Updating, Local Fallbacks
A main provider, a backup, and a hand-written local config. How the Profiles page switches between them, where to set th…
Advanced12
Rule Providers 101: Self-Updating Rule Sets
Stop hand-maintaining hundreds of DOMAIN-SUFFIX lines. How rule-providers work: the YAML syntax, the three behavior type…
The Global Extend Config: Merge and Script
Customizations vanishing every time the subscription updates? Put them in Clash Verge's global extend config: Merge for …
Customizing the Look: Dark Mode, Accent Colors and CSS Injection
Tune Clash Verge's appearance: dark mode, accent colors, traffic-graph options — and for tinkerers, injecting custom CSS…
WebDAV Backup: Sync Profiles and Settings Across Machines
Back up Clash Verge's profiles, rules and settings to Nextcloud or any WebDAV server: server prep, in-app setup, backup …
Share Your Proxy on the LAN: Phones and TVs via Your PC
Turn on Allow LAN and let phones, tablets and TV boxes on the same Wi-Fi ride your computer's Clash Verge proxy: firewal…
Switching Mihomo Core Versions: Stable vs Alpha
Clash Verge bundles both the stable and alpha Mihomo cores. When Alpha is worth it, how to switch and upgrade cores in o…
GeoIP and GeoSite Databases: What They Do and How to Update
The data files behind GEOIP and GEOSITE rules: what geoip.dat, geosite.dat and country.mmdb contain, when they need upda…
Gaming Through the Proxy: Steam Downloads and Online Play
Games ignore the system proxy, so routing them through Clash Verge means TUN mode plus targeted rules. UDP support check…
Streaming Routing: A Dedicated Node for Netflix and Disney+
Split streaming traffic into its own group, pin a node with select instead of url-test, point the domains at it with rul…
Routing AI Services Separately: Stop the IP From Hopping
ChatGPT and Claude are sensitive to your exit IP. Pin one node with a select group, route the domains with a rule set, a…
Getting WSL2 and Docker Through Clash Verge
Inside WSL2, 127.0.0.1 is not your Windows host. Route through the host's LAN IP with environment variables, or switch W…
The External Controller: Driving the Core From Another Panel
external-controller is the core's HTTP API — the hook third-party web UIs and scripts use. How to enable it, why the sec…
Troubleshooting10
Subscription Update Failures: Timeouts, 403s and Parse Errors
A systematic walk through Clash Verge subscription failures: network timeouts, 401/403/404 status codes, and YAML parse …
Port Already in Use: Fixing 7897 Conflicts
Clash Verge won't start because port 7897 is taken: find the offending process with netstat, change the mixed port prope…
Fixing Service Mode Installation Failures
TUN switch greyed out or service install erroring? The fix sequence: reinstall as administrator, purge leftover service …
UWP Apps Bypass the Proxy: The Loopback Fix
Microsoft Store apps can't reach 127.0.0.1 by design, so the system proxy is invisible to them. Fix it with Clash Verge'…
Proxy On but the Browser Won't Load: Full Checklist
Nodes test green yet pages won't open? Check in order: system proxy state, browser proxy extensions, real node usability…
Clash Verge Error Reference
One page for the frequent Clash Verge errors: port in use, config parse failures, core startup crashes, blank window, TU…
Cutting Clash Verge's Memory Usage
Why Clash Verge's memory footprint climbs and how to claw it back: lite mode, trimming rule providers, disabling the tra…
Connected but Slow: Work Through It in Order
Latency and bandwidth are not the same thing. Swap nodes, check remaining quota, turn TUN off, test off-peak — then look…
When Firewalls and Antivirus Block Clash Verge
SmartScreen prompts, antivirus false positives, and a mis-clicked firewall dialog that kills LAN access. Verify the inst…
Reading the Log Page: Find the Fault in Three Minutes
Set the right log level, learn the four parts of a proxy log line, recognise the handful of errors you'll actually meet …