FIELD MANUAL · Downloads & Setup for Every Platform
Clash for Every Platform Download & Rule-Based Routing Setup Guide
Get and configure clients across Windows, macOS, Android, iOS, and Linux, with step-by-step coverage of subscription imports, rule-based routing, and TUN mode — all built on the Mihomo core, kept current with every release.
- Clash Plus · Top Pick for Every Platform
- Mihomo Core
- YAML Subscriptions
- GPL-3.0 Open Source
- English Docs
DOWNLOAD PORTS · Get the App
Pick your platform, jump straight to that download section
Each platform has its own installer and setup section. Click a platform card to jump to the download page, which auto-scrolls to that platform's client list and outlines system requirements and how the available clients differ.
SELECTION NOTE · Which One to Pick
Not sure which client to pick? Clash Plus is the top pick across all platforms — same interface and workflow on every device, built-in Mihomo core, and nothing to relearn when you switch devices. Prefer an open-source desktop option? Go with Clash Verge Rev. The download page lists system requirements, maintenance status, and key differences for every client on every platform, and archived clients stay listed for anyone who still needs them.
TRUNK SECTION · Core Features Cutaway
Five Core Capabilities of Clash, Mapped Along One Line
Five markers stand along the trunk line, one per capability. Click a marker and the panel below shows what problem it solves, how to use it, and the matching config key.
Rule-Based Routing
Rule-based routing is what sets Clash apart from traditional all-or-nothing proxy tools. Rules in the config file are matched top to bottom: requests to local domains or IP ranges connect directly, requests to services outside your region get routed through a proxy node, and ad or tracker domains can be blocked outright. In everyday use, you just stay on rule mode instead of flipping the proxy on and off — traffic automatically takes the right path depending on the site. Subscription-provided rule sets usually already cover the major services, and you can add custom entries in the config file to pin a specific domain to a specific outbound.
rules: DOMAIN-SUFFIX,youtube.com,PROXY · GEOIP,CN,DIRECT · MATCH,PROXY
Subscription Management
A subscription link is how your provider delivers nodes and rules. Paste the subscription URL into the client and it imports every node in one go; turn on scheduled auto-update in settings and the client keeps node lists and rule updates current in the background. If a subscription fails to pull, the usual culprits are an expired link, the subscription server being unreachable on your current network, or a format mismatch — check the link in a browser first, then dig into client settings. Most clients support multiple subscriptions at once, which makes it easy to compare providers or fall back to a backup profile when the primary one goes down.
proxy-providers: type: http · interval: 86400 · health-check: enable
System Proxy & TUN Mode
System proxy works well for browsers and most desktop apps — the client writes the proxy settings into the OS with one click. Some command-line tools and games ignore system proxy settings, though. That's where TUN mode comes in: the client creates a virtual network adapter that intercepts all outbound traffic, giving you true system-wide coverage when paired with rule-based routing. Switch between the two as needed — system proxy is enough for everyday browsing, and TUN mode covers every process when you need it. Note that TUN mode requires admin rights on first use on Windows, and a system extension approval on macOS.
tun: enable: true · stack: system · auto-route: true · dns-hijack: any:53
Proxy Groups & Latency Testing
Proxy groups organize nodes by purpose: a url-test group runs periodic latency tests and auto-selects the fastest node, a fallback group switches to the next backup node in order when the primary fails, and a select group leaves the choice entirely up to you. Combined with region groups from your subscription, you can pin streaming traffic to a specific region while letting everything else auto-optimize. Latency numbers refresh with one click in the client, and switching nodes doesn't require a restart — when something feels slow, check the group's latency results first to see whether the bottleneck is the node or your local setup.
proxy-groups: type: url-test · interval: 300 · tolerance: 50
YAML Configuration File
Every bit of Clash's behavior is described in a single YAML config file — ports, DNS, nodes, proxy groups, and rules each get their own section, and the structure is easy to read and edit. GUI clients turn the common switches into toggles, but once you understand the structure, you can edit the file directly to unlock advanced options the interface doesn't expose, like custom DNS routing, rule-provider subscriptions, and config overrides. Reload after editing and changes take effect immediately; if there's a syntax error, the client points you to the exact line. The same config file works across different clients without changes.
mixed-port: 7897 · allow-lan: false · mode: rule · log-level: info
PROVENANCE · Open-Source Backing
Public source code, actively maintained releases
From the original core to today's Mihomo and the various GUI clients built on it, the source code, commit history, and release notes for the whole ecosystem are public — every claim here can be verified yourself.
HISTORY · Project History
Clash started as an open-source rule-based proxy core released by a community developer, and its clear YAML config and flexible routing rules made it the de facto standard for tools of its kind. After the original repository was archived, the community kept building on its protocol and config format, leading to today's actively maintained forks led by Mihomo. The config ecosystem and usage patterns carried straight over — existing subscriptions and rules keep working with little to no changes.
CORE · Core & Client Relationship
The core handles protocol handshakes, rule matching, and traffic forwarding; a GUI client is just an interface layered on top of it. Every client covered on this site — Clash Plus, Clash Verge Rev, FlClash, and others — ships with the Mihomo core built in, so the same subscription works across all of them without changes. Switching clients just means switching interfaces; routing behavior and config format stay identical, with nothing new to learn.
ECOSYSTEM · Open-Source Ecosystem
The core and every major GUI client have their source code publicly hosted, with commit history, issue discussions, and release notes all open to review. If you run into a problem, search the relevant repo's issues first — most common issues already have a documented answer there. Anyone comfortable reading code can go straight to the source to confirm exactly how a setting or rule behaves, instead of relying on secondhand explanations.
RELEASE · Update Process
Each client ships new installers in step with core version updates, mostly for bug fixes and protocol compatibility. The download links on this site resolve the latest release list on page load, so they always point to the current installer — no need to manually track release pages across repos. Users on an older version can just download and reinstall over the top to upgrade; configs and subscriptions are unaffected.
git clone https://github.com/MetaCubeX/mihomo.git
QUICK ANSWERS · Frequently Asked
Four Things Everyone Asks Before Getting Started
Short answers here — full explanations and step-by-step instructions live in the help center and full documentation.
What's the relationship between Clash and Mihomo?
Mihomo is the actively maintained core in the Clash family today. Every major GUI client defaults to it, and its config format stays backward-compatible with older Clash configs.
Concept Reference →Where do I get a subscription link?
Your subscription link comes from whichever proxy service you use — just copy it into the client's subscription field to import it. This site only covers clients and setup guides; it doesn't provide any node or proxy service.
Help Center →How do I install it on iPhone?
Clash Plus is available on the App Store — install it there, open the app, and paste in your subscription link to get started. See the iOS section of the download page and the setup guide for detailed steps.
iOS Downloads →The proxy is on but sites won't load — now what?
Check things in this order: node availability, subscription status, then system proxy settings. The corresponding section in the full documentation walks through exactly how to check each one.
Full Documentation →FIELD NOTES · Technical Notes
Latest From the Blog
Hands-on notes on proxy modes, client selection, and subscription maintenance, updated regularly by topic.
Rule Mode vs. Global Mode vs. Direct Mode in Clash: Which One Should You Use?
Breaks down how traffic actually flows in each of the three proxy modes, why rule mode is the sensible everyday default, and when global or direct mode actually makes sense.
Read More →
Which Clash Client Should You Use? A Side-by-Side Comparison by Platform
Compares Clash Plus, Clash Verge Rev, FlClash, and other popular clients on interface, core, platform support, and maintenance status, with recommendations for each platform.
Read More →
Clash Subscription Won't Update? Common Causes and How to Set Up Auto-Refresh
Covers the usual reasons a subscription fails to refresh — dead links, network restrictions, user-agent blocks, and format mismatches — plus how to set up scheduled auto-updates so nodes don't go stale.
Read More →