Open-source core · Clients updated regularly

Clash Client Downloads & Setup Guide for All Platforms

This site curates Clash client installers for Windows, macOS, Android, iOS, and Linux, along with setup guides for subscription link import, rule-based routing, and TUN mode. Follow the steps below to get connected on your first try—and if anything goes wrong, the FAQ, glossary, and advanced manual cover most issues so you can usually fix them yourself within ten minutes.

Open-Source Core Multiple Client Options Universal Config Files Guides Kept Up to Date

FEATURES

Core Client Features

From rule-based routing to latency testing, these features are available across every client listed on this site, and config files are interchangeable between platforms. Click the tabs on the left to see what each feature solves, how to get started with it, and how it differs from traditional proxy tools.

Rule-Based Routing

Rules based on domain, IP range, and GEOIP data decide whether each connection goes through a proxy or direct, solving the classic problem of "everything routed through a detour, so local sites get slower". Rules match top to bottom and stop at the first hit—a common setup routes local domains and LAN addresses directly, rejects ad domains, and hands everything else to a proxy group.

You rarely need to write rules by hand: subscriptions usually ship a complete rule set that updates automatically, and when you do need a tweak, custom entries appended at the top of the config take priority. Compared with global mode, rule mode balances speed and automation—see the comparison guide, and put exact domains first with a GEOIP fallback last for the most reliable layout.

TUN Mode

A system proxy only covers applications that respect proxy settings—many command-line tools, some games, and programs that ignore system settings connect directly around it. TUN mode takes over all traffic at the network layer through a virtual network adapter, without relying on an app's own proxy support, making it the standard fix for "the browser uses the proxy but the terminal doesn't".

To use it, flip the TUN switch in the client settings and grant the required system permission—run as administrator on Windows, install the system extension on macOS. Pair it with fake-ip DNS mode for faster resolution, and keep using the system proxy for everyday browsing, switching between the two as needed. See the dedicated article for how the two approaches compare.

Subscription Management

Paste the subscription link from your provider to import a complete configuration—node list, proxy groups, and routing rules all load at once, with no manual field-filling and no format mistakes. First-time setup usually takes under a minute, which makes this the easiest and least error-prone way for new users to get configured.

Clients support setting an auto-update interval, so when your provider changes nodes the local list refreshes on its own—no re-import needed. Multiple subscriptions can coexist and be switched between at any time, and local overrides keep your custom rules from being wiped by updates. See the usage tutorial for the full import steps.

Latency Testing

Run a batch latency test across every node in a proxy group, with results sorted in milliseconds and color-coded by speed. It solves the "dozens of nodes, no idea which to pick" problem: one click surfaces the fastest node that's actually reachable, and timed-out nodes are clearly flagged.

To go fully hands-off, use a url-test proxy group—it automatically picks the lowest-latency node based on test results and switches over when a node's performance drops, with no manual intervention. Running a latency test is also the first step whenever a connection fails; see the troubleshooting guide for the full order of checks.

Cross-Platform Support

Clients such as Clash Verge, Mihomo Party, and FlClash cover Windows, macOS, Android, iOS, and Linux, all built on the same open-source core. That removes the pain of relearning a new tool every time you switch devices: the interfaces differ, but proxy groups, rules, and subscriptions work exactly the same everywhere.

Config file formats are fully interchangeable, so one subscription link can be reused directly across your computer, phone, and tablet with nothing to maintain separately—routing rules tuned on one device work unchanged on another. See the download page for installers and recommended clients on each platform.

  1. Download and Install a Client

    Pick the installer that matches your OS on the download page, run the installer, and complete the first launch. Clash Verge is recommended for desktop platforms—choose "Keep" if Windows shows a security prompt, and allow the app in System Settings on first launch on macOS.

  2. Import Your Subscription Link

    Copy the subscription link provided by your service, then paste it into the client's config page to import it. The node list and routing rules load automatically once the import succeeds; if it keeps spinning, the link was probably copied incompletely or the network is down—copy it again and retry.

  3. Enable the Proxy and Verify

    Pick a low-latency node in the proxy group, turn on the system proxy switch, then open any page in your browser to confirm the connection is working. If pages won't load, run a latency test and switch nodes first, then check whether another proxy app is occupying the port.

DOWNLOAD

Choose Your Platform

Clients are available for all five major platforms—head to the download page to see the options, system requirements, and install notes for each. Every package is labeled with its architecture and version, and the recommended badge tells you which one to grab if you're unsure.

Windows

x64 / arm64 installers for Windows 10 and later—the most fully featured desktop option

Get Download

macOS

Separate builds for Apple Silicon and Intel—check "About This Mac" before downloading

Get Download

Android

Direct APK install, no store account needed; runs on Android 8+ with VPN-mode takeover

Get Download

iOS

Official app via the App Store, works on iPhone and iPad with the same subscription format as desktop

Get Download

Linux

deb / rpm packages plus core binaries, covering both desktop use and headless servers

Get Download
View All Clients →

Get the Core Source Code

git clone https://github.com/MetaCubeX/mihomo.git
  • The core is released under an open-source license, with the full commit history and issue discussions public
  • Releases correspond one-to-one with tags in the source repository, so you can compile and verify the artifacts yourself
  • Multiple community clients—Clash Verge, FlClash, and more—are maintained in parallel; if one stops, you can switch to another seamlessly
  • The config file format is publicly documented, keeping field behavior predictable and auditable, and core upgrades don't break old configs
  • Core and client update on independent schedules: the bundled core updates with each client release, or you can swap in a newer core manually to try new features
  • Imported a subscription but can't get online? Run a latency test and switch to a node that isn't timing out, then confirm the system proxy switch is on and the port isn't taken by another app—if it still fails, work through the troubleshooting checklist starting from subscription validity.
  • Rule mode or global mode? Rule mode is the right choice for everyday use—local traffic goes direct, the rest through the proxy, the best balance of speed and stability. Only switch to global when you temporarily need everything routed through, and switch back after; see the usage notes.
  • Command-line tools or games bypassing the proxy? The system proxy can't reach programs that ignore system settings—enable TUN mode to take over all traffic at the network layer, covering terminals, games, and background services; setup steps are in the tutorial.
  • Where can I learn concepts like proxy groups and Fake-IP properly? Advanced configuration is organized by topic in the advanced manual, and the glossary gives you a quick lookup for what every field means.

BLOG

Latest Tutorials & Troubleshooting Articles

Hands-on articles covering subscription import, mode selection, DNS leak prevention, and connection troubleshooting—each one verified step by step against current client versions and revised alongside client releases.

View All Articles →