clash-core — bash — 120×40 ● CONNECTED

Clash v3.0 — Free Open-Source Proxy Tool

⚡ High-Performance Core ◈ Multi-Protocol Matrix ⊕ Rule-based Routing Engine ▲ Native Go Compilation

Clash is a free and open-source network proxy tool. Based on YAML configuration, it supports intelligent rule-based routing, one-click subscription import, and is compatible with Windows, macOS, Linux, Android, and iOS.

42.9k+ GitHub Stars
5M+ Total Downloads
<1ms Rule Latency
GPL-3.0 License Type

>> Core Features [FEATURES]

◈ MOD_ROUTING

Intelligent Rule Routing

Forget simple global proxies. Supports granular routing based on Domain, IP CIDR, GeoIP, and Port. Millisecond matching ensures traffic hits the optimal node instantly.

⊕ MOD_MULTIPROTO

Multi-Protocol Support

Deep compatibility with Shadowsocks, Vmess, Snell, SOCKS5, and other major encrypted protocols. Modular architecture handles complex network setups with ease.

⊞ MOD_CROSSPLAT

Cross-Platform Support

Core compiled in native Go, perfectly adapted for Windows, macOS, Linux, Android, and iOS. Write your config once and use it everywhere seamlessly.

▲ MOD_PERFORM

High Speed, Low Memory

Built on low-level asynchronous I/O with a tiny memory footprint. Maintains zero latency even under gigabit throughput, designed for heavy network loads.

⑆ MOD_API

RESTful API & Panel Control

Built-in RESTful API and WebSocket for real-time monitoring. Allows third-party UIs to manage configs, reload settings, and display traffic dashboards.

⊙ MOD_OPENSRC

Fully Open Source, No Backdoors

Core code is fully open-source on GitHub. No closed black boxes, no tracking. We respect and protect your digital privacy and freedom from the ground up.

>> Supported Platforms [PLATFORMS]

Native compilation for all major platforms. Enjoy peak performance regardless of your OS. Click an icon to jump to the download section.

What is Clash?
Clash is a rule-based network proxy tool, similar to a Shadowsocks client but far more powerful. It helps you manage multiple proxy nodes and automatically chooses between direct connection or proxy based on the website you visit, ensuring smooth access to both local and international networks.

>> 3 Steps to Get Started [QUICKSTART]

01

Download Client

Select the appropriate version for your OS and install it. Supports Windows, macOS, Linux, and Android platforms.

02

Import Subscription

Import the YAML subscription link provided by your service. Clash will automatically parse nodes, rulesets, and policy groups.

03

Enable System Proxy

Turn on System Proxy or TUN mode to enjoy precise routing and low-latency performance instantly and transparently.

>> How it Works: Intelligent Routing [ARCHITECTURE]

[ LOCAL_NET ] [ CLASH_CORE_ENGINE ] [ WAN_INTERNET ] | | | (TUN/TAP/PROXY) +----------+----------+ +----------+----------+ | | | | | [ Requests ] ======> | Rule Matching | ======> | Proxied Sites | | | GeoIP / Domain | | SS / VMess / TLS | | +----------+----------+ +----------+----------+ | | | +------------------ [ DIRECT ] ----------------------> Domestic Sites

Supports TUN virtual interfaces and traditional proxy modes. Kernel-level interception of all TCP/UDP traffic. Integrated Rule-Provider and GeoSite databases intelligently separate traffic, resolving DNS pollution and connectivity issues.

>> Configuration Preview [CONFIG.YAML]

~/clash/config.yaml
# Clash Core Config · Basic Example
port: 7890 # HTTP Proxy Port
socks-port: 7891 # SOCKS5 Proxy Port
allow-lan: false
mode: rule # rule / global / direct
log-level: info
proxies:
  - name: "🇭🇰 Hong Kong-01"
    type: ss
    server: hk01.example.com
    port: 8388
    cipher: aes-256-gcm
rules:
  - GEOIP,CN,DIRECT # Local traffic connects directly
  - DOMAIN-SUFFIX,google.com,PROXY
  - MATCH,DIRECT # Fallback rule

>> Encryption Protocols [PROTOCOLS]

Shadowsocks (SS) ShadowsocksR (SSR) VMess VLESS Trojan SOCKS5 / HTTP(S) Hysteria / TUIC Snell WireGuard

>> Performance Benchmarks [BENCHMARKS]

Rule Matching Speed≈ 0.3 ms
Memory Usage (Idle)~12 MB
Gigabit Throughput940+ Mbps
Concurrent ConnectionsUnlimited

>> Download Clash [DOWNLOAD]

Terminal — Download Manager v3.0.0
  • 🪟 Windows Invoke-WebRequest -Uri "clash-win.exe"
    v3.0.0 [ .EXE ]
  • 🍎 macOS brew install clash-mac-core
    v3.0.0 [ .DMG ]
  • 🐧 Linux sudo apt-get install clash
    v3.0.0 [ .TAR.GZ ]
  • 🤖 Android adb install clash_android.apk
    v3.0.0 [ .APK ]
  • 📱 iOS App Store → Search "Clash for iOS"
    v3.0.0 [ APP STORE ]

>> Frequently Asked Questions [FAQ]

Q.01Is Clash free to use?
Yes, Clash core is entirely free and open-source (GPL-3.0). All platform clients are available for free download and use.
Q.02What is the difference between Clash and a VPN?
Clash is a rule-based proxy tool that allows granular control over which traffic goes through a proxy and which stays direct. It's more flexible than traditional VPNs and doesn't require a virtual network driver (unless using TUN mode).
Q.03How do I import a YAML subscription link?
In your client (e.g., Clash for Windows or ClashX), go to Profiles or Config, paste the subscription URL into the input field, and click Download to automatically load your nodes.
Q.04What is TUN Mode? Should I enable it?
TUN Mode creates a virtual network adapter to intercept traffic from all apps, including those that don't support proxy settings (like games or CLI tools). Enable it if you need full-system proxying.
Q.05Why are some local websites slow?
This is usually due to improper rule configuration causing local traffic to route through a proxy. Ensure you have GEOIP,CN,DIRECT in your rules and use local DNS servers for domestic domains.
Q.06What is the relationship between Clash Core and UI clients?
Clash Core is the high-performance engine (CLI only). Clash for Windows, ClashX, and Clash for Android are third-party GUIs built on top of this open-source kernel.