All-Platform Tutorials · 5-Minute Quick Start · Covers Common Issues

Clash Installation Tutorials
Step-by-step guide for 5 platforms.

Installation tutorials for Windows, macOS, Android, iOS, and Linux. From downloading clients to importing subscription links, each step is explained in detail without technical background.

Windows macOS Android iOS Linux

Windows Installation Tutorial

For Windows 10 / 11 (x64 / ARM64), using Clash Verge Rev as an example

⚡

Clash Verge Rev

★ Featured

Based on Mihomo core, beautiful UI, and complete features. Best choice for Windows users.

1

Download Installation Package

Go to the Download Page · Windows tab. Select based on CPU: Most PCs select x64, laptops with Snapdragon chips select ARM64. Filename: clash-verge-rev-win-x64.exe.

💡 Unsure about architecture? Open "Settings → System → About", check "System type". Select x64 for x64 processors, and ARM64 for ARM processors.
2

Run Installer

Double-click the downloaded .exe file. Click "Yes" on the "User Account Control" dialog. A shortcut will appear on the desktop after installation.

⚠ If Windows Defender SmartScreen shows "unrecognized app", click "More info" → "Run anyway". This is common for unsigned open-source software and is not a virus.
3

First Launch & WebView2

Launch Clash Verge Rev. Windows 11 users can open it directly. Windows 10 users might need to install Microsoft Edge WebView2 runtime. Follow prompts to install (approx. 100 MB).

4

Import Subscription Link

The core step. You need a Subscription URL provided by your proxy provider.

  1. ① Open Clash Verge Rev, click Profiles on the left menu.
  2. ② Click the input box at the top right and paste the subscription URL.
  3. ③ Click Download and wait for node list synchronization.
  4. ④ Click the profile to set it as active (card will be highlighted).
ℹ Don't have a subscription link? You need to purchase proxy services from a provider that supports Clash / Mihomo format. Clash is a tool and does not include node resources.
5

Enable Proxy

Click Home on the left, find "System Proxy" switch and turn it on. Browser and most apps will now go through proxy.

Select Proxy Mode:

  • Rule Mode —— Recommended. Domestic traffic connects directly, overseas traffic goes through proxy, balancing speed and stability.
  • Global Mode —— All traffic goes through proxy, used for special debugging scenarios.
  • Direct Mode —— Proxy disabled, all traffic connects directly.
6

(Optional) Enable TUN Mode

If you need games, command-line tools, or apps that don't support proxy to use the connection, enable TUN mode:

  1. ① Restart Clash Verge Rev with Administrator privileges (Right-click taskbar icon → Run as administrator).
  2. ② Go to Settings → TUN Mode and turn it on.
  3. ③ Once activated, all system traffic is taken over; no need to enable system proxy separately.
7

Verify Connection

Visit google.com or youtube.com in your browser. If they open, proxy is working. If not, choose a lower latency node in the Proxies tab.

Other Windows Clients
🦋
FlClash Recommended for Beginners

Cross-platform client, simple UI, easiest for beginners.
🐱
Clash Nyanpasu

Supports multi-core switching with rich theme customization.

macOS Installation Tutorial

Supports Apple Silicon (M-series) and Intel Mac, using Clash Verge Rev as an example

💻
Confirm Mac chip type first:Click Apple icon top-left → About This Mac. If "Chip" shows Apple M1 / M2 / M3 / M4, download ARM64 version; if "Processor" shows Intel, download x64 version.
⚡

Clash Verge Rev

★ Featured

Preferred macOS Clash client, native Apple Silicon support, great performance, one-click switching in menu bar.

1

Download DMG Package

Go to the Download Page · macOS tab. Select: M-series Mac choose ARM64 (Apple Silicon), Intel Mac choose x64.

2

Install App

Open the .dmg file, drag Clash Verge Rev icon to "Applications" folder.

3

Bypass Gatekeeper Security Prompt

macOS might show "unverified developer" on first launch. This is normal for open-source apps. Solution:

  1. ① Open System Settings → Privacy & Security.
  2. ② Look for "'Clash Verge Rev' was blocked from use because it is not from an identified developer".
  3. ③ Click "Open Anyway" and confirm.
💡 Alternatively, right-click app in Finder → Select "Open" → Click "Open" in dialog. This only needs to be done once.
4

Import Subscription Link

Same as Windows version:

  1. ① Click Profiles on left menu.
  2. ② Paste subscription URL at the top, click Download.
  3. ③ Click profile to activate (card highlighted).
5

Enable System Proxy

Enable "System Proxy" in main UI or menu bar icon. Select Rule Mode for smart routing.

6

(Optional) TUN Mode

Enable TUN mode for full traffic proxying:

  1. ① Go to Settings → TUN Mode and turn it on.
  2. ② macOS will prompt "New System Extension", click "Allow" in Privacy & Security.
  3. ③ Enter administrator password to confirm and restart.
Other macOS Clients
🦋
FlClash Recommended for Beginners

Cross-platform, easy to use, great for first-time users.
🌐
ClashX Meta

Lightweight menu bar client, saves resources.

Android Installation Tutorial

Supports Android 5.0+, no Google Play required. Example using FlClash.

🦋

FlClash

★ Featured

Preferred Android Clash client, Material You design, smooth operation, one-click subscription import.

1

Download APK

Go to Download Page · Android tab and select version:

  • ARM64 (Recommended) —— Most Android phones since 2016 (Snapdragon, Dimensity, Kirin, Exynos, etc.).
  • ARMv7 —— Older phones before 2015.
💡 Unsure? Check CPU model in "Settings → About phone". Almost all modern phones (since 2016) are ARM64.
2

Allow Installation from Unknown Sources

Android needs manual authorization for first-time non-Play Store APK installs:

  • Click the downloaded APK, system warns "For security, your phone is set to block installation of apps from unknown sources".
  • Click "Settings" → Enable "Allow from this source".
  • Return and click "Install".
⚠ Paths vary by brand (Xiaomi, Huawei, OPPO, etc.), usually found in "Security" or "Privacy" settings. Search "Unknown sources" to find it.
3

Installation Complete

Open FlClash from app drawer. Initial setup guide will appear on first launch.

4

Add Subscription Link

  1. ① Click Profiles in bottom nav.
  2. ② Click "+" icon top-right → Select "Import from URL".
  3. ③ Paste subscription URL and click "Save & Update".
  4. ④ Click the profile to set as Current.
5

Start VPN Connection

Go to Home, click the central "Start" button.

Click "OK" on the "Connection request" dialog. VPN icon in status bar indicates success.

6

Choose Nodes & Test

Go to Proxies tab to see nodes. Long-press to test latency, pick a low-latency one. Choose "Rule Mode" for smart routing.

Other Android Clients
🤖
ClashMeta for Android

Official MetaCubeX client, feature-rich for advanced users.

iOS Installation Tutorial

iOS apps are paid apps in App Store, requires US Apple ID to purchase and download.

⚠️

Important for iOS Users

Due to regional restrictions, main apps (Stash, Shadowrocket, Quantumult X) are only in US App Store. You need to register and log in to a US Apple ID first.

Step 1: Register US Apple ID

No US phone number required, just an email. 5 minutes to register for free.

1

Open Apple ID Registration

Visit appleid.apple.com, click "Create Your Apple ID", select United States for region.

2

Fill Basic Info

Use an unregistered email and your local phone number (+86) for verification.

3

Verify Email & Phone

Verify with codes received via email and SMS to complete registration.

4

Log in on iPhone

Open App Store → Click profile icon → "Sign Out" at bottom → Log in with new US Apple ID.

5

Purchase & Install

Search Stash or Shadowrocket in US App Store. Use credit card or US Gift Card to pay.

💡 Pro Tip: US ID is only needed in App Store. You can switch back to your main ID after download.

Step 2: Configure Stash

🗂️

Stash

★ Featured

Best iOS Clash experience with beautiful native UI.

Supports Widgets and Shortcuts, deep iOS integration. Paid approx. $3.99.

Widget Support Shortcuts Native UI
Get on App Store
🚀

Shadowrocket

Best value, classic iOS proxy app.

Supports multiple protocols, flexible rules, large community. Paid approx. $2.99.

SS / VMess Trojan / VLESS Rule Subscriptions
Get on App Store
⚛️

Quantumult X

For advanced users, powerful script engine.

Powerful JS script engine and packet capture, highly customizable. Paid approx. $7.99.

JS Scripting Packet Capture Highly Customizable
Get on App Store

Stash Subscription Setup

1

Open Stash, Manage Subscriptions

Go to Config → "+" icon → "Import from URL".

2

Paste Subscription Link

Paste URL and click "Download". Click profile to set as current.

3

Start VPN Connection

Click "Start" on home page. Allow VPN configuration and enter device password.

4

Choose Nodes & Mode

Check nodes in Proxies. Choose Rule Mode for smart routing.

Linux Installation Tutorial

GUI and CLI options for Ubuntu / Debian / Fedora and routers.

GUI Client · Clash Verge Rev

⚡

Clash Verge Rev

★ Preferred GUI

Best Linux GUI choice, provides .deb and .rpm packages.

1

Download Package

Go to Download Page · Linux tab:

  • Ubuntu / Debian: Choose amd64.deb or arm64.deb.
  • Fedora / CentOS: Choose x86_64.rpm.
2

Install Package

Terminal
# Ubuntu / Debian $ sudo dpkg -i clash-verge-rev-linux-amd64.deb # Fedora / CentOS $ sudo rpm -i clash-verge-rev-linux-x86_64.rpm # Arch Linux (AUR) $ yay -S clash-verge-rev-bin
3

Launch & Import

Launch via clash-verge-rev. Follow the same steps as Windows.

4

(Optional) TUN Mode

Requires CAP_NET_ADMIN permissions:

Terminal
# Grant TUN permission to Clash Verge Rev binary $ sudo setcap cap_net_admin=ep /usr/bin/clash-verge-rev
CLI Version · Mihomo Core
🔧

Mihomo Core (CLI)

Ideal for servers, routers, and debugging. Supports RESTful API and Web Dashboards.

1

Download Mihomo Binary

Pick correct architecture package from download page.

2

Decompress & Grant Permissions

See terminal examples on the right.

3

Prepare Config

Place config.yaml in ~/.config/mihomo/.

4

Start & Access Dashboard

API listens on 127.0.0.1:9090. Manage via metacubexd.pages.dev.

Quick Install for Debian / Ubuntu

Terminal
# Decompress and install mihomo binary $ gunzip mihomo-linux-amd64.gz $ chmod +x mihomo-linux-amd64 $ sudo mv mihomo-linux-amd64 /usr/local/bin/mihomo # Verify installation $ mihomo -v # Create config directory $ mkdir -p ~/.config/mihomo # Run with config directory $ mihomo -d ~/.config/mihomo # Or install via .deb package directly $ sudo dpkg -i mihomo-linux-amd64.deb

RESTful API defaults to 127.0.0.1:9090, access via Yacd or Metacubexd

Other Linux GUI Clients
🦋
FlClash Recommended for Beginners

Cross-platform, simple Linux UI.
Must Know

3 Core Concepts

Understand these and solve 90% of Clash issues.

Subscription Link

What is a Subscription Link?

A URL from your provider that Clash uses to download node configurations. Update it to get the latest nodes automatically.

Example format: https://example.com/sub?token=xxx

Proxy Modes

Rule / Global / Direct

  • Rule Mode (Recommended)

    Intelligent routing: Direct for domestic, Proxy for overseas. Best for daily use.

  • Global Mode

    Force all traffic through proxy. Used for specific debugging.

  • Direct Mode

    Disable proxy, all traffic goes direct. Equivalent to pausing Clash.

Proxy Methods

System Proxy vs TUN Mode

  • System Proxy (Daily Use)

    Registers proxy in OS settings. Simple, doesn't need admin rights.

  • TUN Mode (Full Takeover)

    Creates virtual NIC to force all traffic through proxy, including games. Needs admin rights.

FAQ

Having Issues?

Common questions for beginners to find solutions fast.

Please check the following items:

  • ① Is "System Proxy" enabled? You must turn it on manually in the main interface.
  • ② Are nodes available? Test latency and pick a node below 200ms.
  • ③ Current mode? Ensure you are not in "Direct" mode.
  • ④ Is subscription up to date? Nodes might expire; click "Update" to refresh.

System proxy only works for apps that support proxy protocols. For games, enable TUN Mode.

Run client with Administrator/Root privileges and enable "TUN Mode" in settings.

In "Profiles", find your subscription and click "Update" or "Refresh". Weekly updates are recommended.

Enable "Auto Update" in settings to sync nodes in the background.

  • Change node: Pick one with lower latency in "Proxies" tab.
  • Proximity: Pick geographically closer nodes (HK, Japan, Singapore).
  • Change provider: Node quality depends on your airport's service.
  • Peak hours: 8-11 PM is peak time; slower speeds are normal.

Enable "Launch on Login" in settings for Windows/macOS/Linux.

Enable "Auto-start" and "Auto-connect" for Android.

iOS: Enable "On Demand" to trigger VPN automatically.

  • Clash (Original): Open-source core by Dreamacro, discontinued in 2023.
  • Clash Meta: Enhanced fork adding Hysteria2, TUIC, WireGuard, etc.
  • Mihomo: New name for Clash Meta, maintained by MetaCubeX.

No need to distinguish: All recommended clients have Mihomo core built-in. Just use the GUI clients.

macOS Gatekeeper security mechanism. Run this in terminal to remove quarantine attribute:

Terminal
# Remove quarantine attribute from the app $ sudo xattr -r -d com.apple.quarantine /Applications/ClashVergeRev.app

Replace ClashVergeRev.app with actual filename and try opening again.

Haven't Downloaded Yet?

Packages are hosted locally for high-speed direct downloads.

Download Clients GitHub Repo