Official Tutorial · Installation & Configuration Guide

Clash Cross-Platform Tutorial

From download and install to VPN proxy internet, every step has detailed instructions
Windows · macOS · Android · iOS · Linux complete image tutorial

Windows macOS Android iOS Linux
Detailed Cross-Platform Installation Steps
Subscription Import & Update Tutorial
System Proxy & TUN Mode Detailed
One-Click Solutions for FAQs

Windows Installation & Usage Tutorial

Supports Windows 10 / 11. Recommended to use Clash Verge Rev — currently the best Clash proxy client for Windows

1
Download and Run the Installer

Go to the download center to get the Clash Verge Rev installation package. The vast majority of Windows PCs should select the x64 version; if you are using an ARM-based PC like Snapdragon X Elite or Surface Pro X, please select the ARM64 version.

Once downloaded, double-click the .exe installer to start the setup wizard. Installation is automatic and a shortcut will appear on the desktop.
2
First Launch and Permissions

After installation, double-click the desktop icon to start Clash Verge Rev. Upon first launch, Windows Security may prompt asking if you allow the proxy program to access the network. Please click "Allow Access"

If you need to use TUN Mode (global proxy for all traffic), you need to run the client as an administrator, or enable Service Install in settings. It is recommended to use the System Proxy mode first, then switch as needed once familiar.
3
Import Subscription Link

The VPN subscription link is provided by your proxy service provider, usually found on the "Subscription" or "One-Click Import" page of their control panel.

  1. Click on "Profiles"
  2. Click the top input box and paste your VPN subscription link (URL starting with https:// or http://)
  3. Click the download button () and wait for the proxy profile to finish downloading
  4. Once downloaded successfully, click the "Select" button on the right side of the profile card to make it active
Subscription files update regularly (adding new VPN nodes, removing dead proxy nodes). We recommend clicking the "Update" button every few days or when connections fail.
4
Select Proxy Node

Click the left menu "Proxies" to enter the node selection interface.

  1. You can see multiple proxy groups, typically including "Auto Select" and "Manual Select"
  2. "Auto Select" tests speed and automatically switches to the lowest latency node, recommended for beginners
  3. For manual selection, click the corresponding proxy group and select a low-latency proxy node from the list (green/yellow numbers)
  4. Click the lightning icon on the right side of the proxy group to test ping and find the fastest network node
5
Enable Proxy Mode

Clash Verge Rev offers two proxy modes, choose based on your needs:

Mode Use Case Features Recommendation
System Proxy Browser, proxy-supported apps Easy config, low permission Daily Recommendation
TUN Mode Game acceleration, CLI tools, global proxy Global takeover, requires admin rights Advanced Users

On the client homepage or top right corner switch, turn on "System Proxy" to start.

Once the proxy is enabled, open a browser and visit Google or YouTube. If it loads normally, the proxy network config is successful!
1
Download and Install FlClash

FlClash is a cross-platform client developed with Flutter, featuring a clean UI. Extremely suitable for beginners experiencing VPN proxy tools for the first time.

Download .exe and double click to install. Starts automatically after installation, no extra config needed.
2
Add Subscription Config
  1. Open FlClash, click "Profiles"
  2. Click the 「+」 button on bottom right, choose "URL"
  3. Paste the VPN subscription link, click confirm to download proxy config
  4. Once downloaded, click to select and activate
3
Enable Proxy

On the FlClash main interface, click the top right switch to enable proxy network, select a suitable node and surf. FlClash uses system proxy by default, needing no extra setup for most.

The switch turns blue indicating the proxy is enabled. Open browser to verify Google access.
1
Download and Install Clash Nyanpasu

Clash Nyanpasu is also based on Tauri with a built-in Mihomo core and powerful scripting capabilities, great for advanced proxy users.

2
Import Subscription and Select Core

Nyanpasu supports switching proxy engines, defaulting to the Mihomo core (recommended). After installation:

  1. Click 「Profiles」, paste the VPN subscription link and download
  2. Confirm in settings to use the Mihomo core
  3. Return to main interface, enable system proxy or TUN mode
Nyanpasu's script extension can process proxy subscription profiles secondarily. Suitable for advanced users needing custom network rules. Beginners can skip.

macOS Installation and Usage Tutorial

Supports Intel x64 and Apple Silicon (M1/M2/M3/M4). Please select the version based on your chip.

1
Determine Chip Type and Download DMG

Click the Apple menu in the top left corner of the screen →"About This Mac", check the "Processor" or "Chip" column:

  1. ShowsApple M1 / M2 / M3 / M4→ SelectARM64Version (Recommended)
  2. ShowsIntel Core i5 / i7 / i9→ SelectIntel x64Version
  3. Macs purchased in 2021 and later are mostly M-series, directly select ARM64
2
Install to Applications Folder
  1. Double-click the downloaded .dmg file and wait for the disk image to mount
  2. In the pop-up window, drag the Clash Verge Rev icon to the right Applications folder
  3. Wait for copying to complete, find Clash Verge Rev in Launchpad or "Applications" and click to open
3
Handle macOS Gatekeeper Prompt

Upon first launch, macOS may pop up "Cannot be opened because Apple cannot check it for malicious software".This is a normal security mechanism, not a virus.

  1. Click "System Settings" (macOS 13+) or "System Preferences" (macOS 12 and below)
  2. Go to "Privacy & Security"
  3. Scroll to the bottom to find the prompt about Clash Verge Rev being blocked, click "Open Anyway"
  4. Click "Open" again in the pop-up confirmation dialog
If the above method doesn't work for macOS 15 Sequoia users, open Terminal and execute:xattr -d com.apple.quarantine /Applications/Clash\ Verge\ Rev.app
4
Grant Network Permissions

Upon first launch, the system will pop up an authorization request for network extension or filter permissions, be sure to click "Allow", otherwise the proxy function will not work properly.

To use TUN mode, you also need to confirm the network extension is installed and enabled in "System Settings → VPN & Filters".
5
Import Subscription Link
  1. Click the left 「Profiles」 menu
  2. Paste the VPN subscription link in the top input box (copied from the proxy control panel)
  3. Click the download button, wait for proxy configuration to sync
  4. Click the profile to select and activate
6
Enable System Proxy

In the Clash Verge Rev main interface, turn on the 「System Proxy」 switch. The menu bar icon turning colorful means the proxy is activated. Open Safari or Chrome to access Google and verify.

Proxy successful! After this, Clash Verge Rev will automatically start with the system every boot (can adjust auto-start options in settings).
1
Download and Install ClashX Meta

ClashX Meta is a macOS menu bar proxy tool. After installation, it stays in the system tray, lightweight and low resource usage. Supports Universal package for both Intel and Apple Silicon.

  1. Download .zip zip file and extract
  2. Drag ClashX Meta to Applications folder
  3. Also needs to be allowed to open in "Privacy & Security" (same as above)
2
Add Subscription & Enable Proxy

ClashX Meta is operated via the menu bar icon, very easy to use:

  1. Click the menu bar ClashX Meta icon →「Config」→「Remote config」→「Manage」
  2. Click "Add", paste the VPN subscription link, set a remark name, click "OK"
  3. Select the newly added proxy profile, click "Download" to sync
  4. Menu bar icon → Check 「Set as system proxy」Enable System Proxy
1
Download and Install FlClash

FlClash offers M-series (ARM64) and Intel (AMD64) versions. Download the corresponding .dmg file based on chip.

Installation steps are the same as Clash Verge Rev: mount DMG → drag to Applications → handle Gatekeeper prompt.
2
Add Subscription and Enable Proxy

FlClash interface is clean and intuitive: Click "Profiles" → "+" → Paste VPN subscription link → Confirm Download → Select Profile → Enable Proxy switch on main interface.

Android Installation and Usage Tutorial

Direct APK installation, no app store needed, supports Android 5.0 and above

1
Select Correct Architecture and Download APK

ClashMeta for Android offers multiple architecture versions, please select based on your phone model:

Version Applicable Devices Recommendation
ARM64(arm64-v8a) Most Android phones released after 2016 Top Recommendation
Universal Use when unsure, compatible with all devices Backup Choice
ARMv7 Very old devices released before 2014 Special Cases
2
Enable "Install from Unknown Sources"

Since the APK is not from an app store, you must allow installing apps from unknown sources. Paths vary by OS version:

  1. Android 8.0 and above:When opening the APK in the file manager, the system will prompt "Allow installing unknown apps", just click "Allow"
  2. Older Android:Go to "Settings → Security", turn on the "Unknown Sources" switch
If it prompts "There was a problem parsing the package", it usually means incomplete APK download (file truncated). Check network and redownload completely.
3
Install APK
  1. Open phone file manager, find the APK in the download folder
  2. Click the APK file, the system pops up the installation dialog
  3. Click "Install" and wait for completion
  4. Click "Open" to launch ClashMeta for Android
4
Import Subscription Configuration

ClashMeta for Android supports multiple ways to import subscriptions:

  1. Open the app, click the top of the main interface 「Profiles」
  2. Click the top right 「+」, select "URL"
  3. Paste the VPN subscription link in the input box, fill in a remark, click "OK" to download
  4. Once downloaded, click the profile to select it (blue checkmark appears)
You can also scan the QR code provided by the proxy provider to quickly import, or directly copy the subscription link and open the App. The App will automatically recognize the clipboard content and prompt you to import.
5
Start VPN Proxy Service

Click the"Start"button on the main interface or the switch in the top right corner. The system will pop up a VPN connection request, click"OK"to authorize.

  1. Click 「Proxies」Select a suitable node (low latency nodes are recommended)
  2. In "Proxies", you can switch between "Rule", "Global", and "Direct" modes
  3. For daily use, it is recommended to use the"Rule" mode, where domestic traffic connects directly and overseas traffic goes through the proxy
When the VPN icon appears in the status bar, the proxy is enabled. Open the Chrome browser and visit Google to verify the connection.
1
Download and Install FlClash APK

FlClash features a Material Design style with a modern, clean, and intuitive interface, making it very suitable for beginners. Both ARM64 and ARMv7 versions are available; ARM64 is preferred.

The installation steps are the same as ClashMeta: Enable unknown sources → Click APK to install → Open the application.

2
Add Subscription and Start
  1. Open FlClash and click the "Config" tab at the bottom
  2. Click the 「+」, select the URL method, and paste the subscription link
  3. Select the configuration after the download is complete
  4. Return to the home page, click the switch in the top right corner to start the proxy, and grant VPN permissions

iOS Installation and Usage Tutorial

iOS clients must be purchased from the US App Store. The following provides a complete tutorial on registering and configuring a US Apple ID.

Important Note:Clash clients for iOS are all paid applications (one-time purchase, lifetime use) and are only available on theUS App Store. You need to register a US Apple ID first before purchasing and downloading. This tutorial provides complete free registration steps.
Stash
Most comprehensive features, fully supports Clash rule syntax, beautiful interface, top recommendation
Paid App
App Store
Shadowrocket
Commonly known as "Little Rocket", widely used, multi-protocol support, stable long-term updates
Paid App
App Store
Quantumult X
Top choice for advanced users, extremely powerful scripting features, comprehensive traffic analysis
Paid App
App Store

Complete Tutorial for Free Registration of US Apple ID

Clash-like apps for iOS are only available in the US App Store, requiring a US Apple account to purchase. The following method is completely free, takes about 10 minutes, and can be used long-term after registration.

1
Prepare a New Email

Use an email that has never been registered for an Apple ID (Gmail, Outlook, iCloud are all acceptable). It is recommended to create a dedicated new email and manage it separately from your personal main account to avoid confusion.

2
Create Apple ID on the Official Apple Website

Openappleid.apple.com→ Click "Create Your Apple ID" → Fill in the new email and password → In the "Country/Region" section,select "United States"→ Complete the email verification code verification.

3
Fill in the US Billing Address

For payment method, select"None", and for the billing address, it is recommended to use Oregon (no sales tax), for example: Portland, OR 97201. The phone number can be any valid US format number.

4
Switch to the US Account on iPhone

OpenApp Store→ Click the avatar in the top right corner → Scroll to the bottom and click"Sign Out"→ Log in with the newly registered US Apple ID to search and purchase apps like Stash or Shadowrocket.

Note: You only need to switch the US account inApp Store, no needto sign out of your main account in "Settings → Apple ID", and your iCloud, photos, and other data will not be affected.
1
Purchase and Download Stash

Ensure you have switched to the US Apple ID to log in to the App Store, search for "Stash", or click the link below to jump to the app page to purchase. Stash is a one-time payment for lifetime use.

Go to the US App Store to Purchase Stash
2
Add Subscription Profile

Stash supports direct import of Clash format subscriptions and is fully compatible with Clash subscriptions on other platforms.

  1. Open Stash, click at the bottom"Profiles" Tab
  2. Click the top right 「+」→ Select "Remote Configuration URL"
  3. Paste the proxy subscription link, fill in the alias, and click "Save"
  4. Click "Sync" to download the latest configuration. A checkmark will appear in front of the configuration file upon completion.
You can also copy the subscription link and open Stash; the App will automatically recognize the subscription link in the clipboard and prompt you to import it.
3
Select a Node and Enable the Proxy
  1. Click the"Proxy"tab at the bottom to view the proxy group list
  2. Select the node with the lowest latency in the "Auto Select" group, or manually switch in the proxy group
  3. Return to the "Home" tab and turn on the proxy switch in the top right corner
  4. When the iOS VPN configuration addition request pops up, click "Allow"
When the VPN icon appears in the status bar, it indicates that the proxy is successfully enabled. Open Safari and visit Google to verify the connection.
1
Purchase and Install Shadowrocket

Shadowrocket is the most well-known proxy tool on the iOS platform, with a large Chinese user base and abundant tutorial resources online.

Go to the US App Store to Purchase Shadowrocket
2
Import Subscription Link
  1. Open Shadowrocket, click the top right corner「+」
  2. Select Type"Subscribe"
  3. Paste the proxy subscription link in the URL input box and click Done
  4. Return to the main interface and confirm that the nodes under the subscription have loaded
3
Enable Proxy Connection

Select a node on the main interface, turn on the main switch at the top ("Not Connected" changes to "Connected"), and grant VPN permissions to start using.

Shadowrocket's "Global Routing" can be set to "Config" (using rule-based routing), which is recommended to prevent domestic traffic from going through the proxy.

Linux Installation and Usage Tutorial

Supports Debian/Ubuntu (.deb), Fedora/CentOS (.rpm) desktop versions, as well as the Mihomo command-line core (for servers/advanced users)

1
Download the Installation Package for Your Distribution

Select the package format according to your Linux distribution:

Format Applicable Distribution
.deb x86_64 Debian / Ubuntu / Linux Mint / Pop!_OS (64-bit)
.rpm x86_64 Fedora / CentOS / RHEL / openSUSE
.deb ARM64 Raspberry Pi / ARM architecture Debian-based
2
Install the Package

Open the terminal, enter the download directory, and execute the following command to complete the installation:

Install Clash Verge Rev
# Debian / Ubuntu (.deb)
$ sudo dpkg -i clash-verge-rev-linux-amd64.deb
 
# Fedora / CentOS (.rpm)
$ sudo rpm -i clash-verge-rev-linux-x86_64.rpm
 
# If dpkg reports dependency errors, run:
$ sudo apt-get install -f
3
Start and Import Subscription

After installation is complete, find Clash Verge Rev in the application menu and start it, or start it via terminal command:

Launch application
$ clash-verge-rev

After starting, the operation is exactly the same as the Windows/macOS versions: Click "Profiles" → Paste the subscription link → Download the configuration → Select to activate → Turn on "System Proxy".

4
Set to Start at Boot (Optional)

In the "Settings" of Clash Verge Rev, turn on the"Launch at Login"option to allow the client to run automatically when the system boots.

GNOME desktop users can also manually add Clash Verge Rev as a startup item via "Startup Applications".
1
Download Mihomo Core

Mihomo (formerly Clash.Meta) is the high-performance core engine of Clash, suitable for server deployment or advanced users without a desktop environment. It provides.gzbinary packages and.debservice packages.

Ordinary desktop usersdo not need to separately download the Mihomo core, as it is already built into graphical clients like Clash Verge Rev. This option is primarily for server/command-line scenarios.
2
Install and Configure systemd Service
Install & Start Mihomo as systemd service
# Install .deb package
$ sudo dpkg -i mihomo-linux-amd64.deb
 
# Place your config.yaml in the default config directory
$ sudo mkdir -p /etc/mihomo
$ sudo cp config.yaml /etc/mihomo/config.yaml
 
# Enable and start the service
$ sudo systemctl enable mihomo --now
 
# Check running status
$ sudo systemctl status mihomo
● mihomo.service - Mihomo Daemon
   Active: active (running) since ...
3
Configure config.yaml

Mihomo manages proxy rules and nodes through a YAML configuration file. The basic configuration structure is as follows:

config.yaml (minimal example)
port: 7890
socks-port: 7891
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090
 
# Paste your proxies and rules from the airport config below
proxies:
  - ...
rules:
  - MATCH,PROXY
Most proxy providers directly provide Clash formatconfig.yamlfiles or subscription links. After downloading, place them in the/etc/mihomo/directory to use directly without manual configuration.

Mihomo also supports visual management via Web Dashboard. After setting it up inconfig.yaml,external-controlleryou can access it via a browser athttp://127.0.0.1:9090/uito switch nodes and monitor traffic.

4
Configure System Proxy (Optional)

By default, Mihomo listens to a local port after startup. You can direct system traffic to Mihomo via environment variables:

Set proxy environment variables
$ export http_proxy=http://127.0.0.1:7890
$ export https_proxy=http://127.0.0.1:7890
$ export all_proxy=socks5://127.0.0.1:7891
 
# Test connectivity
$ curl -I https://www.google.com
HTTP/2 200
1
Download and Install FlClash

FlClash is a Linux proxy client with a simple graphical interface, suitable for desktop Linux users unfamiliar with the command line.

Install FlClash
$ sudo dpkg -i flclash-linux-amd64.deb
2
Add Subscription and Enable Proxy

Start FlClash in the application menu. The operation is exactly the same as the Windows version: "Config" → "+" → Paste the subscription link → Download → Select → Turn on the proxy switch on the main interface.

Tutorial & FAQ

Comprehensive coverage of installation, configuration, and connection troubleshooting

What is a subscription link? Where can I get a subscription link?

A Subscription URL is a URL containing server node information provided by the proxy/VPN service provider you purchased from. After logging into the provider's control panel, you can usually find it on the "Subscription", "One-Click Import", or "Client Configuration" page. Copy and paste the link into the client's subscription input box to automatically download node configurations.

After the proxy is enabled, the browser can bypass the firewall, but other applications (like games, Telegram) cannot connect. How to fix this?

This is a limitation of the "System Proxy" mode—it can only take over applications that support HTTP/HTTPS proxies (mainly browsers). To make all traffic from game clients, Telegram, command-line tools, etc., go through the proxy, you need to enableTUN Mode. Find "Tun Mode" in the "Settings" of Clash Verge Rev and enable it. Enabling it requires administrator privileges, and all OS-level traffic will be handled by the Clash proxy.

The proxy is enabled, but accessing Google fails or the network speed is very slow. How to troubleshoot?

Follow these steps to troubleshoot: ① Click speed test (lightning icon) on the client's "Proxies" interface and switch to a node with latency below 300ms; ② If all nodes have high latency or show "Timeout", try updating the subscription (the configuration may be expired); ③ Check if the proxy mode is correct, "Rule" mode is recommended; ④ Try switching to other proxy groups (such as backup groups, Premium lines, etc.); ⑤ If the problem persists, contact your proxy provider to confirm the account status and node availability.

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

Rule Mode: Decides which traffic goes through the proxy and which connects directly based on the rules in the configuration file. Domestic websites connect directly, and overseas websites go through the proxy.Recommended for daily use, as it allows access to Google while maintaining normal speeds for domestic websites.Global Mode: All traffic goes through the proxy, suitable for scenarios where all traffic needs to go abroad (such as overseas games), which may slow down domestic websites.Direct Mode: All traffic does not pass through the proxy, equivalent to turning off the proxy function. It can be used to temporarily test network speed.

What to do if nodes don't change after updating the subscription in Clash Verge Rev / FlClash?

Possible reasons: ① The subscription link has expired or the provider has stopped service; ② The network itself cannot access the subscription URL (you need an active network to update the subscription. You can turn off the proxy, directly access the provider's official website, download the configuration file, and manually import it); ③ Client cache issues. Try deleting the current subscription in "Profiles", then re-add the URL and download.

How to resolve the "App not installed" prompt when installing an APK on Android?

Common causes and solutions: ①Signature conflict: An app with the same name from a different signature source may already be installed on the phone. You need to uninstall the old version before installing the new one; ②Insufficient storage space: Clean up phone storage and try again; ③Corrupted APK file: Re-download the complete APK file; ④Android version too low: ClashMeta for Android requires Android 5.0 and above. Please check your system version.

Will Stash / Shadowrocket on iOS become unusable when the subscription expires?

No. Both Stash and Shadowrocket areone-time paid apps for lifetime use, and there is no app subscription expiration issue. Note that "subscription" has two meanings here: ① Purchasing the client itself is a one-time payment; ② The "subscription link" added within the client is the subscription of your proxy provider. This part will expire along with your proxy account and needs to be renewed or replaced with a new subscription link, which has nothing to do with the client app itself.

Firefox still cannot connect to the internet after turning on the system proxy in Clash Verge Rev on Linux?

Linux's system proxy setting mechanism differs from Windows/macOS. Some applications (especially Firefox) may not follow the GNOME/KDE global proxy settings. Solutions: ① Manually set the HTTP proxy to127.0.0.1:7890in Firefox's network settings; ② Or turn on Clash Verge Rev's TUN mode (requires installing network drivers) to achieve a true global proxy; ③ Alternatively, set the environment variablesexport http_proxy=http://127.0.0.1:7890in the terminal before starting Firefox.

Haven't downloaded the client yet?

Installation packages are directly hosted on this site, with high-speed download. Fully covers Windows / macOS / Android / iOS / Linux five major platforms.