User guides
30 tutorials organized by topic: installation & updates, getting started, advanced features, and troubleshooting.
Installation & updates 7
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.
Getting started 8
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.
Advanced features 12
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.
Troubleshooting 3
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.