User guides
40 tutorials organized by topic: installation & updates, getting started, advanced features, and troubleshooting.
Installation & updates 8
Install Clash Verge on Windows
The complete steps to download and install Clash Verge Rev on Windows 10/11.
Install Clash Verge on macOS
Tell Apple Silicon and Intel chips apart and install the right macOS build.
Install Clash Verge on Linux
Install on mainstream distributions via deb, rpm, or AppImage.
Fix the macOS “app is damaged” warning
One command fixes the “damaged and can’t be opened” message on macOS.
Handling Windows Security false positives
Why antivirus false positives happen and how to add an exclusion and restore quarantined files.
How to update Clash Verge
Update to the latest version via the built-in checker or a manual reinstall.
Complete uninstall and cleanup
Uninstall the client, remove leftover data, and restore the system proxy settings.
Moving from Clash for Windows to Clash Verge
Keep your subscriptions and habits while switching clients.
Getting started 11
Import a subscription link
Import your provider’s subscription link into Clash Verge and activate the profile.
Switch nodes and use proxy groups
Understand how the Proxies page organizes groups and learn to pick and switch nodes.
Enable the system proxy
The first step to route browser and app traffic through Clash Verge.
Rule, Global, and Direct modes explained
Understand the three outbound modes and choose the right one.
Managing multiple subscriptions
Manage multiple profiles: switching, editing, viewing, and the context menu.
Automatic subscription updates
Set an auto-update interval so node changes never leave you offline.
Latency testing and node selection
Read latency numbers correctly and pick stable, suitable nodes.
A quick tour of the Settings page
What every commonly used switch on the Settings page does.
Checking remaining data and expiry date
Read used data, total quota and expiry straight off the profile card.
Setting up global hotkeys
Bind keyboard shortcuts to the system proxy, TUN mode and outbound modes.
Theme and appearance settings
Switch between light, dark and system themes, and customise colours and fonts.
Advanced features 16
Using TUN mode
Capture all traffic through a virtual adapter, covering apps that ignore the system proxy.
Installing service mode
Install the system service so TUN mode runs without administrator prompts.
DNS settings explained
How the built-in DNS works and the adjustments you may actually need.
Writing custom routing rules
Master the common rule types and control exactly where each site goes.
Enhance subscriptions with Merge and Script
Layer personal configuration on top of subscriptions — survives every update.
Port settings and the mixed port
Understand the mixed port and point individual programs at the proxy manually.
Share the proxy with your LAN
Let phones, TVs, and other devices connect through this computer.
WebDAV backup and restore
Back up profiles and settings to the cloud — sync devices, migrate painlessly.
UWP apps on Windows will not use the proxy
Lift the UWP loopback restriction so Store apps connect normally.
Auto launch and silent start
Start with the OS, minimized to the tray, with the proxy restored seamlessly.
Updating the GEO databases
Keep GeoIP / GeoSite data fresh so routing stays accurate.
External controller and web dashboards
Manage the core through the RESTful API and browser dashboards.
Understanding the four proxy group types
When to use select, url-test, fallback and load-balance.
Editing the system proxy bypass list
Keep intranet addresses and chosen domains off the proxy.
Routing WSL2 and Docker through the proxy
Fix apt, pip and docker pull timing out inside containers and WSL.
The IPv6 switch and what it changes
When turning IPv6 on is worth it, and which side effects are normal.
Troubleshooting 5
Client or core fails to start
Locate startup failures step by step: ports, service, config, or a broken install.
No internet after enabling the proxy
Locate the break layer by layer, from nodes to rules — including offline-after-quit.
Fixing port conflicts
Find the program occupying port 7897 (or others), then change ports or end the conflict.
The proxy connects but everything is slow
Work through nodes, rules and your local setup to find the bottleneck.
High CPU or memory usage
Track down what is driving the core: log level, rule sets, connection count, update interval.