Clash Verge guides
30 tutorials covering setup, core features, advanced configuration and troubleshooting. New here? Start with the five-minute quick start and work through the basics in order.
Getting started
Clash Verge Quick Start: From Install to Connected in Five Minutes
New to Clash Verge? This walkthrough covers the shortest path: install the app, import your subscription, pick a node and switch on the system proxy — connected in about five minutes.
Getting startedInstalling Clash Verge on Windows: Step-by-Step with SmartScreen Fix
A complete Windows 10/11 install guide for Clash Verge: choosing the right installer, getting past SmartScreen, first-launch prompts, plus fixes for ARM devices and the blank-window issue.
Getting startedInstalling Clash Verge on macOS and Fixing the "Damaged App" Error
Install Clash Verge on a Mac: pick the Intel or Apple Silicon image, get past Gatekeeper's "app is damaged" block with one command, and grant the helper permissions.
Getting startedInstalling Clash Verge on Linux: Ubuntu, Debian, Fedora and Arch
Install Clash Verge on Linux with deb or rpm packages, handle dependencies, use the AUR on Arch, grant TUN capabilities, and work around known Wayland quirks.
Getting startedImporting a Subscription into Clash Verge: URL, Local File, Auto-Update
The three ways to add a subscription to Clash Verge — pasting the URL, importing a local YAML file, and one-click deep links — plus auto-update intervals and multi-profile management.
Getting startedUpdating Clash Verge: In-App Updates and Manual Reinstalls
Two ways to keep Clash Verge current — the built-in updater and installing the new version over the top. What survives an update, what to back up first, and how to roll back.
Features
System Proxy vs TUN Mode: Which One Should You Use?
Why some apps ignore your proxy: the difference between Clash Verge's system proxy and TUN mode, which traffic each one captures, and a simple decision table.
FeaturesEnabling TUN Mode in Clash Verge: Service Mode and Key Settings
Turn on TUN mode in Clash Verge step by step: install Service Mode, flip the TUN switch, and understand the stack, DNS hijack and strict-route options — with platform notes.
FeaturesRule, Global and Direct Modes in Clash Verge, Explained
What the three proxy modes at the top of Clash Verge actually do: how the rule engine matches connections, when Global is useful, and why Direct is not the same as quitting.
FeaturesLatency Testing in Clash Verge: What the Numbers Really Mean
How Clash Verge measures node latency, what counts as a good number, when to trust url-test auto-selection, and why low latency is not the same as high bandwidth.
FeaturesAuto Launch and Silent Start in Clash Verge: Set It and Forget It
Configure Clash Verge to start with Windows, launch minimized to the tray and restore the last proxy state — plus what to check when autostart silently stops working.
FeaturesUpdating GeoIP and GeoSite Data in Clash Verge
GEOIP and GEOSITE rules depend on bundled databases that age quickly. How to update geoip.dat and geosite.dat in Clash Verge, fix failed updates and switch data sources.
FeaturesClash Verge Tray Menu and Hotkeys: Run It Without the Window
The tray menu covers mode switching, system proxy and TUN toggles; add global hotkeys and the main window becomes optional. Setup and suggested key combos inside.
FeaturesWebDAV Backup in Clash Verge: One Config for All Your Machines
Back up Clash Verge profiles, settings and custom rules to Nextcloud, Koofr or a NAS over WebDAV, and restore them on any device. Address formats and common errors included.
Advanced
Understanding the Clash Config File: proxies, proxy-groups, rules
A guided read-through of a Clash/Mihomo config: global fields like ports and mode, node definitions in proxies, selection logic in proxy-groups, and the rules list that routes traffic.
AdvancedMerge and Script in Clash Verge: Customize Without Touching the Subscription
Edits to the subscription file vanish on every update. Clash Verge's Merge and Script layers apply your changes on top: extra rules, DNS overrides, new groups — permanently.
AdvancedWriting Clash Rules: Domain, IP and Process Matching in Practice
A working reference for Clash/Mihomo rule syntax — DOMAIN-SUFFIX, IP-CIDR, PROCESS-NAME, RULE-SET — with matching order explained and three copy-paste examples.
AdvancedDNS in Clash Verge: fake-ip, Encrypted Resolvers and Leak Protection
A DNS leak reveals every domain you visit to the local network. How Clash handles DNS, why fake-ip is the right mode, a proven config template and how to test for leaks.
AdvancedSharing Clash Verge Over the LAN: Phones, TVs and Consoles
Turn one PC running Clash Verge into a proxy gateway for the whole network: the Allow LAN switch, firewall rules, and per-device setup for iOS, Android, smart TVs and game consoles.
AdvancedThe Clash External Controller API: Scripting Your Proxy
The Mihomo core exposes a REST API — query status, switch nodes, change modes over HTTP. Enabling external-controller, authenticating, and the endpoints worth knowing.
Troubleshooting
Fixing "Address Already in Use": Clash Verge Port Conflicts
Clash Verge fails to bind port 7897? Find the process holding it with netstat, decide whether to kill it or move Clash to another port, and stop it from recurring.
TroubleshootingClash Verge Won't Start: Blank Window, Crashes and Core Errors
A systematic path through Clash Verge startup failures: blank window means WebView2, crashes point to antivirus or cache, and the Logs page names exactly what stops the core.
TroubleshootingUWP Apps Bypass Your Proxy? The Windows Loopback Exemption Fix
Microsoft Store, Xbox and Mail can't reach a localhost proxy because of Windows network isolation. Fix it with CheckNetIsolation or TUN mode — commands included.
TroubleshootingSubscription Import Failed in Clash Verge: 403, Timeouts, Bad Format
A checklist for failed subscription imports: what each HTTP status code means, spotting the wrong link format, the two-way "update via proxy" trick, and provider-side limits.
TroubleshootingClash Verge Using Too Much Memory? Five Settings That Actually Help
Why verge-mihomo climbs to hundreds of megabytes — log level, connection count, oversized subscriptions, health-check frequency — and the config changes that bring it down.
TroubleshootingCleanly Uninstalling and Reinstalling Clash Verge
The complete removal checklist — program files, both AppData folders, the background service and the system proxy setting — plus what to back up when the goal is a fresh reinstall.
Tips
Migrating from Clash for Windows to Clash Verge in Ten Minutes
The complete post-CFW migration path: recovering your subscription URLs, translating Mixin to Merge, a settings location map, and the right order to remove CFW.
TipsProxying the Terminal: git, curl, npm and docker One by One
CLI tools ignore the system proxy. Environment variable syntax for PowerShell and bash, per-tool settings for git, npm, pip and docker, and aliases for one-word toggling.
TipsGaming Through Clash Verge: TUN, UDP and Node Choice Done Right
Using Clash Verge as a game accelerator: why TUN is mandatory, how to verify UDP passes end-to-end, why jitter beats latency as a metric, and direct rules for local games.
TipsSpotting Fake Clash Verge Downloads: Sources and SHA256 Checks
Search results for Clash Verge downloads are littered with repackaged installers. Learn the one official source, how to verify SHA256 checksums, and the telltale signs of fake sites.