FAQ

Clash Frequently Asked Questions

From basics to advanced troubleshooting — the most common questions about using Clash.

Basics

What is Clash?

Clash is a rule-based cross-platform proxy core written in Go. GUI clients like Clash Verge Rev and ClashX Pro are graphical wrappers built on this core.

How is Clash different from a traditional VPN?

Traditional VPNs route all system traffic. Clash supports complex routing rules that precisely separate local traffic from traffic that needs a proxy — keeping speed and compatibility for local apps.

What do I need to use Clash?

Two things: a Clash client for your platform, and a configuration file with proxy node information (usually provided by a third-party service as a YAML file or subscription URL).

Is Clash free?

Yes. The Clash core and the main clients (Clash Verge Rev, FlClash, etc.) are all free and open-source, and can be downloaded from this site at no charge.

Subscriptions & Configuration

What is a subscription link and where do I get one?

A subscription link is a URL that contains proxy node configuration. It's provided by your proxy service in their user dashboard. Clash itself does not ship any nodes.

How do I import a subscription?

Open your Clash client, go to the Profiles / Subscriptions tab, paste your subscription URL and click Download or Update. Then select the profile to activate it.

Config file fails to load / YAML parse error

YAML is strict. Common causes: tabs used for indentation (only spaces are allowed); strings with : not quoted; full-width colons used by mistake instead of ASCII colons.

Connectivity

All nodes time out / cannot connect

Check in order: (1) your local network works; (2) system time is accurate (VMess is sensitive to clock skew > 90s); (3) update the subscription; (4) contact your provider to check account status.

Proxy is on but some apps still can't reach the internet

Some apps (games, UWP apps, terminals) don't use the system proxy. Enable TUN mode: on Windows in Clash Verge, on macOS use "Enhanced Mode" in ClashX Pro.

Startup failed / port in use

The default port 7890 may be in use. Change mixed-port in your config to any free port. On Windows, use netstat -ano | findstr :7890 to find the occupant.

DNS leak / sites still detect a local IP

Enable fake-ip mode in your config and add fallback DNS. See the tutorial for a full example.

Platform-specific

Windows: proxy menu is blank, cannot pick nodes

The core and UI cannot communicate — usually because the firewall blocks the local port. Turn Windows Firewall off and back on, or add an exception for Clash Verge Rev.

Windows: no internet when Clash is not running

Go to Windows Settings → Network & Internet → Proxy → Manual proxy setup, and turn off "Use a proxy server".

macOS: "cannot verify developer" on launch

Run sudo xattr -rd com.apple.quarantine /Applications/ClashX\ Pro.app in Terminal, or click "Open Anyway" in System Settings → Privacy & Security.

Android: "cannot connect VPN" on start

Make sure no other VPN app is running (only one VPN allowed at a time); verify your subscription imported successfully; remove old VPN entries in Settings → Network & Internet → VPN.

iOS: subscription imports but node list is empty

Make sure the subscription URL starts with http:// or https:// and hasn't expired. Open the URL in a browser to confirm it returns valid content.

Didn't find your answer?

Check the full tutorial or grab the latest version on the download page.

View Tutorial