Tutorial

Cross-Platform Setup Guide

From installation and subscription import to troubleshooting — a complete flow for Windows, macOS, Android and iOS.

Download the client first
Windows macOS Android iOS Config Syntax

Windows: Install Clash Verge Rev (Recommended)

1

Download the installer

Get the Windows build of Clash Verge Rev from the download page. Most users want the x64 build.

2

Complete installation

Double-click the .exe and follow the prompts. If antivirus software blocks it, temporarily disable the antivirus before installing.

3

Import subscription

Open Clash Verge Rev, click "Profiles" on the left, paste your subscription URL and click Import. Click the profile to activate it.

4

Enable system proxy

Click "Settings" on the left, turn on "System Proxy". Choose "Rule" mode for smart split routing.

Tip: TUN mode (virtual NIC) proxies all TCP/UDP traffic including apps that ignore the system proxy. Requires administrator privileges.

macOS: Install ClashX Pro / Clash Verge Rev

1

Download the installer

Get ClashX Pro or Clash Verge Rev (aarch64 for M-series, x64 for Intel) from the download page.

2

Install and trust the developer

Double-click the .dmg and drag the app to Applications. If macOS blocks it, go to System Settings → Privacy & Security and click "Open Anyway".

3

Import subscription

Click the menu-bar cat → Config → Remote config → Manage. Add your subscription URL and click Download.

4

Enable system proxy / Enhanced Mode

Click the menu-bar icon → "Set as system proxy". For full-traffic proxy, enable "Enhanced Mode".

macOS 15+: On the latest systems you may need to run sudo xattr -rd com.apple.quarantine /Applications/ClashX\ Pro.app to remove the quarantine flag.

Android: Install Clash for Android / FlClash

1

Download and install the APK

Get CFA or FlClash from the download page. Regular users should pick the Universal build; 64-bit devices can use arm64-v8a. First-time users must allow installs from unknown sources.

2

Import subscription

Open the client, tap "+" → URL, paste your subscription and tap Create. Tap Update to fetch the latest nodes.

3

Start the proxy

Tap Start on the main screen and allow the VPN connection. The VPN icon in the status bar means it's active.

Tip: Enable DNS resolution in Settings → Clash → DNS to avoid DNS leaks; per-app proxy lets you choose which apps use the proxy.

iOS: Install Clash Plus / Shadowrocket

1

Switch to a US Apple ID

Sign out of your current Apple ID in the App Store and sign in with a US account (create one if needed).

2

Download the app

Search "Clash Plus" or "Shadowrocket" in the US App Store and install.

3

Import subscription

Open the app, tap "+" → Subscribe → paste the URL → Done. Nodes will populate automatically.

4

Enable the proxy

Toggle the switch on and allow the VPN configuration. When the icon turns green, the proxy is active.

Config Syntax Guide

Overall config structure

Clash uses YAML. The main fields are:

# Basic network settings
port: 7890          # HTTP proxy port
socks-port: 7891    # SOCKS5 proxy port
mixed-port: 7892    # Combined port
allow-lan: false
mode: rule          # rule / global / direct
log-level: info
external-controller: 127.0.0.1:9090

dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - 223.5.5.5
    - 8.8.8.8

proxies: [...]
proxy-groups: [...]
rules: [...]

Node (proxies) examples

Shadowsocks

proxies:
  - name: "SS-Hongkong"
    type: ss
    server: hk.example.com
    port: 8388
    cipher: aes-256-gcm
    password: "your_password"

Trojan

  - name: "Trojan-Japan"
    type: trojan
    server: jp.example.com
    port: 443
    password: "your_password"
    sni: jp.example.com

Proxy groups

Proxy groups define selection strategy — manual, url-test, load balance, etc.

proxy-groups:
  - name: "Node Select"
    type: select
    proxies:
      - "Auto"
      - "SS-Hongkong"
      - DIRECT

  - name: "Auto"
    type: url-test
    url: http://www.gstatic.com/generate_204
    interval: 300
    proxies:
      - "SS-Hongkong"
      - "Trojan-Japan"

Routing rules

rules:
  # Ad blocking
  - DOMAIN-KEYWORD,adservice,REJECT

  # Direct
  - DOMAIN-SUFFIX,baidu.com,DIRECT
  - GEOIP,CN,DIRECT

  # Proxied
  - DOMAIN-SUFFIX,google.com,Node Select
  - DOMAIN-SUFFIX,youtube.com,Node Select

  # Fallback
  - MATCH,Node Select
Recommended: Community rule sets (like Loyalsoldier/clash-rules) save a lot of manual work.

Ready to get started?

Download the Clash client and follow this tutorial step by step.

Free Download