Client downloads / platforms and architectures

Clash downloads and client selection

Choose Clash Plus, Clash Verge Rev, or FlClash for your operating system. Check your processor architecture before downloading. For subscription import and connection setup, see the user guide.

GUI clients Installation permissions Mihomo core

Platform index

Choose an operating system

Each platform lists available clients in a consistent order. The primary button links to the usual installer, with other architectures shown alongside it. Version details appear only when valid release data is available; verify file compatibility with your system.

Windows clients

The desktop installers here are x64. Check your system type under Settings → System → About. On an ARM device, confirm that Windows can run the app before downloading; an x64 installer is not a native ARM64 build.

Clash Plus

Top pick

Manage subscription imports, proxy group selection, and everyday connections from a graphical interface. After installing, load your configuration, check the listening port, then enable the system proxy. If you need to capture traffic from more apps, configure TUN separately and grant the required permissions. Avoid changing several network settings at once.

Clash Verge Rev

For desktop users who want to manage configuration, overrides, and service options. After importing a subscription, check which configuration is active. When changing GUI settings, consider how they interact with subscription fields. Service mode and virtual network adapter features may require administrator access.

FlClash

A cross-platform GUI for a similar experience on desktop and mobile. The installer is convenient for everyday use; with a ZIP archive, you’ll need to extract and manage the app directory yourself. Whichever format you choose, quit the old process and back up your configuration before updating.

Clash Nyanpasu

Another desktop interface for managing configurations, suited to users with existing Clash configurations who want to compare workflows. When migrating, don’t just copy UI settings: check the core, rule references, and DNS configuration too. On first launch, test connectivity with the system proxy before enabling additional traffic-capture features.

Clash for Windows

No longer maintained

Archived download for legacy compatibility and configuration migration. Don’t expect ongoing support for newer systems or protocols. Before migrating from an older version, export your configuration and note your subscription source. Check field support in the new client, and don’t run both apps with the system proxy enabled.

Windows installation requirements

CheckRequirements and steps
ProcessorThis section provides x64 installers; they won’t run directly on 32-bit systems.
Windows versionMinimum Windows versions vary by release. Check the release notes before installing on an older version of Windows.
PermissionsStandard system proxy use and service mode require different permissions. Follow system prompts when installing a service or enabling TUN.
Port conflictsQuit other proxy clients and make sure the local listening port is free before enabling the system proxy.

core / Mihomo

Standalone Mihomo core

For users running services on servers or routers, or managing deployments themselves. Most desktop users should choose a GUI client above. The standalone core parses configuration and handles traffic, but has no subscription management interface and won’t configure the system proxy automatically when started.

Target systemProcessor architectureFileDownload
WindowsAMD64 / x64ZIPDownload Windows AMD64
WindowsARM64ZIPDownload Windows ARM64
macOSIntel / AMD64GZDownload macOS Intel
macOSApple Silicon / ARM64GZDownload macOS ARM64
LinuxAMD64DEBDownload Linux AMD64 DEB
LinuxAMD64GZDownload Linux AMD64 GZ
LinuxARM64GZDownload Linux ARM64
LinuxARMv7GZDownload Linux ARMv7
LinuxMIPS soft-floatGZDownload Linux MIPS soft-float

Before deployment

For a standalone deployment, plan the configuration directory, log location, and process management yourself. First run the core in the foreground to confirm the configuration loads and DNS and rule resources work, then set up a persistent service. Before changing routes on a remote device, keep a management connection available in case a configuration error cuts off access.

How the core differs from a client

The same interface name doesn’t guarantee the same core features, and a standalone core may be on a different release schedule from a client’s bundled core. If a protocol or field isn’t supported, check which core is actually running, then verify the subscription format. See the protocol guide for protocol support and configuration differences.

Downloads and configuration checks

A download solves installation, not connection issues. Getting connected also depends on configuration, permissions, and how traffic is routed. For a first setup, check each in order; it’s easier to find problems than by changing several settings at once.

Import first, then route traffic

Open the client, import a subscription or local configuration, and check for parsing errors. Then select a proxy group referenced by your rules. Start by testing with the system proxy; consider TUN only if an app doesn’t honor the system proxy. A successful import means the configuration loaded, not that every proxy in the subscription is available.

Local file paths, service permissions, and background restrictions vary by platform. Preserve protocol and rule sections when copying a configuration, but recheck fields that depend on the system environment. Subscription URLs often contain access credentials; don’t share them in public screenshots, forums, or logs.

See the first-time import and connection guide →

Keep a rollback option before updating

Before updating, save your local configuration, overrides, and any essential UI settings, and note the port in use. Quit the old client before launching the new one to prevent the old process from holding the listening port. When switching clients, don’t assume their settings use the same names or work the same way.

After upgrading, check configuration parsing, proxy group selection, and rule matches. Then verify startup settings and background services. A client UI update doesn’t necessarily update the core too, especially if your subscription uses new protocols or fields. Check the actual core version to confirm compatibility.

Read about core versions and compatibility →

Download FAQs

Installation FAQs

Answers about choosing files, permissions, and updates. Select a question to expand it; answers remain available without JavaScript.

Should I install a client or the Mihomo core?

For your first install, choose a client with a graphical interface. Clients offer subscription import, proxy group selection, logs, and system proxy controls. The Mihomo core is mainly for servers, routers, or users who manage configuration and services themselves. Downloading the core alone does not install a client.

Which should I choose: ARM64, x64, or a universal build?

Check your processor and system architecture in your system settings. Windows x64 and Linux amd64 usually refer to the same instruction set; ARM64 is for a different processor architecture. If you’re unsure which ABI your Android device supports, choose the client’s universal build. For macOS, check the architecture of the actual download. Apple Silicon Macs need a compatible runtime to use Intel builds.

Why do I need to import a configuration after downloading?

The installer contains the client application, but does not provide proxy service. After installation, import a subscription or configuration file you’re authorized to use, then check your proxy groups, rule mode, and system proxy settings. Follow the user guide on this site, and treat subscription URLs as sensitive information.

What should I do if I see a permission or security warning during installation?

First, make sure the file matches your system and architecture, then read the system prompt. On Android, temporarily allow the app performing the installation to install unknown apps. Desktop service mode and TUN usually require additional permissions. Don’t permanently disable system security to run an app. If installation fails, note the exact error and check the release notes.

Can I still use a client that is no longer maintained?

Archived clients may help with legacy compatibility and configuration migration. Once a project is unmaintained, don’t expect ongoing support for newer systems, protocols, or bug fixes. For a new install, choose a maintained client. Back up your configuration before migrating, and check that the new client supports your subscription format and fields.

What should I back up before updating a client?

Keep your subscription source, local configuration, overrides, and any essential UI settings. Note the current listening port and traffic-capture method. Quit the old process before upgrading so two clients don’t compete for the same port. After the update, check that the configuration loads, proxy groups are correct, and the system proxy points to the current port.

Download a client