Beginner's Guide

Complete Clash Proxy Config Guide

From installation to accessing Google in 5 minutes. Perfect for beginners. Follow this guide for a full Clash setup.

Est. 8 min read Difficulty: Beginner Continuous Updates

Clash in 5 Minutes

The Clash configuration process involves four steps, followed in order. If you have a subscription link, it takes less than 5 minutes.

1
Install Client
2
Import Subscription
3
Choose Mode
4
Enable Proxy

Step 1 Install Client

Select the appropriate version for your OS from the download page and install:

New Users: For Windows and macOS, we recommend Clash Verge Rev for its user-friendly interface and active community support.

Step 2 Import Subscription URL

Once the client is open, you need to import your proxy node subscription link into Clash.

1

Go to 'Subscription' or 'Config'

In Clash Verge Rev, click Subscription on the left; for Android, tap Config at the bottom.

2

Paste Subscription URL

Click 'New' or 'Import from URL', paste your link from your provider, and give it a name (e.g., 'My Proxy').

3

Click 'Update' to Download

Click 'Update Subscription'. Clash will download the node information. Once successful, you'll see your nodes in the proxy list.

4

Activate the Config

Click the subscription card to activate it. Clash will now use the nodes and rules from this configuration.

No link yet? Subscription links are provided by 'node providers' or 'airports'. See the How to Get a Subscription section below.

Step 3 Select Proxy Mode

Clash offers multiple modes. We recommend Rule Mode for most users:

Global Mode

All network traffic is routed through the proxy, including local websites and apps.

Direct Mode

Clash stays running, but no traffic goes through the proxy. Equivalent to pausing. Useful when you temporarily don't need a proxy.

Step 4 Turn on System Proxy

After selecting a mode, enable 'System Proxy' to route your device's traffic through Clash.

1

Toggle 'System Proxy'

In Clash Verge Rev, find the 'System Proxy' toggle on the home page and turn it on.

2

Verify Success

Visit google.com. If it opens, you're all set! If not, try switching to a different node.

3

Check Logs (Optional)

View the 'Logs' or 'Connections' page to see real-time traffic routing and troubleshoot issues.

Setup Complete! You've finished the basic setup. You can now explore more features like node selection strategies and subscription management.

What is a Subscription?

A Subscription URL is a special web address containing proxy node configurations. Clash uses this link to automatically download and sync your node list.

Manual Entry (Not Recommended)
  • Needs manual input of server, port, and password for each node
  • Must manually delete and re-add nodes if they expire
  • No auto-sync when provider updates node info
Subscription URL (Recommended)
  • One link for all nodes, simple import
  • Click 'Update' to sync latest node info
  • Syncs instantly if provider changes node details
Subscription links usually start with https://. Providers offer these in your user dashboard for easy copying.

How to Get a Link?

Clash itself doesn't provide nodes. You need to purchase them from a third-party provider. Here's how:

1

Sign up with a Provider

Choose a provider (often called an 'airport') based on node locations, bandwidth, and price (usually $2–$10/month).

2

Purchase a Plan

Select a plan that fits your data needs (monthly or annual) and complete payment.

3

Locate your Subscription Link

In your dashboard, look for 'One-click Import' or 'Clash Subscription Link' and copy the URL.

4

Import into Clash

Go back to your Clash client and follow Step 2 to paste and import.

Security Reminder: Your subscription link contains account info. Do not share it or post it publicly.

Updates & Management

Providers update nodes (adding capacity or replacing blocked nodes). We recommend updating your subscription regularly.

Manual Update

Click 'Update' in the client to pull the latest configuration immediately.

Auto Update

Most clients allow setting update intervals (e.g., every 12 or 24 hours) for hands-off management.

Manage Multiple Links

You can add links from different providers and switch between them in the proxy list.


Proxy Modes Explained

Rule Mode (Recommended)

Rule Mode is the core feature of Clash and the best choice for most users.

Clash uses a set of domain and IP rules to automatically decide where to route each request:

Network Request
Clash Rule Engine
Local Domain → Direct
baidu.com / taobao.com ...
Intl. Domain → Proxy
google.com / youtube.com ...
In Rule Mode, local browsing speed is not affected as it connects directly without going through the proxy.

Global Mode

All network traffic is routed through the proxy, including local websites and apps.

Note: In Global Mode, local websites may load slower and use your proxy data. Only use it when you need every request to go through the proxy.

Direct Mode

Clash stays running, but no traffic goes through the proxy. Equivalent to pausing. Useful when you temporarily don't need a proxy.


In-depth TUN Mode Analysis

TUN Mode is Clash's most powerful advanced feature, operating at the network layer rather than just the application layer. It's the top choice for gaming, UDP proxying, and preventing DNS leaks.

System Proxy vs TUN: Key Differences

There is a fundamental difference between standard 'System Proxy' and TUN Mode:

System Proxy Mode
Application Layer (HTTP/HTTPS)
  • Browsers & apps with proxy support
  • Apps without proxy settings
  • UDP traffic (Gaming, Calls)
  • CLI tools (curl, wget, etc.)
  • Some system service traffic
Only routes supported apps
VS
TUN Mode
Network Layer (IP Packets)
  • All browsers and apps
  • Apps without built-in proxy support
  • Full UDP traffic proxying
  • CLI tools auto-proxied
  • All system network traffic
Take Over All Network Traffic

How TUN Mode Works

TUN mode creates a virtual network interface (usually utun or Meta) in the OS, routing all traffic to this interface for the Clash core to handle.

All System Apps Browsers, Games, CLI Tools...
All IP Packets
Virtual TUN Interface Virtual network card created by Clash
Route to Clash Core
Clash Rule Engine Resolving destination & matching rules
DIRECT
Direct Out Domestic Traffic
PROXY
Proxy Nodes International Traffic

Best Use Cases for TUN Mode

Gaming Acceleration

Games (Steam, Epic, Blizzard, etc.) use UDP which standard proxies often miss. TUN mode proxies all game traffic, reducing latency and packet loss for a better intl. gaming experience.

Full UDP Support

Unlock Streaming

Streaming platforms like Netflix, Disney+, and YouTube Premium detect your IP. TUN mode ensuring all traffic (including UDP) follows your proxy rules for smooth playback.

Full Media Proxying

Developer Tools

CLI commands like git clone, npm install, and docker pull often bypass system proxies. TUN mode transparently accelerates these tools without extra config.

Zero-Config CLI Proxy

Prevent DNS Leaks

In standard mode, DNS queries might bypass the proxy. TUN mode intercepts all DNS requests, and with Fake-IP, it completely prevents DNS leaks.

Total DNS Takeover

How to Enable TUN Mode

Windows (Clash Verge Rev)
1

Run as Administrator

Right-click the icon and choose 'Run as Administrator'. Or enable 'Launch as Admin' in settings.

2

Go to 'Settings' → 'Clash Core'

In the main interface, navigate to Settings and look for the 'Clash Core' or 'TUN Mode' options.

3

Toggle TUN Mode

Switch on 'TUN Mode'. Windows will ask for UAC permission to install the virtual network driver; click 'Yes'.

4

Confirm it's Working

You should see a new 'Meta' adapter in your network settings. Traffic from games and CLI tools will now be auto-proxied.

macOS (Clash Verge Rev / ClashX Meta)
1

Enable 'Enhanced Mode' or 'TUN Mode'

In the client settings, find 'Enhanced Mode' or 'TUN Mode' and toggle it on.

2

Enter System Password

macOS will prompt for your password to modify the system routing table. Enter it and click 'OK'.

3

Verify Interface Creation

Run ifconfig | grep utun in Terminal. If you see a utun interface created by Clash, it's working.

Android (Clash Meta for Android)
1

Start VPN on Home Screen

Tap the big start button. Android will ask to 'Allow VPN Connection'; tap 'OK'. TUN on Android is implemented through the VPN API.

2

Bypass Specific Apps (Optional)

Under 'Settings → Bypass Apps', choose apps that should bypass the proxy (e.g., banking apps) to avoid being blocked.

With TUN enabled, System Proxy is no longer needed. While they don't conflict, TUN mode already handles all traffic, so system proxy settings are ignored.

Fake-IP vs Real-IP: Choosing your DNS Mode

Your DNS strategy affects performance in TUN mode. Clash offers two modes:

Recommended

Fake-IP Mode

Clash returns a 'fake' IP (e.g., 198.18.x.x) immediately. The app connects instantly, and Clash then resolves the real destination and routes according to your rules.

Ultra-low latency connection without waiting for DNS
Eliminates DNS leaks to your ISP
Ideal for gaming and real-time streaming
Some apps verify if IP addresses are legitimate. If they fail, try Real-IP mode.

Real-IP Mode

Clash performs a normal DNS lookup and then decides based on the real IP whether to use the proxy.

Higher compatibility, behaves like a traditional proxy
Best for apps that require IP validation
Higher overall latency due to extra DNS resolution time.

Read Before Enabling TUN Mode

Administrator Rights Required

TUN mode modifies system routes. Windows needs 'Run as Admin', macOS needs a system password, and Android needs VPN permission.

Slightly Higher Battery Usage on Mobile

Android's VPN-based TUN uses more CPU than standard proxy mode. We recommend using it while charging or only when needed.

Watch out for Banking & Payment Apps

Some banking apps block access if they detect a VPN or TUN mode. Consider adding them to the 'Bypass List'.

Conflicts with Other VPNs

TUN mode will conflict with other VPN software (WireGuard, OpenVPN, etc.). Disable other VPNs before using Clash's TUN mode.

Why Not Use TUN Mode All the Time?

A great question. TUN's benefits come from deep system access, which has trade-offs. Here's why we don't always recommend it:

01

System Proxy Mode handles 95% of use cases

Most users just need Google, YouTube, Twitter, or Telegram. Standard proxy mode is more than enough for these without the complexity of TUN.

02

Total Traffic Control is a Double-Edged Sword

In standard mode, local apps are unaffected. TUN handles everything, so any misconfiguration can break your entire connection, including local sites and company VPNs.

A mistake in standard mode might fail international sites; a mistake in TUN might disconnect your entire machine.
03

Constant Administrator Privileges

TUN must persistent run with admin/root access. For security, having a long-running process with top-level access is an unnecessary risk for simple daily browsing.

04

Conflicts with Corporate VPNs

Office VPNs (Cisco, GlobalProtect, etc.) often conflict with TUN's routing, causing issues with internal company resources.

05

Mobile Battery & Heat

On Android, the user-space processing of all packets increases CPU wakeups, potentially leading to faster battery drain and higher device temperatures.

06

Fake-IP can Disrupt Local Services

Fake-IP may interfere with local discovery services like mDNS, AirPlay, or local printer discovery that rely on real local IP addresses.

Practical Tip: Use as Needed
When NOT to Use TUN
  • Standard browsing & YouTube
  • Using Telegram, Twitter, etc.
  • Connecting to a corporate VPN
  • Using banking apps
  • Daily mobile use (save battery)
When to ENJOY TUN
  • In-game acceleration (UDP)
  • Unlocking streaming (Netflix, Disney+)
  • Heavy git / npm / Docker use
  • Strict DNS privacy requirements
  • Server or Router transparent proxying

Node Speed Testing

In the Clash 'Proxies' page, you can see all available nodes and perform latency tests:

1

Enter Proxy/Node List

Click 'Proxies' on the left menu to view all node groups (usually organized by region like Japan, Hong Kong, USA, etc.).

2

Perform Latency Test

Click the 'Speed Test' icon (lightning bolt) for a group. Clash tests all nodes in that group. Lower values are better (under 50ms is excellent, under 150ms is acceptable).

3

Select a Low-Latency Node

Once testing is done, click a node with low latency to select it. The active node will be highlighted.

< 80ms Excellent - perfect for streaming/gaming
80–200ms Good - no issues for daily use
200–500ms High - may affect browsing speed
> 500ms Too High - consider switching nodes

Node Selection Strategy

Clash supports various node selection strategies which you can configure in each proxy group:

Manual Select (Select)

The default strategy where you manually click the node you want to use, giving you full control.

Auto Select (URL Test)

Periodically tests all nodes and automatically switches to the one with the lowest latency.

Fallback

Uses nodes in order; if the current node fails, it automatically switches to the next one to ensure connectivity.

Load Balance

Spreads traffic across multiple nodes. Best for multi-connection scenarios like downloading to improve throughput.


Troubleshooting FAQ

Connection Failed

System Proxy is on, but can't access international sites
  1. Check if the selected node is working by performing a speed test
  2. Try switching to a different node or a different region
  3. Verify you are in 'Rule' or 'Global' mode (not 'Direct')
  4. Restart the Clash client and try again
All node tests show 'Timeout'
  1. Check if your subscription has expired or run out of data in your provider's dashboard
  2. Try 'Update Subscription' to get the latest server details
  3. Check if your system time is accurate (time errors cause authentication failures)

Local websites are slow when proxy is enabled

Local sites (Taobao, Bilibili, etc.) load slowly in proxy mode
  1. Verify you're using 'Rule Mode' instead of 'Global Mode'. Global mode routes local traffic through the proxy, causing delays.
  2. If already in Rule Mode, try enabling 'TUN Mode' or 'Fake-IP DNS' in settings
  3. Check if certain apps are bypassing the system proxy and need individual configuration

Mobile Configuration Notes

Android

Before installing APKs, enable 'Unknown Sources' in security settings. We recommend 'VPN Mode' (TUN) for true system-wide proxying.

iOS

iOS is limited; you must use an App Store app (Stash, Shadowrocket, etc.). Allow 'Add VPN Configuration' on first launch.

Advanced Tutorials

In-depth config.yaml Guide

Learn to write your own nodes, proxy groups, rules, and DNS settings. Master every Clash parameter without relying on provider defaults.

View Config Guide

Ready to Start?

Download the right Clash client for your platform and follow this guide. Setup takes just 5 minutes.

Download Clash Client Now