How do I use a Clash subscription link?

Clash clients do not provide nodes directly; you need to purchase a proxy service (airport), which provides a Clash-format subscription link. Paste this link into the 'Config' or 'Subscription' page of your client and click import to download all nodes.

What are the differences between 'Rule', 'Global', and 'Direct' modes?

Rule Mode (Recommended): Automatically splits traffic based on rules—local traffic goes direct, while international traffic uses a proxy. Global Mode: Routes all traffic through a proxy node. Direct Mode: All traffic connects directly without a proxy. Rule mode is recommended for daily use.

What is the difference between TUN Mode and System Proxy?

System Proxy only works for browsers and apps that support proxy protocols. TUN Mode operates at the network layer to intercept all traffic, including games and CLI tools. System Proxy is sufficient for most users, while TUN Mode is best for gaming or command-line work.

Why can't I access websites after enabling Clash?

Check: 1. Node selection and latency (via proxy page test); 2. System Proxy switch is ON; 3. Subscription is successfully imported and updated; 4. Try switching to 'Global' mode for testing; 5. Ensure security software isn't blocking Clash.

Visual Tutorials · Beginner Friendly · Start in 5 Minutes

Clash Tutorials
Full Platform Configuration Guide

Step-by-step visual guides for Windows, macOS, Android, iOS, and Linux. From installation to subscription import, complete your configuration in 5 minutes with zero experience required.

Zero Experience Needed

Covers All Platforms

Sync with Download Page

Continuously Maintained

Windows Tutorial

Windows 10 / 11 x64 · ARM64 Recommended Client: Clash Verge Rev

Go to Download

Download Installation Package

Go to our Download Page, select Windows, and click "Download Windows x64 (.exe)". Most PCs use x64; select ARM64 for Snapdragon-powered devices like Surface Pro X.

Install the Application

Double-click the .exe file. If a "Windows protected your PC" warning appears:

Click "More Info"
Click "Run anyway" to continue
Follow the setup wizard to complete installation

This is common for open-source software without expensive code signing certificates and does not indicate malware.

Launch Clash Verge Rev

After installation, launch "Clash Verge Rev" from the Start menu or desktop shortcut. The first launch will initialize the Mihomo core automatically. The left sidebar contains: Home, Proxies, Config (Profiles), Connections, Rules, Logs, and Settings.

Import Subscription Link

Click "Config" on the left sidebar:

Click the "+" or "New" button in the top right
Select "Remote Config" (URL)
Paste your subscription link from your provider
Enter an optional name and click "Save"
Wait for the client to fetch and update the node list

Select Proxy Nodes

Click "Proxies" to view available nodes:

Click the "Lightning⚡" icon on a proxy group to test latency
Select a low-latency node (green, preferably under 100ms)
We recommend selecting the "Auto Select" group for automatic best-node switching

Enable System Proxy

Click "Home" and toggle the "System Proxy" switch to ON. The switch will turn blue and a Clash icon will appear in your system tray (bottom right). Your traffic is now being routed through Clash.

Verify Connection

Open your browser and visit Google or YouTube. If they load, your setup is complete. If not, check node latency, ensure the subscription is imported, or try switching to "Global" mode.

Launch at Startup:Enable "Launch at Startup" in Settings → System to have Clash Verge Rev run automatically when Windows starts.

Auto-Update Subscriptions:Right-click your imported subscription in the Config page to set an update interval (daily recommended) to keep your node list current.

Download and Install FlClash

Go to the Download Page, find FlClash in the Windows section, download the .exe, and install. If a security warning appears, click "More info" → "Run anyway".

Add Subscription Config

Launch FlClash, navigate to "Config" → "+" → "URL Import", paste your link, and confirm. Wait for nodes to load.

Select Nodes and Enable Proxy

Switch to the "Proxies" tab, click the test button, and select a node. Click the power button at the top to start. Confirm the VPN permission request if prompted.

FlClash features a simple and intuitive logic, ideal for beginners. Its interface is identical to the Android version, allowing for a seamless transition to mobile use.

macOS Tutorial

macOS 12+ Apple Silicon · Intel x64 Recommended Client: Clash Verge Rev

Go to Download

Download Correct Version for Your Chip

Go to our Download Page and check your chip type:

M1/M2/M3/M4 (Apple Silicon): Download "Apple Silicon (.dmg)" — ARM64 for best performance
Intel Mac: Download "Intel x64 (.dmg)"
How to check: Click the Apple icon (top left) → "About This Mac". If the chip starts with "M", it is Apple Silicon.

Install the Application

Double-click the .dmg file and drag the Clash Verge Rev icon into the Applications folder. Unmount the disk image when finished. Launch the app from Launchpad or Finder.

Bypass Gatekeeper Security

If you see an "unverified developer" warning on first launch:

Go to "System Settings" → "Privacy & Security"
Find the blocked app notification and click "Open Anyway"
Confirm with your password/Touch ID and click "Open"

This is a standard macOS security feature for open-source apps and does not indicate malware.

Import Subscription Link

Navigate to "Config" → "+" → "Remote Config", paste your subscription link, and save. Wait for nodes to load.

Select Nodes and Enable System Proxy

Go to "Proxies", test latency, and select a low-latency node. Return to "Home" and toggle "System Proxy" to ON. Allow network permissions when prompted. A Clash icon will appear in your menu bar.

TUN Mode (Optional):For gaming or CLI proxying, enable "TUN Mode" for global interception. This requires system password authorization to create a virtual network interface.

Menu Bar Controls:Clash Verge Rev stays in your menu bar. Right-click the icon to quickly switch modes or toggle the proxy without opening the main window.

Download and Install ClashX Meta

Download the .zip from our Download Page. Extract and drag it to your Applications folder. Use the "Open Anyway" step in settings if needed on first launch.

Add Subscription Config

ClashX Meta lives in your menu bar. Click its icon → "Config" → "Manage Config". Click "Add", paste your link, and save.

Enable System Proxy

Click the menu bar icon → "Set as System Proxy". Navigate to "Proxy" and select your preferred server. ClashX Meta is lightweight and perfect for simple daily use.

ClashX Meta is a lightweight, menu-bar-only client. If you need advanced features like TUN Mode or script extensions, we recommend Clash Verge Rev.

Android Tutorial

Android 5.0+ Direct APK Install, No Root Required Recommended Client: FlClash

Go to Download

Download APK Package

Go to our Download Page, select Android, and click "Download ARM64 Version (Recommended for 99% of devices)". Most modern Android phones use ARM64; if installation fails, try the Universal version.

Allow Installation from Unknown Sources

After downloading, your phone may prompt for authorization when you click the file:

Click "Settings" or "Allow from this source"
Or go to "Settings" → "Security (or Privacy)" → enable "Install unknown apps"
Paths vary slightly by brand (Xiaomi, Huawei, Samsung, OPPO, etc.); follow the on-screen prompts.

Install FlClash

Return to your file manager, find the .apk file, and install it. Once complete, launch FlClash from your app drawer or home screen.

Add Subscription Config

Launch FlClash and click the "Config" tab at the bottom:

Click the "+" button in the top right
Select "URL Import"
Paste your subscription link from your provider
Enter an optional name (e.g., "My Airport") and click "Confirm"
Wait for the node list to import automatically

Select Proxy Nodes

Click the "Proxies" tab at the bottom to see available nodes. Click the "Latency Test" button and wait for the results. Select a low-latency node (green). "Auto Select" is recommended for best performance.

Start Proxy and Grant VPN Permission

Click the "Start/Connect" button (power icon) at the top:

On first use, a "Connection Request" dialog will appear → click "OK"
A VPN key icon will appear in your status bar, indicating the proxy is active
Visit Google in your browser to verify the connection

Background Activity Hint:Some manufacturers (e.g., Xiaomi, Huawei) may aggressively kill background apps. We recommend setting FlClash to "Allow background activity" or adding it to the battery optimization whitelist.

Auto-Update Subscriptions:Long-press your imported subscription on the Config page to set an auto-update frequency to keep your nodes current.

Download and Install ClashMeta for Android

Download the ARM64-v8a APK (Recommended) from our Download Page. Enable "Allow unknown sources" as described in Step 2 of the FlClash tutorial before installing.

Import Configuration File

Launch ClashMeta for Android, click "+" → "URL" in the top right. Paste your link into "Profile URL", name it, and click "CREATE". Once fetched, click the "Activate" (check) button.

Enable Proxy

Click the "START" button on the home screen and grant VPN permission. Status should change to "Running". Go to "Proxies" to test and select a low-latency node.

ClashMeta for Android is an official MetaCubeX release with full features for advanced users. If you are new to Clash, we recommend starting with FlClash for its simpler interface.

iOS Tutorial

Paid Apps on App Store Requires Global Apple ID iOS 14+

Go to Download

Special Note for iOS: Due to App Store policies, iOS proxy tools are paid apps (Stash ~$3.99, Shadowrocket ~$2.99) and require a global Apple ID (e.g., US or HK region) for purchase. They are not available on the China App Store. Please refer to our "How to Register a US Apple ID" guide below to prepare your account.

Switch App Store to Global Account

Open the App Store, click your profile icon in the top right, scroll to the bottom, and sign out. Sign in with your US or HK Apple ID. If you don't have one, follow our registration guide below.

Purchase and Download Stash

Search for "Stash" or "Stash - Rule Based Proxy" in the US App Store. Look for the blue 'S' icon. Purchase (approx. $3.99) using a valid credit card or gift card and complete the installation.

Add Subscription Config

Open Stash and click the "Config" tab at the bottom:

Click "+" → "Download from URL" in the top right
Paste your subscription link and click "OK"
Once downloaded, tap the profile to set it as active

Select Proxy Nodes

Navigate to the "Proxy" tab. Click the latency test icon and select a low-latency node (green numbers indicate better performance).

Connect Proxy and Grant VPN Permission

Go to the "Dashboard" and toggle the "Connect" switch at the top:

On first connect, a "Stash Would Like to Add VPN Configurations" prompt appears → click "Allow"
Authenticate via Face ID, Touch ID, or passcode
A VPN icon will appear in the status bar
Test your connection by visiting Google in Safari

How to Register a US Apple ID (Required for iOS Proxy Tools)

Tools like Stash and Shadowrocket aren't available on the China App Store. You need a US-region Apple ID to download them. Here are the steps:

Visit Apple ID Registration Page

Go to appleid.apple.com in your browser. Click "Create Your Apple ID" and use an email not yet registered with Apple.

Enter US Region Information

Select "United States" as the country/region. Set your age to 18+. Complete the email verification to finish registration.

Switch App Store Account

Open App Store → Profile → Sign Out → Sign in with your new US Apple ID.

Search and Purchase Apps

Search for "Stash" or "Shadowrocket". Use a US-compatible credit card or a digital iTunes gift card for payment.

Switch Back After Purchase

Once purchased, you can sign back into your original China App Store account. The app will remain installed and receive updates normally.

No-Card Tip:You can purchase "US iTunes Gift Cards" online to top up your balance without needing to bind a credit card.

Linux Tutorial

Ubuntu 20.04+, Debian 11+, Fedora 36+ amd64 · arm64

Go to Download

Download the Correct Package for Your Distro

Go to our Download Page and pick a package:

Ubuntu / Debian / Deepin: Download the .deb (amd64 or arm64)
Fedora / CentOS / RHEL: Download the .rpm (x86_64)
Run uname -m if unsure of architecture: x86_64 = amd64, aarch64 = arm64

Install the Application

Open terminal and execute the relevant command:

Terminal — Install Clash Verge Rev

# Ubuntu / Debian — install .deb package $ sudo dpkg -i clash-verge-rev-linux-amd64.deb ✔ Installation complete — launch from Applications menu # Fedora / CentOS / RHEL — install .rpm package $ sudo rpm -i clash-verge-rev-linux-x86_64.rpm # Alternatively, use dnf on Fedora $ sudo dnf install clash-verge-rev-linux-x86_64.rpm

Launch Clash Verge Rev

After installation, find Clash Verge Rev in your app grid or launch it from terminal using:

clash-verge-rev — direct launch
First launch will initialize the Mihomo core automatically.

Import, Select, and Connect

Steps are identical to the Windows version:

"Config" → "+" → Paste link → Save
Navigate to "Proxies" and test for low-latency nodes
Return to "Home" and enable "System Proxy"

(Optional) Enable TUN Mode for Global Proxy

Enabling TUN mode on Linux requires extra capability settings:

Terminal — Enable TUN mode without sudo

# Grant network capabilities so TUN works without root $ sudo setcap cap_net_admin,cap_net_bind_service=+ep $(which clash-verge-rev) ✔ Now enable TUN mode in Clash Verge Rev Settings → TUN Mode

System Proxy Note:On Linux, "System Proxy" only affects specific apps like Firefox. CLI tools like curl require manual http_proxy env variables. Use TUN mode for a true global proxy covering gaming and system updates.

Download Mihomo CLI Binary

Go to the "Mihomo Core (CLI)" section on our Download Page. Fetch mihomo-linux-amd64.gz or the package for your architecture.

Terminal — Mihomo CLI Quick Start

# Decompress and make executable $ gunzip mihomo-linux-amd64.gz $ chmod +x mihomo-linux-amd64 $ sudo mv mihomo-linux-amd64 /usr/local/bin/mihomo # Create config directory and place your config.yaml $ mkdir -p ~/.config/mihomo # Copy your Clash config.yaml into ~/.config/mihomo/ # Start Mihomo $ mihomo -d ~/.config/mihomo ✔ Mihomo started — web UI: http://127.0.0.1:9090/ui

CLI mode is ideal for servers and routers. You can download your config.yaml from your provider using curl -o config.yaml "URL". Access the web dashboard at http://127.0.0.1:9090/ui for visual node management.

Configuration Basics

Master These Three Concepts for Seamless Proxying

Answering the most common questions for Clash beginners.

What is a subscription link?

A Clash client is just a connection tool and does not provide proxy nodes directly. You need to purchase a service (airport) to get a subscription link starting with https://.

Paste this link into your client's config page. It will download available nodes automatically. Simply update the subscription to refresh your node list.

Which proxy mode should I choose?

Mode	Description
Rule (Recommended)	Smart routing: local direct, international via proxy.
Global	Routes all traffic through a proxy; used for debugging.
Direct	All traffic connects directly; bypasses the proxy.

System Proxy vs. TUN Mode

System Proxy (HTTP/SOCKS5): Simple setup for browsers and most apps. Best for daily browsing.

TUN Mode: Creates a virtual network card to intercept all TCP/UDP traffic, including games and CLI tools. True global proxying.

What is a normal node latency?

Lower latency means a faster connection. Here is a general reference:

Latency	Experience
0–100ms	Excellent: Both streaming and gaming are smooth.
100–200ms	Good: Suitable for browsing and video.
200–500ms	Fair: Latency is noticeable.
>500ms or Timeout	Unavailable: Switch nodes.

FAQ

Clash FAQ: Everything You Need to Know

Common installation, configuration, and usage issues solved here.

Why can't I access Google even with Clash enabled?

Check the following in order:

① Node Availability: Re-test latency in the 'Proxies' page and select a green node.

② System Proxy: Ensure the 'System Proxy' switch is ON in the main tab.

③ Proxy Mode: Temporarily switch to 'Global' to rule out rule-based routing issues.

④ Expired Sub: Re-import or refresh your subscription link.

⑤ Software Conflicts: Antivirus software may block Clash; try disabling it temporarily.

Windows warns about an 'unverified publisher'—is it a virus?

No, this is normal. Windows SmartScreen triggers this for software without an expensive code-signing certificate, which most open-source projects lack.

All packages on this site come directly from GitHub Official Releases. You can verify SHA256 hashes on the respective repositories. Click 'More info' → 'Run anyway' to continue.

Android APK says 'App not compatible with device'—what now?

This usually indicates an architecture mismatch:

• Try downloading the Universal version (supports all architectures).

• For devices from before 2015, use the armeabi-v7a version.

• Use an app like 'CPU-Z' to check your device's architecture.

Does the Clash client collect my data or monitor traffic?

Clients recommended here (Verge Rev, FlClash, ClashX Meta) are fully open-source. Their code is hosted on GitHub for anyone to audit. There are no backdoors or data-tracking logic.

Your traffic only flows through the nodes you configure. This site provides official, unmodified GitHub release packages.

What if subscription import says 'Download Failed' or the config is empty?

Potential causes and solutions:

• Network Issues: You may need an initial proxy connection to fetch the subscription list for the first time.

• URL Error: Ensure you copied the full URL starting with https:// with no trailing spaces.

• Expired Link: Contact your provider to confirm your subscription is still active.

• Format Mismatch: Ensure you selected the 'Clash' format from your provider, not SS or V2Ray.

How to handle macOS 'cannot be opened because the developer cannot be verified'?

This is a standard macOS Gatekeeper feature, not a malware warning:

① Go to 'System Settings' → 'Privacy & Security'.

② Locate the notice regarding Clash Verge Rev in the Security section.

③ Click 'Open Anyway'.

④ Confirm by clicking 'Open' in the popup dialog.

Alternatively, right-click the app icon and select 'Open' from the menu.

How do I set up auto-updates for subscriptions?

Clash Verge Rev: In 'Config', right-click your profile, select 'Edit', and enable 'Auto Update' with a set interval (e.g., 24h).

FlClash: Long-press the subscription in the Config tab to edit the update interval.

ClashX Meta: Menu Bar → Config → Manage Config → select frequency.

We recommend daily updates to keep your node list current.

Why can't I access websites after closing Clash?

In rare cases, the system proxy settings are not cleared if Clash exits unexpectedly.

Windows: Go to Settings → Network & Internet → Proxy, and toggle 'Use a proxy server' to OFF.

macOS: System Settings → Network → [Your Connection] → Details → Proxies, and uncheck all active proxies.

Restarting Clash Verge Rev will usually fix and clear these settings automatically upon a clean exit.

Ready to Start?

Download Clash Now and Get Connected

Direct download links for all platforms. Skip GitHub and start your 5-minute configuration today.

Go to Download Page Mihomo Repository

Clash TutorialsFull Platform Configuration Guide

How to Register a US Apple ID (Required for iOS Proxy Tools)

Visit Apple ID Registration Page

Enter US Region Information

Switch App Store Account

Search and Purchase Apps

Switch Back After Purchase

Master These Three Concepts for Seamless Proxying

What is a subscription link?

Which proxy mode should I choose?

System Proxy vs. TUN Mode

What is a normal node latency?

Clash FAQ: Everything You Need to Know

Download Clash Now and Get Connected

Clash Tutorials
Full Platform Configuration Guide