Clash Verge guides
40 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.
Getting startedChoosing the Right Clash Verge Installer: Reading the Official Release Page
A release page lists a dozen files at once: x64 or arm64, setup.exe or msi, deb, rpm and AppImage. Check your architecture in ten seconds, then decode the filename and pick correctly.
Getting startedClash, Clash Meta, Mihomo and Clash Verge: How They Actually Relate
The Clash family tree, untangled: original Clash and Premium are archived, Clash Meta was renamed mihomo and is today's core, and Clash Verge Rev or FlClash are just shells around it.
Getting startedWhere to Get Clash Verge When GitHub Is Unreachable
The release page opens but the download stalls, or the whole domain is blocked. Package managers, mirror front-ends and a direct channel — plus why every route ends at the official hash.
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.
AdvancedConverting Subscription Formats: Turning vmess and ss Links into Clash Config
Your provider handed you vmess:// links or a V2Ray-format subscription and Clash rejects it. Three fixes in order of effort: ask for the Clash link, try importing anyway, or run subconverter.
AdvancedChained Proxies and Landing Nodes: relay and dialer-proxy in Practice
Two ways to send traffic through a transit hop before it reaches the landing node: a relay group, or the per-node dialer-proxy field. Config samples, the latency cost, UDP limits and how to verify the chain.
AdvancedRunning Clash on a Headless Linux Box: the Core Plus systemd
A VPS or a command-line-only server cannot run Clash Verge. Run the mihomo core directly: directory layout, a systemd unit, reading logs, automating subscription updates, and locking down remote access.
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.
TroubleshootingClash on Campus and Office Networks: Portals, DNS and Blocked Ports
Four reasons a working config stops working on a restricted network — the captive portal eaten by the proxy, hijacked internal DNS, only 80 and 443 allowed, and intranet traffic taking the tunnel. With a rules snippet you can paste.
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.
TipsFlClash or Clash Verge: Which Client Should You Install
Both wrap the same mihomo core, so subscriptions and configs are fully interchangeable. The real differences are platform coverage and how much of the core the UI exposes — plus whether you can run both.
TipsClash on Android with FlClash: the Right APK, Subscriptions and Staying Alive
Getting a Clash client running on Android: which APK architecture to take, what the VPN permission dialog actually is, importing subscriptions, per-app routing, and the battery settings that stop it dropping when the screen goes off.
TipsYour Subscription Link Is a Password: How It Leaks and What to Check
The token in a subscription URL is account credentials. The four ways it usually leaks — screenshots, online tools, uploaded configs, weak backups — what to do if you suspect exposure, and a two-minute checklist.