Windows
Windows 10 64-bit and up; installer and portable build both available, with launch-on-startup and one-click system proxy takeover.
Go to download →Open-source ecosystem · Clients updated continuously
Grab the client for your platform, import a subscription, and turn on the system proxy — that's it. Always free, open source, with full documentation covering everything from installation to rule-based routing and TUN mode.
From rule-based routing to day-to-day maintenance, six stations cover the core ways people actually use Clash. Spot a station that interests you, and the transfer link takes you straight to the matching section of the manual.
Traffic gets routed by domain, IP range, and GeoIP database: local sites go direct, target services go through the proxy, ad domains get blocked outright. Rules match top to bottom and stop at the first hit — once a rule set is written, there's almost no need to manually switch routes day to day. To check exactly which rule a connection matched, open the connections panel in the client and read through the log line by line; whether routing is behaving as expected becomes obvious right away.
Rule, Global, and Direct correspond to three ways of commuting: run Rule mode day to day and traffic gets dispatched automatically by the rule set; switch to Global when debugging an app that needs everything routed through the proxy; switch to Direct when you want to temporarily disable the proxy without quitting the client. All three modes switch instantly from the client's main screen with no restart required, and switching never touches the rule set you've already written.
The system proxy can only take over apps that respect proxy settings — command-line tools and some clients bypass it entirely. TUN mode intercepts all traffic at the network layer through a virtual network adapter, bringing games, terminals, and system updates into the routing scope as well. Before enabling it, install the service mode and close any other virtual network adapter software, then verify that DNS hijacking is working. Once confirmed, it's safe to leave on long-term, and it stacks cleanly with rule-based routing.
A subscription link bundles nodes, proxy groups, and rules into a configuration file that can be updated remotely. Paste the link to import it, set an auto-update interval, and node changes never require manually editing the config again. Multiple subscriptions can coexist — name each by purpose, update them independently, and switch between them with one click without overwriting each other. When a subscription fails to fetch, the client's log gives a clear source for the error, so tracking down the problem is straightforward.
Windows, macOS, Android, iOS, and Linux each have their own client, but the configuration syntax is identical — one subscription works everywhere. On desktop, choose Clash Plus or Clash Verge Rev; on mobile there are App Store releases and Android installers; servers and routers can run the mihomo core directly. Switching devices just means re-importing the same subscription — rules and groups carry over unchanged.
Set up launch-on-startup and automatic subscription updates, and the client can run unattended for the long haul. Updating the GeoIP and GeoSite databases about once a month keeps routing accurate; node latency testing is built right into the proxy group screen — run a quick test periodically and let an auto-select group handle switching, saving the time of picking nodes by hand. When something goes wrong, check the log panel first; most issues leave a clear trail there.
Five platforms, five platforms of their own. Pick your operating system to jump to its section on the download page and grab the client in recommended order.
Windows 10 64-bit and up; installer and portable build both available, with launch-on-startup and one-click system proxy takeover.
Go to download →Intel and Apple Silicon installers, lives in the menu bar, system proxy takes effect instantly with the toggle.
Go to download →Android 8.0 and up, VPN service takes over global traffic, supports per-app proxy and automatic subscription updates.
Go to download →Available on the App Store, works on iPhone and iPad alike — import a subscription and switch proxy modes as needed.
Go to download →Deb packages and precompiled cores available — desktop users install the GUI client, servers run mihomo directly.
Go to download →Once installed, there are only three things left to do. Below is the condensed route — the full step-by-step walkthrough is on the setup guide page, with anchor links to jump straight to each step.
Open the client's configuration page, paste the subscription link from your provider, confirm the import, and wait for the config file to finish downloading. Once the config name appears in the list, the import succeeded.
Back on the main screen, switch the proxy mode to "Rule." Local traffic goes direct, target services go through the proxy, and all routing is handled automatically according to the rules in the config — no manual intervention needed.
Flip the system proxy switch on, then visit a familiar site to check connectivity. If the page loads normally, the connection is working; if it doesn't, test node latency first and retry with a different working node.
Clash started as a rule-based proxy core from the open-source community, and thanks to its clear configuration syntax and stable routing capability, it gradually became the de facto standard in this space. After the original repository was archived, the community didn't stop there: the configuration format, rule syntax, and usage conventions were carried forward intact, so newer and older clients hand off smoothly, and existing configs never need to be rebuilt from scratch.
The actively maintained core today is mihomo (the Clash Meta core) from the MetaCubeX community. It's compatible with classic Clash configuration and keeps expanding protocol support and DNS capability. All the desktop and mobile clients listed on this site are built on this core, with core updates and client releases moving on independent, publicly tracked release schedules.
From Clash Verge Rev and FlClash to Clash Nyanpasu, all the mainstream GUI clients are fully open source — anyone can review the implementation, file issues, or submit patches. The rule sets, GeoIP databases, and subscription conversion tools across the ecosystem are likewise community-maintained, and most problems already have a documented precedent and fix in the public issue trackers.
Download links on this site always point to the latest release of each client, with version numbers shown live on the download page; the clients themselves also check for updates automatically. To follow the core source directly, clone the repository on the right — the releases page ships precompiled builds for every platform in step.
git clone https://github.com/MetaCubeX/mihomo.git
Test node latency first, then check the proxy mode and which rule the connection matched, working through the checklist item by item.
Subscription update keeps failing?First confirm the subscription link hasn't expired, then check whether the update request itself is being blocked by the local proxy.
TUN mode or system proxy — which should I use?System proxy is enough for daily use; turn on TUN when you need to capture terminal or game traffic too. See the glossary for the full concept.
Can I rely on free nodes long-term?Fine for verifying that the client is configured correctly; for stable daily use, a reliable subscription source is recommended.
Explains the fundamental difference between the TUN virtual adapter and the system proxy for traffic capture, with complete steps for enabling TUN, installing the service mode, and verifying DNS hijacking on Windows and macOS.
Breaks down subscription fetch failures by cause — from expired links and blocked network requests to User-Agent checks — and shows exactly where to set the auto-update interval in each client, with recommended values.
From node latency tests and wrong proxy modes to DNS poisoning and rules matching DIRECT, lists nine checkpoints in local-first-then-remote order, each with how to verify it and the matching fix.