Clash Config Guide· Multi-platform Visual Guide

Covering Windows, macOS, Android, and iOS from client installation to successful proxy connection. Each step is illustrated, allowing beginners to complete the setup in 5 minutes.

Setup in 5 Minutes Visual Tutorials One-click Import Intelligent Rules

Windows Config Guide

RecommendedClash Verge Rev· Works for Windows 10 / 11

Download Client
Clash Verge Rev Primary Client

A new generation cross-platform Clash client continuously maintained by the community. Based on Mihomo core, it features a modern and simple interface, supports one-click subscription import, visual rule editing, and TUN global transparent proxy. Currently the most active and stable GUI choice for Windows.

One-click Import Visual Rule Editor TUN Transparent Proxy Mihomo Core
1

Download and Install Clash Verge Rev

Visit this siteDownload, and choose the installation package based on your CPU architecture:

  • x64 Version (Recommended): For most Intel / AMD processor Windows PCs
  • ARM64 Version: For devices with Qualcomm Snapdragon processors like Surface Pro X
Not sure? Right-click 'This PC' → 'Properties' → 'System type'. If it says 'x64-based', download the x64 version.

After downloading, double-click the.exeinstaller and follow the prompts. Windows 11 might show a SmartScreen warning; click 'More info' → 'Run anyway' to continue.

2

First Start · Import Subscription Link

Start Clash Verge Rev after installation, click 'Profiles' in the left menu, then:

  1. Click the top 'New' or 'Import' button
  2. Paste your airport Subscription URL
  3. Click 'Confirm', and wait for node data to sync
  4. Once synced, the profile will appear in the list. Double-click to set it as current.
Sample Subscription Format 
https://your-airport.com/api/v1/client/subscribe?token=YOUR_TOKEN
Subscription links are provided by your airport service provider, usually found in the 'Subscription' or 'One-click Import' section of their dashboard.
3

Select Node · Latency Test

Switch to the 'Proxies' page from the left menu:

  1. You will see node groups like '🚀 Manual Selection' or '♻️ Auto Select'
  2. Click the '⚡ Test Latency' button in the top right to test response times
  3. Choosing 'Auto Select' allows Clash to automatically switch to the lowest latency node
Under 100ms is excellent, 100–200ms is usable, over 300ms or 'Timeout' means you should switch nodes.
4

Enable Proxy · Finalize Setup

Return to 'Settings' or use the top control bar:

  1. Switch Mode to 'Rule' — Direct for domestic, proxy for overseas
  2. Enable 'System Proxy' — Browser and apps will use the proxy
  3. (Optional) For games or terminal tools, enable 'TUN Mode」
System Proxy

Sets system HTTP/SOCKS proxy; supports browser and most apps

Recommended
TUN Mode

Creates a virtual NIC to capture all traffic; covers games and terminal

Global Coverage
Setup complete! Open your browser and visit Google or YouTube to verify the connection.

macOS Config Guide

RecommendedClash Verge Rev· Supports Apple Silicon & Intel

Download Client
Clash Verge Rev for macOS Primary Client

The most comprehensive cross-platform Clash client for macOS. Native support for Apple Silicon M1/M2/M3 chips, providing a smooth macOS-style interface, deep integration with system proxy, and TUN mode support.

Apple Silicon Native Intel Support TUN Transparent Proxy Auto Update
1

Download Correct Version & Install

VisitDownloadand pick your version:

  • ARM64 (M-Series): For Macs bought after late 2020 (M1, M2, M3, etc.)
  • x64 (Intel): For older Macs bought before late 2020 with Intel processors
Not sure? Click Apple icon → 'About This Mac'. If it says 'Apple M1/M2/M3', choose ARM64; if it says 'Intel', choose x64.

After downloading the.dmgfile, double-click to open it and drag the Clash Verge Rev icon to 'Applications' to install.

Got 'developer cannot be verified' error?Go to 'System Settings' → 'Privacy & Security', find the app at the bottom, and click 'Open Anyway'.
2

Import Airport Subscription Link

Start Clash Verge Rev, and from the left menu enter 'Profiles」：

  1. Click 'New', then paste the airport subscription link in the popup
  2. Click 'Confirm' and wait for node data to load
  3. Double-click the newly created profile to set it as the active configuration
It is recommended to enable 'Auto Update' in profile settings, with an interval of 12–24 hours to ensure nodes are always up-to-date.
3

Enable Proxy · macOS System Permissions

  1. From the left menu, click 'Settings', and set Proxy Mode to 'Rule」
  2. Enable 'System Proxy' — macOS system network settings will then be automatically configured
  3. Upon first activation, macOS will request permissions. Click 'Allow」
To proxy terminal/CLI traffic, you can additionally enable 'TUN Mode'. This requires your macOS administrator password for network extension installation on the first use.
Setup complete! Visit Google via Safari or Chrome to verify the connection.

Android Config Guide

RecommendedClashMeta for Android· Supports ARM64 / ARMv7

Download Client
ClashMeta for Android Primary Client

The most stable and actively updated Clash client for Android. Developed by the MetaCubeX community based on Mihomo core. Full support for TUN transparent proxy, Fake-IP DNS leak protection, and direct import of Clash YAML subscriptions.

TUN Global Transparent Proxy Fake-IP DNS Leak Protection Direct Subscription Import Traffic Statistics & Monitoring
Before You Install:Android disables APK installation by default. You must manually grant permission under 'Settings → Security → Install Unknown Apps' for your browser or file manager.
1

Download and Install APK

VisitDownload, and choose the version matching your phone model:

  • ARM64-v8a (Recommended): Supported by almost all Android phones after 2016. Most users should choose this.
  • Universal Version: A fallback option if the ARM64 version fails to install.
  • ARMv7: For a small number of older devices from before 2016.

Once downloaded, tap the APK in the notification bar or find it in your download folder to install manually.

2

Import Airport Subscription

Open ClashMeta for Android, tap the 'Profiles' tab at the top:

  1. Click the '+' button to create a new profile
  2. Choosing 'URL' type, and paste the subscription link in the input field
  3. Enter any profile name and tap the save icon in the top right
  4. Long-press the created profile and select 'Update' to fetch node data
Setting 'Auto Update' to 24 hours is recommended to keep your node list current.
3

Select Node · Enable Proxy

  1. Tap the 'Proxy' tab at the bottom to view node groups
  2. Click '⚡ Test Latency', then pick the node or group with the lowest latency
  3. Go back to the 'Home' tab and tap the large Cat Icon (or the start button) in the middle
  4. Tap 'OK」
Proxy started! A VPN icon will appear in the status bar. Visit Google to verify.

iOS Config Guide

RecommendedStashorShadowrocket· Requires US Apple ID

View iOS Clients
Special Note for iOS:Due to App Store restrictions in some regions, apps like Stash and Shadowrocket may not be available. You will need to register or sign into a US Apple ID to download these apps. Detailed registration steps are provided below.
Stash
Full-featured, support for Clash YAML format
Top Choice
Shadowrocket
Widest compatibility, easy to use
Quantumult X
Best for power users, strong script and rule capabilities
1

Register a US Apple ID (Skip if you have one)

  1. Openappleid.apple.com in your browser and click 'Create Your Apple ID」
  2. Enter your name, birthday, a new email address (never linked to an Apple ID), and password
  3. The region MUST be set to 'United States', as this determines your account region
  4. Verify your account via the email confirmation code
  5. Open 'App Store' on your iPhone → tap your avatar → scroll to the bottom and tap 'Sign Out' → Sign in with your new US Apple ID
  6. On the first login, select 'None' for payment method, and use any US address (e.g., Oregon state, OR 97201) to finish setup
After using the US App Store, you can switch back to your original Apple ID. Purchased apps will still work and update normally.
2

Purchase and Download Stash from App Store

  1. Ensure you are using your US Apple ID, then open the App Store
  2. Search for 'Stash', and find 'Stash - Rule Based Proxy' (blue icon)
  3. Tap the price button (approx. $3.99) to purchase and install
For Shadowrocket, search for 'Shadowrocket' (approx. $2.99). Both are one-time purchases with no ongoing subscription fees.
3

Import Subscription & Enable Proxy in Stash

  1. Open Stash and tap the 'Profiles' tab at the bottom
  2. Click the '+', then choose 'Download from URL（Remote Config）」
  3. Paste your airport subscription link, enter a name, and save
  4. Go back to Home and tap 'Connect' button to start the proxy
  5. The system will prompt 'Stash Would Like to Add VPN Configurations'. Tap 'Allow', and authenticate with Face ID or your passcode
Setup complete! A VPN icon will appear in the status bar. Visit Google via Safari to verify the connection.
ADVANCED

Advanced Config

Understand Clash proxy modes, YAML config structure, and rule sets for precise traffic control

Detailed Guide to Proxy Modes

Mode
Traffic Range
Scenario
Permissions
Rule Mode
Splits traffic by rules: Proxy for overseas, Direct for domestic
Daily use; prioritizes speed and stability
None required
Global Mode
All traffic goes through the proxy node
When all sites require a proxy connection
None required
Direct Mode
All traffic connects directly; no proxy used
Temporary proxy disable without closing the client
None required
TUN Mode is not a proxy mode, but a traffic capture method. It can be combined with Rule/Global/Direct modes to achieve full coverage (e.g., games, terminal tools).

Clash YAML Config Structure

Clash uses YAML for configuration, either manually written or auto-generated by subscriptions. Common fields include:

config.yaml — Typical Configuration Example 
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

# DNS Config (Fake-IP recommended to prevent DNS leaks)
dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - 223.5.5.5
    - 114.114.114.114

# Proxy Providers (Airport subscription link)
proxy-providers:
  airport-sub:
    type: http
    url: 'https://your-airport.com/subscribe?token=xxx'
    interval: 86400
    health-check:
      enable: true
      url: https://www.gstatic.com/generate_204
      interval: 300

# Traffic Rules
rules:
  - DOMAIN-SUFFIX,google.com,PROXY
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

Protocols Supported by Mihomo Core

Clash clients based on the Mihomo core support all mainstream proxy protocols out of the box after subscription import:

SS Shadowsocks
VM VMess
TR Trojan
VL VLESS
H2 Hysteria2
TU TUIC v5
SR ShadowsocksR
SN Snell

Common Traffic Rule Types

Rule Type
Description
Example
DOMAIN-SUFFIX
Matches domain suffixes (including all subdomains)
DOMAIN-SUFFIX,google.com,PROXY
DOMAIN
Matches the full domain exactly
DOMAIN,www.example.com,DIRECT
DOMAIN-KEYWORD
Matches domains containing specific keywords
DOMAIN-KEYWORD,youtube,PROXY
IP-CIDR
Matches specific IP address ranges
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP
Matches based on IP country/region geolocation
GEOIP,CN,DIRECT
MATCH
Default rule for traffic that doesn't match any other rule
MATCH,PROXY

Configuration FAQ

Having issues? Here are answers to the most common questions

DOWNLOAD

Need a Client?

Visit our Download Center to pick the right Clash client for your platform. We host all packages directly for fast domestic access.

  Download Center   Mihomo Repository