Clash Verge
简体中文繁體中文EnglishفارسیРусский

KNOWLEDGE BASE

Guides

Practical walkthroughs for installation, profiles, rules, TUN mode and troubleshooting—written to be followed, not decoded.

SponsoredGet 1 GB of high-speed Hong Kong data free at signupInstant activation · One-click import into your client · Crypto acceptedGet high-speed nodes
01

Updated July 2026

Install on Windows

The release page carries an x64 installer and a portable archive, and they store data in different places. This is which to take, and what to check on first launch.

Read guide →
02

Updated July 2026

Import a subscription URL

A subscription link is an account credential, so decide who may see it before you paste it anywhere. This covers where the import happens, what usually blocks it, and the step people forget afterwards.

Read guide →
03

Updated July 2026

Choose and test a proxy node

The proxies page has two levels: groups, and the nodes inside them. Click the wrong level and nothing changes. This covers reading that layout, why a switch seems to do nothing, and keeping spare nodes in rotation.

Read guide →
04

Updated July 2026

System proxy vs TUN mode

System proxy and TUN solve the same problem in completely different ways. One hangs a sign in the operating system and hopes programs read it; the other builds a network interface and takes the packets directly.

Read guide →
05

Updated July 2026

Enable TUN mode correctly

With TUN the order matters more than the switch itself: get the system proxy working first, install service mode second, and only then turn TUN on. Skip the first two and you cannot tell which layer failed.

Read guide →
06

Updated July 2026

Fix no internet after enabling proxy

When the client is running and nothing loads, resist the urge to edit the config. Walk back to a bare connection, bring the system proxy up on its own, then add one thing at a time until it breaks.

Read guide →
08

Updated July 2026

Rule, global and direct modes

Rule, Global and Direct are three ways the same core can dispatch your traffic, and switching takes one click. They behave nothing alike, and picking the wrong one is easily mistaken for a dead node.

Read guide →
09

Updated July 2026

DNS settings and troubleshooting

A name resolution problem looks a lot like a broken node: pages will not open, certificates complain, requests land somewhere they should not. This guide covers proving it really is DNS, and what to set on the client side.

Read guide →
10

Updated July 2026

Fix Windows WebView2 issues

The tray icon is there and the process is running, but the main window is blank white or never appears at all. Nine times out of ten the WebView2 runtime that draws the interface is at fault, not the proxy.

Read guide →
11

Updated July 2026

Install and repair service mode

Service mode installs a small system service that holds privileges the client cannot, and TUN depends on it entirely. What it does, where to install it, and why it fails.

Read guide →
13

Updated July 2026

Back up and restore settings

A backup packs your subscriptions, extensions and interface preferences into one bundle and puts the whole set back on restore. Knowing what travels with it and what does not saves a lot of time.

Read guide →
14

Updated July 2026

Sync settings with WebDAV

WebDAV backup asks for only three things: a server address, a username and a password. All the difficulty sits in how deep the address goes and which password the service actually wants.

Read guide →
15

Updated July 2026

Enhance profiles with Merge

Merge exists for one reason: you want extra lines on top of a subscription without losing them every time it updates. It is a YAML fragment layered over the subscription, and an update cannot wash it away.

Read guide →
16

Updated July 2026

Transform profiles with Script

A Script extension is real JavaScript: the core hands your parsed subscription to a function and uses whatever object you return. That power also means one bad line takes the whole profile down.

Read guide →
17

Updated July 2026

Add custom routing rules

The rules that ship with a subscription will never match your habits exactly. Adding a few of your own, to pin one domain to direct or to a specific node, is the most common edit people make.

Read guide →
18

Updated July 2026

Bypass LAN and private addresses

A router admin page that will not load and LAN shares that vanish are usually the same story: private addresses being shipped off to a remote exit. Local ranges have to stay local, and TUN mode makes that harder.

Read guide →
19

Updated July 2026

Allow connections from your LAN

This switch decides whether the core listens only on this machine or on every network interface. Turn it on and the phones, TVs and laptops behind the same router can route through your computer.

Read guide →
20

Updated July 2026

Mixed and controller ports explained

Mixed port 7897 takes HTTP and SOCKS5 traffic on the same number, so other software can point at it either way. External controller port 9097 is a different animal, and confusing the two guarantees failure.

Read guide →
21

Updated July 2026

When to enable or disable IPv6

IPv6 ships disabled for a practical reason: most subscription nodes only hand out an IPv4 exit. Switch it on and the system starts preferring v6, which usually walks straight past the proxy.

Read guide →
22

Updated July 2026

Understand latency tests

The millisecond figure next to a node answers one question: how long a round trip to the test target takes through that node. It is not bandwidth, and it is not how fast a particular site will load for you.

Read guide →
23

Updated July 2026

Troubleshoot slow connections

A node can answer a latency test in 40 ms and still crawl at under a megabyte a second. Work out which kind of slow you have first, then decide whether to change lines or look at your own machine.

Read guide →
24

Updated July 2026

Route selected apps through proxy

Sending one game or one download tool through the proxy while everything else stays direct is done with process-name rules. There is one hard requirement: only TUN mode exposes which process opened a connection.

Read guide →
25

Updated July 2026

Use logs to diagnose connections

The log page is the first thing to open when something breaks. You can change its level, clear it, and watch the core react line by line while you reproduce the fault yourself.

Read guide →
26

Updated July 2026

Update Clash Verge Rev safely

Updating the client is not hard. What goes wrong almost always comes down to three things: no backup beforehand, the program not fully closed during the install, and nobody checking the service and the custom rules afterwards.

Read guide →
27

Updated July 2026

Verify download source and signature

There is exactly one source worth trusting for this client: the project GitHub Release page. Download portals, high-speed downloaders and so-called clean editions in the search results cannot prove the file was left untouched.

Read guide →
28

Updated July 2026

Uninstall and remove leftovers

Removal has an order. Uninstalling while the system proxy is still on leaves the Windows proxy settings behind and takes the whole machine offline. Here is the right sequence.

Read guide →
30

Updated July 2026

Install DEB and RPM packages on Linux

The Linux build ships as a deb and an rpm. This covers which one your distribution wants, why the package manager should install it, and what the tray icon and TUN still need afterwards.

Read guide →
31

Updated July 2026

Which proxy group type to use

select, url-test, fallback and load-balance behave very differently. Pick the wrong one and your exit keeps jumping, or sites log you out for no obvious reason.

Read guide →
34

Updated July 2026

Update GeoIP and GeoSite data

Rules like GEOIP,CN and GEOSITE are not built into the core. They rely on separate data files, and when those go stale or fail to download, whole classes of rules stop matching.

Read guide →