Clash FAQ — Frequently Asked Questions

Collection of beginner questions covering client choice, installation, subscription import, and proxy settings. Jump directly to find quick solutions.

4Categories
24Hot Issues
5Platforms
No matching questions found

Getting Started with Clash

Must-read before using Clash — Understand what it is, what it does, and differences between clients

Can I directly access the global web after downloading Clash?

No. Clash is only a network proxy tool and rule-based routing engine; it does not provide any network nodes or servers itself. You need to prepare your own proxy nodes (usually provided by service providers) and import them into the client via a subscription link before use.

What is the difference between Clash Verge Rev and FlClash? Which should I choose?

Clash Verge Rev: A desktop client based on the Tauri framework. It is feature-complete, supporting all advanced features like TUN mode, scripts, and Rule Providers. Suitable for users with some technical background.

FlClash: Built with Flutter, featuring a Material You style. It has a clean interface and a low barrier to entry, making it ideal for beginners seeking ease of use.

Both support the same subscription format, so switching only requires re-importing the subscription link without re-configuration.

What are the differences between clients on various platforms? Are the underlying cores the same?

The core of Clash (Mihomo Core) is consistent across platforms; the various clients are simply different graphical user interface (GUI) wrappers.

For Windows / macOS / Linux, Clash Verge Rev is recommended; for Android, FlClash; for iOS, Shadowrocket or Stash. All use the same proxy core underneath.

What are "Rule Mode" and "Global Mode"? What's the difference?

Rule Mode: The default and recommended mode. It intelligently splits traffic based on a rule list—domestic sites are direct for speed, international traffic goes through the proxy, and ad domains are rejected. Best experience.

Global Mode: All traffic goes through the proxy without splitting. This adds unnecessary latency and may affect domestic payment and banking services. Not recommended for daily use.

Direct Mode: All traffic connects directly without going through the proxy. Useful for temporarily disabling the proxy while keeping the client running.

Why is Clash for Windows marked as "Archived"?

The original author deleted the repository and stopped updates in November 2023. Existing installers still work but will no longer receive security fixes or new features.

Strongly recommended to migrate to Clash Verge Rev; configuration formats are fully compatible. Simply re-import your existing subscription link when migrating.

How to get and update routing rules?

Normally, the subscription configuration (YAML format) you import from your provider already includes preset routing rules, so no extra action is needed.

If you need custom rules, Clash Verge Rev supports manual configuration updates on the "Subscription" page, or you can enable "Auto Update" in settings (24-hour interval recommended) to have the client periodically pull the latest rule sets.

Clash Download & Installation

Choose the right version and install smoothly to solve platform differences and architecture selection issues.

Which client should beginners choose?

Windows / macOS: First choice is Clash Verge Rev, modern interface, continuous updates.

Android: FlClash, Material You design, one-click subscription import.

iOS: Shadowrocket (~$2.99), best cost-performance, requires US Apple ID.

Linux: Clash Verge Rev (with desktop GUI) or Mihomo CLI (server / headless environment).

Which version for M1 / M2 / M3 / M4 Mac?

For Macs released after late 2020 with Apple Silicon (M-series chips), download the ARM64 version (filename contains arm64).

For Macs before 2020 with Intel processors, download the x64 version (filename contains x64).

Check the chip model in Apple Menu -> "About This Mac". If unsure, try ARM64 first; switch to x64 if installation fails.

ARM64 or ARMv7 for Android phones?

Directly download ARM64—almost all phones released after 2016 are ARM64-v8a architecture.

Only switch to the ARMv7 version (suitable for a few pre-2015 devices) if the installation prompts "App not installed".

Why is iOS paid? Are there free ones?

Due to Apple policy, proxy apps are not available on the Mainland China App Store, and all iOS Clash-compatible clients are paid.

Currently, there are no feature-complete free iOS clients. Shadowrocket (~$2.99) is the most cost-effective option, offering a lifetime use for a single purchase.

To purchase, you need to prepare a US (or HK) Apple ID. You can buy US iTunes gift cards from e-commerce platforms to top up, no credit card required.

What to do if macOS installation prompts "cannot be opened because the developer cannot be verified"?

This is a routine Apple Gatekeeper block for non-notarized software. Steps to resolve:

① Double-click .dmg -> Drag to Applications -> Click "OK" to close the popup on first open

② Go to "System Settings -> Privacy & Security", find the prompt for Clash Verge Rev, and click "Open Anyway"

③ Open the app again to run normally (no need to repeat this thereafter)

Slow download speed?

Installers on this site are hosted directly on domestic servers, no need to access overseas sites. If still slow, suggested:

① Avoid peak hours (late night has more bandwidth)

② Use multi-threaded download tools like IDM / Motrix

③ If another proxy is available, enable it before downloading

Subscription & Config

Subscription link import, configuration management, and auto-update issues

How to import subscription into Clash Verge Rev?

① Open Clash Verge Rev -> Left "Subscription (Profiles)"

② Paste provider subscription link (starts with https://) in the top input box -> Click "Import"

③ Wait for node list to finish downloading -> Click card to set as current config

④ Go to "Proxy" page choose node -> Enable "System Proxy"

Subscription import failed, showing "Fetch Failed" or "Network Error"?

① Expired link: Log in to your provider's user center and get the latest subscription link.

② Cannot access subscription address: The subscription server might be blocked. Try importing after connecting via another proxy, or contact your provider to change the subscription domain.

③ Incomplete link: Ensure the link starts with https:// and has no extra spaces or line breaks.

④ Antivirus block: Temporarily disable Windows Defender or third-party security software and try again.

How to manually or automatically update the subscription node list?

Clash Verge Rev: Click the "Refresh" icon on the card on the "Subscription" page to update manually; or click "Edit" on the card, check "Auto Update", and set the interval (24 hours recommended).

FlClash (Android): Long-press the config card on the "Config" page and select "Update"; you can also enable auto-update in the edit settings.

Shadowrocket (iOS): Click the corresponding subscription on the "Home" page and pull down to refresh, or enter edit mode and click "Update".

How to import subscription into FlClash (Android)?

① Open FlClash -> Click "Config" on bottom navigation

② Click "+" in top right -> "Import from URL"

③ Paste subscription link, enter name, click "Save"

④ Wait for download -> Click card to activate -> Click bottom start button to enable VPN

How to import subscription into Shadowrocket (iOS)?

① Open Shadowrocket -> Click "+" in top right

② Select Subscribe for "Type"

③ Paste provider subscription link in URL, enter remark name

④ Click "Done" -> Return to home, toggle "Not Connected" switch -> Authorize VPN request

The config file is YAML. Can I modify it with Notepad?

Yes, YAML is a plain text format. Any text editor can open it. VS Code or Notepad++ is recommended for syntax highlighting support, making editing less error-prone.

Note that YAML is indentation-sensitive. Use spaces (not Tab) for indentation, otherwise import errors may occur.

Clash Proxy Settings & Troubleshooting

Methods for resolving issues with proxy activation, command-line tools not using proxy, and high node latency.

How to tell if the proxy has successfully taken effect?

After enabling proxy, visit https://ip.sb or https://whatismyip.com. If the displayed IP is from the node's country/region (USA, Japan, HK, etc.), the proxy is active.

If the IP is still domestic, check: ① if the proxy switch is on; ② if the node is available (speed test on "Proxy" page); ③ try switching to other nodes.

What is the difference between TUN Mode and System Proxy? Which one should I use?

System Proxy: Only proxies apps supporting HTTP/HTTPS/SOCKS (browsers, most GUI software). Command line tools do not go through proxy by default. Simple for daily use.

TUN Mode: Intercepts all system TCP/UDP traffic via a virtual network card; all apps and command line tools pass through the Clash rule engine. Suitable for developers.

Recommendation: Use System Proxy for daily use; enable TUN mode when terminal tools (git, npm, pip) need proxy.

Browser works, but git / npm / pip and other terminal tools cannot connect?

This is a known limitation of System Proxy mode: Terminal tools do not read system proxy settings by default.

Recommended Solution: Enable TUN Mode in Clash Verge Rev settings to intercept all system traffic, allowing terminal tools to automatically use proxy.

Alternatively, you can temporarily set proxy environment variables in the terminal (Clash defaults to port 7890):

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890
What to do if node latency is very high or it disconnects frequently?

① Test and Switch: Click "Speed Test" on the "Proxy" page and choose a node with latency below 100ms.

② Use Auto-Select: Select "URLTest (Auto Select)" in the proxy group. Clash periodically tests speed and automatically switches to the lowest latency node.

③ Change Node Region: Try nodes in nearby regions like Hong Kong, Japan, or Singapore for lower latency.

④ Try Hysteria 2 Nodes: Based on QUIC, these are far superior to traditional TCP nodes in high packet loss environments.

What if domestic site access slows down after enabling proxy?

Confirm you are using Rule Mode instead of Global Mode. In Rule Mode, domestic traffic connects directly for speed and does not go through proxy nodes.

If domestic is still slow in Rule Mode, it may be due to an incomplete rule set; check the "DIRECT" group on the "Proxy" page for any domestic domains misassigned there.

Proxy settings remain after closing the client, causing no internet in the browser?

This happens when "System Proxy" was not turned off before exiting. Solution:

Method 1 (Recommended): Reopen Clash Verge Rev, turn off the "System Proxy" switch, then exit.

Method 2: Manually clear system proxy—Windows: "Settings -> Network -> Proxy" turn off manual proxy; macOS: "System Settings -> Network -> Proxy" uncheck all.

Didn't find your issue?

View the complete tutorial or visit the download page for the latest client version.

View Tutorial Go to Download