../assets/fonts/inter.css ../assets/fonts/noto-sans-sc.css ../assets/fonts/fontawesome/all.min.css
Field notes · Clash Verge Rev in real use

Take Control of Your Network
with Clash
From Download to Routing

Everything here was written while working with Clash: steps that turned out useful, and the reasons behind the ones that blocked me. Follow it end to end, or take just the part you need. If your Clash Verge Rev is misbehaving, there is a good chance a similar case is recorded here.

★★★★★ 4.9 · 50M+ Users
The choice of developers, researchers, and everyday users.
Key Features

More Than a Proxy Tool—Your Intelligent Network Hub from Practice

From its rule engine to multi-protocol compatibility, Clash offers a all-in-one network solution for individuals, developers, and teams.

Rule-based Intelligent Splitting Engine in Practice

At the heart of Clash is a packed routing system. Direct traffic based on Domain, IP CIDR, process name, or GeoIP: decide what's direct, what's proxied, and what's blocked—all in milliseconds. Goodbye, global-only proxies.

High Performance with Go From Experience

Built on Go's concurrency model to handle thousands of connections on a single core. Low memory usage and 24/7 stability.

Unified Multi-Protocol Management Field Notes

SS, VMess, Trojan, Snell, VLESS, Hysteria... One client for all major protocols—no more switching tools.

Visual Web Dashboard Tips

Built-in RESTful API and Web Dashboards let you monitor traffic and switch nodes in real-time—no command line required.

YAML Config & One-click Subscription in Practice

Easy to follow, readable YAML configurations. One-click subscription pull in for automatic node pull the latests—no manual upkeep needed.

Multi-Platform Support

Choose Your OS
Bring up Downloading Now Lessons Learned

Clash provides natively optimized builds for each platform, ensuring the best compatibility and performance.

Clash for macOS From Experience

Latest Settled v2.0.26

A native macOS app optimized for Apple Silicon (M1/M2/M3) and Intel. Integrated system proxy and Enhanced Mode (TUN) for true global traffic capture—no CLI needed.

🔒

Enhanced Mode Support

Capture all TCP/UDP traffic via a virtual network control panel (TUN), including apps that don't support proxy settings.

⚡

Rapid Menu Bar Switching

Switch proxy modes (Rule/Global/Direct) with one click from the status bar. Monitor real-time connection velocitys at a glance.

📋

Profile Management

Supports switching between multiple profiles, with auto-updating subscription links and local rule overrides.

Requires macOS 11 Big Sur or later.

Clash for Windows Field Notes

Latest Settled v0.20.39

The nearly all popular Clash GUI for Windows, featuring a polished, modern control panel. Supports TUN mode (global proxy), mixed TAP/TUN, and autostart on boot—the top choice for Windows users.

🛡️

TUN Mode

Capture all system traffic, including UWP apps and games, solving proxy issues for apps without built-in settings.

🌐

Auto System Proxy Setup

Hands-free configures Windows system proxy with one click—no manual setup needed for browsers or apps.

Clash for Android Tips

Latest Settled v2.5.12

A native Android client featuring Material You design. Uses the VPN API for global traffic without requiring Root. Supports subscriptions, rule splitting, traffic stats, and velocity testing.

📱

No Root Required

Uses the system VPN control panel for global proxy—no Root or Xposed needed.

⚙️

Per-App Proxy

Per-app proxy settings for precise control and data savings.

Clash for iOS (Clash Plus) in Practice

App Store Versions

For iOS, we recommend Clash Plus, built on the Clash core and utilizing the Network Extension for full rule-based splitting. Compatible with all Clash YAML configs. Official site: clashplus.io.

🔗

Fully Subscription Compatible

Supports standard Clash YAML subscription links, using the same configs across macOS and Windows.

Clash for Linux From Experience

CLI Version v1.18.0

Headless Clash binaries for Linux supporting x86_64, arm64, and armv7. Supports systemd autostart and remote management via Web Dashboards (yacd/metacubexd).

🖥️

systemd Service Support

Includes ready-to-use systemd service files for easy background execution and boot autostart.

🔧

TUN Mode Global Capture

Achieve true transparent proxy using iptables/nftables or the built-in TUN device.

Can't find your version?

We also provide legacy releases, Meta cores, router firmware, and more.

View All Downloads
Protocol Compatibility

Supports All Major Protocols in the Wild

Whether you use an airport or self-hosted nodes, Clash is fully compatible. One client to manage all protocols.

Shadowsocks (SS)
The classic proxy protocol, battle-tested for years for stability and reliability.
Fully Supported
VMess
Core V2Ray protocol supporting WebSocket, gRPC, and H2 for high censorship resistance.
Fully Supported
VLESS
A low-footprint optimization of VMess, removing unnecessary encryption overhead for superior performance with XTLS.
Newly Supported
Trojan
Disguises traffic as HTTPS, using real TLS to bypass Deep Packet Inspection (DPI).
Fully Supported
Hysteria / Hysteria2
Next-gen high-velocity proxy based on QUIC, maintaining excellent velocity even on high-ping networks.
Newly Supported
Snell / ShadowTLS
High-performance encryption with TLS obfuscation for superior traffic disguising.
Fully Supported
SOCKS5 HTTP/HTTPS Proxy ShadowsocksR (SSR) WebSocket Transport gRPC Transport HTTP/2 Trojan-Go WireGuard GeoIP Region Rules DNS-over-HTTPS DNS-over-TLS Fake-IP Mode TUIC v5 Load Balancing Fallback
Rapid Bring up

Set Up Clash in 4 Uncomplicated Steps Hands-On Notes

Go from download to connection in under 5 minutes. No CLI required—all via a user-friendly GUI.

1

Download & Install

Choose the version for your OS and follow the install prompts. Mac users: remember to allow the app in System Settings.

2

Pull in Subscription

Paste your Subscription URL into the "Configs" tab and click download. Clash will fetch node and rule info hands-free.

3

Select Node & Mode

Switch to the "Proxies" tab, select a node, and set the mode to "Rule" (recommended), "Global," or "Direct."

4

Enable Proxy & Enjoy

Click "Enable System Proxy." Clash will configure your system settings, giving you access to Google, GitHub, and more.

View Full Guide & FAQ
Best Use Case

Who Uses Clash? from Practice

From independent developers to global enterprise teams, Clash serves whoever you are needing advanced proxy solutions.

👨‍💻
Developer's Choice

Developers & Programmers Field Notes

Access GitHub, Stack Overflow, and npm registries without timeouts. Use rule-based splitting to proxy dev traffic while keeping local services direct.

No more GitHub clone/push timeouts.; Accelerate pip, npm, and brew package managers.; Search docs via Google; access ChatGPT & Claude.; Keep local services (WeChat, Taobao) direct..

🎓
Academic Research

Researchers & Students Tips

Access Google Scholar, Sci-Hub, arXiv, and international journals for the latest global research.

✈️
Business & Travel

Expats & Business Travelers in Practice

Access home-country banking and apps while abroad; use Google Workspace, Zoom, and Slack seamlessly when traveling.

FAQ

Clash FAQ Lessons Learned

Curated answers to the nearly all frequently searched questions about Clash.

Is Clash completely free? Are there either fees?
The Clash core is open-source and 100% free under the GPL-3.0 license. GUI clients for various platforms are also free. Note: Proxy nodes/airport services are third-party and by default require a separate subscription, independent of Clash.
How to add a subscription link in Clash?
macOS/Windows GUI: Open Clash → go to "Configs" or "Profiles" → click "Pull in from URL" → paste link → click Download. Click refresh to pull the latest nodes.

Linux CLI: Add node info right off to config.yaml or use tools like clash-sub to pull converted YAML configs.
What is Clash Rule Splitting? How to customize rules?
Rule splitting lets you define which traffic is proxied or direct. Rules support DOMAIN, DOMAIN-SUFFIX, IP-CIDR, GEOIP, and more.

Add custom rules to the rules: section of your config; they match from top to bottom. We recommend community rulesets like ACL4SSR or Loyalsoldier for out-of-the-box coverage.
Clash vs. Shadowrocket: Which is better?
Both serve different needs: Clash is a cross-platform powerhouse with superior rule-based splitting and a unified experience across Windows, Mac, and Android. Shadowrocket is an excellent choice for iOS (paid, approx. $2.99) with deep system integration. For iPhone users, both Shadowrocket and Stash are great companions for your Clash subscriptions.
What protocols does Clash support? How does it differ from V2Ray?
Clash supports 10+ protocols including Shadowsocks, VMess, VLESS, Trojan, Snell, Hysteria2, SOCKS5, and HTTP—broader than V2Ray/V2RayN (focused on VMess/VLESS). Clash's killer feature is its rule-routing engine, which offers far more precise traffic control than V2RayN. Nearly all users prefer Clash for daily use.
Why can't I connect to the internet with Clash?
Please check the following: 1. Validate Nodes—be up and running a velocity test in the "Proxies" tab; if all timeout, your subscription might be expired. 2. Proxy Mode—switch to "Global" to rule out config issues. 3. System Proxy—ensure "Enable System Proxy" is checked. 4. Firewall/Antivirus—whitelist Clash if it's being blocked.
How to fix macOS "Unidentified Developer" warning?
This is macOS Gatekeeper, not a virus. Method 1: Right-click the app → select "Open" → click "Open" again in the dialog. Method 2: Go to "System Settings → Privacy & Security" and click "Open Anyway." Once authorized, you get to launch normally by double-clicking.
Is Clash safe? Does it leak my privacy?
Clash is open-source and auditable, with no backdoors. Risks mainly involve: 1. Modified versions from unofficial sources (always use GitHub); 2. Your proxy provider can see the domains you visit (though content is encrypted). Choose reputable providers. Locally, Clash acts as a SOCKS5/HTTP proxy and does not send user data externally.
Direct Comparison

Clash vs. Other Proxy Tools in the Wild

Compare features and performance to find the best tool for your needs.

Feature ✦ Clash V2RayN Shadowrocket Surge
Open Source & Free Completely Free Free Paid Paid
Supported Platforms Win/Mac/Linux
Android/iOS
Primarily Windows iOS Only Mac/iOS
Rule Splitting Excellent Partial Support Good Excellent
Protocols Supported 10+ Mainly VMess/VLESS Multiple Multiple
TUN / Enhanced Mode Supported Partial Versions Supported Supported
Subscription Support Full Support Supported Supported Supported
Web Dashboard Built-in API ✗ ✗ ✓
Configuration Guide

Clash Config File
Structure at a Glance Hands-On Notes

Clash uses YAML for clean, natural syntax. Mastering the basic structure allows you to customize every rule.

01

Basic Settings Section

Define listening ports (HTTP/SOCKS5), DNS modes (fake-ip/redir-host), and external controller settings.

02

Proxies List

Add your proxy server details: protocol, address, port, encryption, and password. Supports multiple nodes.

03

Proxy Groups

Organize nodes into strategy groups like "Auto-select," "Fallback," or "Load Balance" for intelligent routing.

04

Rule Split Section

Route traffic based on Domain, IP, or GeoIP. Precisely define what goes through the proxy and what stays direct.

Download Now

Choose Your Perfect Version
Free Forever, Ready to Use from Practice

Whether for personal use, development, or team deployment, we have the right solution for you.

For Personal Use

Free Download Edition From Experience

Forever Free · No Limits

Access all core features including rule splitting, multi-protocol support, and Web dashboards—perfect for daily browsing.

Choose Your Platform
For Routers & Servers

Headless Deployment Tips

Headless · Low-footprint

Be up and runnings as a daemon on OpenWrt, Linux servers, or NAS. Remote management via Web dashboards with minimal resource usage.

View Deployment Guide

Ready to bring up?
Download Clash for Free Lessons Learned

Join 50 million users worldwide. Say goodbye to restrictions and enjoy an open internet.