FAQ · Troubleshooting Handbook
Clash FAQ
Subscription import failures, nodes timing out across the board, TUN permission errors, system proxy not working, UWP loopback restrictions — 21 frequently asked questions organized into basics, setup, usage, and troubleshooting, each with a fix you can act on right away.
BASIC
Getting Started
Client vs. core responsibilities, supported platforms, and how subscriptions relate to configs.
How does Clash Verge Rev relate to the original Clash?
The original Clash core stopped receiving updates in 2023. Clash Verge Rev is a community-maintained continuation of Clash Verge, with a Tauri-based interface and mihomo (formerly Clash Meta) as its proxy core, which is still actively developed. The division of labor is clear: the client handles the UI, subscription management, and system proxy integration, while the core handles rule matching and traffic forwarding. Most Clash clients referenced today run on this mihomo core under the hood.
Which operating systems does Clash Verge Rev support?
On desktop, it covers Windows 10 and 11 (x64), macOS (separate builds for Intel and Apple Silicon), and Linux (deb and rpm packages). Android and iOS aren't supported directly — use Clash Meta for Android or Clash Plus instead. See the client download page for the full list.
Is Clash Verge Rev free to use?
Yes, the client is free forever and the source code is open. What you'll need to arrange yourself is a proxy source: buy a subscription from a provider, or self-host one. The client only handles importing, managing, and routing traffic — it doesn't come with any nodes.
What is a subscription link, and where do I get one?
A subscription link is a distribution URL your provider issues, usually a standard https URL. The client fetches it on a schedule and pulls down a YAML config containing nodes, proxy groups, and rules. You get this link from your provider's dashboard — this site doesn't provide nodes or parse any third-party subscriptions.
What's the relationship between a config file and a subscription?
Once a subscription is fetched locally, it becomes a config file and shows up in the config list. Multiple configs can coexist, but only one is active at a time. Switching configs swaps the entire node and rule set — handy for running multiple providers side by side, or keeping work and personal setups separate.
INSTALL
Setup & Config
Install blocks, subscription import, system proxy, and auto-launch.
Windows blocked the installer with SmartScreen — what now?
The installer isn't signed with a commercial code certificate, so SmartScreen may flag it on first run. After confirming you downloaded it from this site's download page, click "More info," then "Run anyway." If a corporate device blocks installation via group policy, contact your IT admin.
macOS says the app is damaged or can't be opened?
First, check you grabbed the right build for your chip — arm64 for Apple Silicon, x64 for Intel. Mismatched builds are the most common cause. If Gatekeeper still blocks it, go to System Settings > Privacy & Security and click "Open Anyway." It's best to move the app into the Applications folder before launching it.
How do I import a subscription link into the client?
Open the config page, click "New," set the type to "Remote," paste your subscription URL, and save. Back in the list, select this config to activate it — the client will fetch nodes right away. You can update it manually from the same page afterward, or set an auto-update interval. See the beginner setup guide for the full walkthrough.
Where's the system proxy toggle, and what's the default port?
Turn on "System Proxy" from the settings page — browsers and most desktop apps will route through the proxy automatically, no per-app setup needed. The default mixed port is 7897, handling both HTTP and SOCKS5 requests. If that port's taken, just switch to another free one in settings.
How do I set up auto-launch on startup?
Enable "Launch at Startup" from the settings page. On Windows this uses a startup entry and may prompt for permission the first time; on macOS you can double-check it under Login Items in System Settings. It's also worth enabling "Silent Start" so the main window doesn't pop up every time you boot.
USAGE
Usage Tips
Mode selection, node switching, TUN mode, and LAN sharing.
Rule, Global, or Direct mode — which should I pick?
For everyday use, stick with Rule mode: traffic gets routed per your rule set, with different sites taking different paths. When troubleshooting, switch to Global temporarily — all traffic goes through one selected node, which helps isolate whether the issue is with rule matching. Direct mode disables proxying entirely, sending everything straight out from your machine. You can switch modes from the home page or the system tray menu.
How do I switch nodes and test latency?
The proxy page lists all proxy groups and nodes — click a node name to switch to it. The speed test button in the top-right of a proxy group batch-tests latency; the numbers come from handshake timing against a fixed endpoint, reflecting relative speed on your current network rather than actual bandwidth. For automatic best-node selection, use a url-test type proxy group.
When do I actually need TUN mode?
Turn it on when an app ignores the system proxy — this covers most games, some command-line tools, and UWP apps. TUN mode sets up a virtual network adapter that intercepts all traffic system-wide, so apps don't need to cooperate. Enabling it requires installing a system service or entering admin credentials; you don't need to keep it on for regular browsing.
How do I share the proxy with my phone or TV?
Turn on "Allow LAN" from the settings page. Other devices on the same network should set the proxy server to your computer's LAN IP, with port 7897. See the LAN sharing guide on the blog for detailed steps and security notes. Don't enable this on public networks.
If multiple rules match, which one wins?
Rules are matched top to bottom — the first match wins, and later rules are skipped. The MATCH rule at the bottom catches anything that didn't match earlier. So reordering rules effectively reorders priority; put specific custom rules ahead of general ones.
TROUBLESHOOTING
Troubleshooting
Layer-by-layer diagnosis for expired subscriptions, node timeouts, and a proxy that won't take effect.
Subscription update failed or timed out?
Work through this in order: paste the subscription link into your browser's address bar — if it downloads a text file, the link itself is fine. If the link works but the client can't fetch it, the proxy channel is probably down; switch to Direct mode and try updating again. If the link errors out or says expired, contact your provider to reset it. Remember to re-activate the config once the update succeeds.
All nodes showing timeout — what do I do?
Work through this layer by layer: check if the subscription has expired and update it manually from the config page; confirm your local network actually has internet access; check that you're in Rule or Global mode; then check the logs page for core errors. If all four check out and nodes still time out, it's likely a problem on the node side — try a different node or wait it out.
System proxy is on, but the browser isn't using it?
Three common causes: a browser extension like SwitchyOmega is overriding the system proxy setting — disable it and try again; 7897 port is taken by another proxy tool — change the port or quit the conflicting app; or the target domain got added by mistake to the proxy bypass list — check the "Bypass proxy for these addresses" field.
TUN mode fails to start, says permission denied?
On Windows, TUN relies on a kernel service: go to settings and click "Install Service Mode" — after authorizing it once, you can start and stop TUN with regular permissions. On macOS, the first activation will prompt for your login password to authorize the kernel driver. Devices without admin rights can't use TUN — falling back to system proxy mode covers most use cases.
UWP apps from the Microsoft Store won't use the proxy?
UWP apps are blocked from accessing the local loopback address by default, so the system proxy has no effect on them. Two fixes: use the client's built-in loopback exemption tool to whitelist the app, or just enable TUN mode — since the virtual adapter isn't subject to the loopback restriction. Restart the app after making changes for them to take effect.
Logs keep showing DNS resolution errors?
This is usually caused by upstream DNS being blocked or unreachable. Switch the DNS upstream in your config to a working address, or enable fake-ip mode so the core handles domain resolution directly. If the error only shows up for a handful of domains, those domains are probably just dead — safe to ignore.