Documentation

Universal Usage Guide

Detailed visual setup guides for Windows, macOS, Android, iOS, and Linux to help you get started with Clash proxy clients.

Windows macOS Android iOS Linux
Windows macOS Android iOS Linux

Windows Setup Guide

Supports Windows 10 / 11 64-bit systems. Modern Clash Verge Rev is recommended.

Clash Verge Rev Installation Guide

Based on the Mihomo kernel with a beautiful UI and powerful features—it's the top choice for Windows currently.

01

Download the Installer

Get the .exe installer from our download page, run it, and follow the prompts. Launch Clash Verge Rev from your desktop or start menu.

Usually, choose the x64 version. If your device is ARM-based (e.g., Surface Pro X), select the ARM64 version.
Go to Windows Download Section
02

Obtain and Import Subscription Link

A subscription link contains your node info. Copy the Clash subscription URL from your airport (service provider) dashboard.

  1. Click on the Subscription menu on the left
  2. Paste your Subscription URL in the top input box
  3. Click the Import button on the right
  4. Once the download completes, left-click the subscription card to activate it (turns blue)
No subscription link? You must purchase nodes from a third-party airport. This site only provides software and tutorials.
03

Select Node and Enable Proxy

After importing, you can switch nodes and enable traffic takeover in the "Proxies" page.

  1. Click on the Proxies menu on the left
  2. Expand a policy group (e.g., Proxy) and select a low-latency node
  3. Click on the Settings menu on the left
  4. Toggle the System Proxy switch to ON
Test Tip: Click the "Lightning" icon in the top-right of the Proxies page to batch test latency. Priority should be given to nodes with green latency values.
04

Set to Start on Boot (Optional)

Turn on the "Start on Boot" switch in Settings to ensure the proxy runs automatically every time you restart your computer.

Mode Comparison: System Proxy vs TUN Mode

System Proxy (Default)
  • Only takes over traffic for browsers and apps that support system proxy settings
  • Simple setup, no special permissions required
  • Extremely low resource usage
  • Does not support games or some CLI tools
Recommended for daily web browsing
TUN Mode (Advanced)
  • Uses a virtual network card to take over all system traffic
  • Supports gaming, software updates, and downloads
  • Solves connectivity issues for apps that ignore proxy settings
  • Requires admin permissions; slightly higher battery usage
Recommended for gaming or global proxy needs

macOS Setup Guide

Supports Apple Silicon (M1/M2/M3/M4) and Intel chips, perfectly integrated with the native system experience.

Clash Verge Rev macOS Guide

Supporting various proxy protocols and providing a full GUI, it's the most recommended choice for Mac users.

Important Note: First launch might show "App is damaged" or "Cannot open." Go to System Settings → Privacy & Security and click "Open Anyway," or run this in Terminal: sudo xattr -rd com.apple.quarantine /Applications/Clash\ Verge.app
01

Download and Installation

Choose the correct version based on your Mac chip:

  1. Apple Silicon: M1 / M2 / M3 / M4 chips (arm64)
  2. Intel: Older Mac models from 2020 and earlier (x64)
  3. Download the .dmg file, double-click to open, and drag Clash Verge into the Applications folder.
You can check your chip model by clicking the Apple menu in the top-left → "About This Mac."
Go to macOS Download Section
02

Configure Subscription & Nodes

The steps are identical to the Windows version:

  1. Go to Subscription, paste your link, and click Import
  2. Go to Proxies and select a low-latency node
  3. Go to Settings and toggle the System Proxy switch to ON
03

Grant Permissions

When enabling System Proxy or installing the TUN mode virtual network card, macOS will prompt for your login password. Enter it to allow the app to modify network settings.

Menu Bar Operations: Clash Verge has a small icon in the top menu bar for quickly switching nodes and toggling the proxy without opening the main window.

Android Setup Guide

Supports Android phones, tablets, and TV boxes with easy installation and stable connection.

ClashMeta for Android Guide

The most feature-complete Android client, supporting all mainstream proxy protocols.

Note: If your phone warns about "security risks" when installing the APK, select "I understand the risk and want to continue." We recommend starting with the Universal version.
01

Install APK

Download the APK file. Tap the installer in your phone's file manager:

  1. If prompted, go to Settings to allow installation from unknown sources
  2. Once installed, open "ClashMeta"
  3. Grant necessary network permissions to the app
  4. Allow storage permissions if requested on the first launch
Go to Android Download Section
02

Add Configuration File

Your subscription link is the key to connecting—typically provided by your airport.

  1. Tap the Config card
  2. Tap the + in the top-right and select Import from URL
  3. Paste your subscription link and give it any name
  4. Tap Save, wait for the config to download, then tap to select it
03

Enable with One Tap

Return to the main screen and tap the large Stopped / Running button in the center.

VPN Permission: The system will show a VPN connection request. You must tap OK to allow traffic takeover.
04

Advanced Operations

While running, tap the Proxies tab to enter the node selection page:

Switch Nodes Expand a policy group and tap a node to switch instantly
Latency Test Tap the floating action button in the bottom-right to test connections
Auto Mode Select groups labeled "Auto Select" or "url-test" for automatic optimization

iOS Setup Guide

Due to system restrictions, iOS requires a non-mainland Apple ID to download these apps from the App Store.

Prerequisite: US Region Apple ID

Since proxy apps are unavailable in the China App Store, you must use a US (or other overseas) Apple ID. See the registration guide below for details.

Shadowrocket Guide

The most famous and widely used proxy tool on iOS—very easy to learn.

Step 1: Prepare a US Apple ID
1

Switch Accounts

Open the App Store, tap your profile icon, scroll to the bottom, and tap Sign Out. Then, sign in with your US account.

2

Search and Download

Once signed in, the Store will switch to the US region. Search for Shadowrocket (verify the developer to avoid clones).

3

About Fees

Shadowrocket is a paid app ($2.99). If your account has no balance, you can top it up using a "US Apple Gift Card."

You can also rent an account from trusted platforms that already have the software purchased.
02

Download the App

Tap the link below to go directly to the App Store:

Go to App Store
03

One-Click Subscription

Most airports offer a one-click import for Shadowrocket. If not, tap the + in the app, set Type to Subscribe, and paste the URL.

Scan QR Code: Open your subscription QR code on another screen and use the scan feature in Shadowrocket for a quick setup.
04

Enable Proxy

Select a node from the list and toggle the switch at the top right. Tap Allow in the VPN permission request and enter your passcode.

Linux Setup Guide

Includes GUI clients for mainstream distros and CLI kernels for developers.

Clash Verge Rev Linux Guide

Provides a familiar GUI with support for amd64 and arm64 architectures—the top choice for Linux desktop users.

01

Download Installer

Choose the correct format for your Linux distribution:

Ubuntu / Debian / Deepin: Use .deb format
Mihomo Core Use .rpm format
Go to Linux Download Section
02

Install via Terminal

Terminal
# Ubuntu / Debian — install DEB package $ sudo dpkg -i clash-verge-rev-linux-amd64.deb # Fedora / CentOS / openSUSE — install RPM package $ sudo rpm -i clash-verge-rev-linux-x86_64.rpm # Launch the application $ clash-verge-rev
03

Import Subscription

After launching, the process is identical to Windows: go to Subscription, paste the URL to download, and activate the config card.

04

Grant Permissions

Enabling TUN mode on Linux requires root permissions. A system authentication dialog will appear; enter your login password when prompted.

Client Guide

Client Comparison across Platforms

Choose the most suitable Clash client based on your OS and requirements

Platform Recommended Client Minimalist Choice Other Options Setup Tutorial
Windows Clash Verge Rev FlClash Clash Nyanpasu View Guide
macOS Clash Verge Rev FlClash ClashX Meta View Guide
Android ClashMeta FlClash — View Guide
iOS Stash Shadowrocket Quantumult X View Guide
Linux Clash Verge Rev FlClash Mihomo Core View Guide
FAQ

Common FAQs

Answering the most frequent installation and connection questions from new users

Can't connect after installation?

1. Check if the subscription link was imported and updated successfully. 2. Verify you've selected an active node (latency test doesn't time out). 3. Ensure System Proxy is toggled ON. 4. Some antivirus or firewalls may block traffic; try disabling them temporarily.

Windows users who still can't browse should try installing and enabling TUN Mode in Settings.

How to update subscription nodes?

Usually, right-click the card in the "Subscription" page and select "Update" or "Refresh" to get the latest nodes. We recommend setting a 24-hour auto-update interval.

Why can't I find Shadowrocket in iOS Store?

It's exclusive to overseas App Stores. Mainland China IDs cannot find it. You must sign in with a US, Japanese, or other overseas Apple ID.

Note: Shadowrocket is a paid app; ensure your account has a balance or the app has been purchased previously.

Difference between Clash Verge Rev and original Clash Verge?

The original project is no longer maintained. The Rev (Revised) version is the community-maintained branch, continuing core updates, bug fixes, and UI improvements—making it the mainstream choice now.

Can I share my subscription link with friends?

Not recommended. Subscription links contain your account credentials. Sharing them allows others to use your data and may lead to account suspension due to multiple concurrent IP logins.

Should I keep TUN mode on all the time?

TUN mode is a more thorough traffic takeover method. If apps like Spotify desktop, certain games, or VS Code plugins fail to connect under System Proxy, you should use TUN mode.

For regular daily browsing, the default "System Proxy" is sufficient.

How to switch UI language?

Modern clients like Clash Verge Rev and FlClash automatically follow your system language. To change it manually, go to Settings → Language and select English.

Why do all nodes show 'Timeout'?

1. Your airport service may have expired or data is exhausted. 2. The server might be blocked; update your subscription for new nodes. 3. System time is inaccurate (a discrepancy over 60 seconds will cause connection failure); please sync your clock.

How to test: run curl -I https://www.google.com in Terminal to check for errors.

Next Step

Finished the tutorial? Download and start now

We host cross-platform installers locally for fast downloads. No GitHub access needed. Set everything up in 5 minutes.

Go to Download Page View Advanced Configuration Guide