Platform downloads
Choose a client by operating system, processor architecture, and usage scenario. Most users should download a GUI app; servers, routers, and automation environments can choose the Mihomo core below.
Before downloading
Client names may look similar, but their supported platforms, package formats, and maintenance status differ. Making these three checks before downloading helps avoid launch failures and architecture mismatches.
Select the system actually running on the device, rather than relying on the device brand. Windows uses EXE installers, macOS uses DMG files, Android uses APK files, and Linux commonly uses DEB, RPM, or AppImage. iPhone and iPad users install Clash Plus through the App Store.
Most Windows desktops use x64. Macs with M-series chips use Apple Silicon or ARM64, while Intel Macs use x64. Recent Android devices usually use arm64-v8a; older devices may require armeabi-v7a. An architecture mismatch can prevent the installer from launching.
GUI clients provide interfaces for importing configurations, switching policy groups, enabling the system proxy, and viewing logs, making them suitable for everyday computers and phones. Mihomo is a standalone core that runs through configuration files, the command line, or another management panel, mainly for servers, routers, and self-managed network environments.
Client packages
The platform tab is synchronized with the address bar, so you can share the current URL to send someone the download list for a specific system. Dynamic version details appear only when the manifest provides a valid version.
Desktop downloads for Windows 10 and Windows 11. Most users should start with the installer, complete the setup wizard, and then import a configuration. On enterprise-managed or restricted devices, first confirm that network proxy applications are permitted.
| Recommended system | Windows 10 / 11, 64-bit |
|---|---|
| Common formats | EXE installer, ZIP archive |
| Architecture | x64 for most computers |
Check the chip type in About This Mac before downloading. Macs with M1, M2, M3, M4, or other M-series chips should use Apple Silicon; devices showing an Intel processor should use x64. When opening the downloaded app for the first time, follow the system prompts to confirm its source and network permissions.
| Recommended system | A macOS version that still receives security updates |
|---|---|
| Package format | DMG disk image |
| Chip selection | ARM64 for M-series chips, x64 for Intel |
Recent phones and tablets usually use arm64-v8a. Older 32-bit devices use armeabi-v7a. If the architecture is unclear, choose the universal package for Clash Meta for Android. Before updating, keep the current subscription URL and any necessary local configurations in the client.
| Recommended environment | An Android version that still receives security updates |
|---|---|
| Package format | APK |
| Architecture | Newer devices usually use arm64-v8a |
iPhone and iPad users can install Clash Plus through the App Store. After installation, import a valid configuration, allow the network configuration when prompted by iOS, and then choose the required policies and connection mode.
| Supported devices | iPhone、iPad |
|---|---|
| Installation channel | App Store |
| Configuration method | Subscription URL or compatible configuration file |
Linux desktop users can choose Clash Verge Rev or FlClash for a GUI. Debian, Ubuntu, and derivatives generally use DEB; Fedora and RHEL-based distributions generally use RPM. For servers and routers, continue to the Mihomo core section.
| DEB | Debian, Ubuntu, and common derivatives |
|---|---|
| RPM | Fedora and RHEL-based distributions |
| Current architecture | Desktop clients provide AMD64 |
Core packages
The Mihomo core is intended for servers, routers, gateway devices, containers, and automated operations environments. Everyday computer and phone users should prefer the GUI clients above.
| System | Processor architecture | Format | Best suited for | Download |
|---|---|---|---|---|
| Windows | AMD64 | .zip |
Common 64-bit Windows servers and desktop test environments | Download |
| Windows | ARM64 | .zip |
Devices running Windows on ARM | Download |
| macOS | Intel AMD64 | .gz |
Intel-based Macs | Download |
| macOS | Apple Silicon ARM64 | .gz |
Macs with M-series chips | Download |
| Linux | AMD64 | .deb |
Debian, Ubuntu, and compatible package environments | Download |
| Linux | AMD64 | .gz |
Generic 64-bit x86 Linux environments | Download |
| Linux | ARM64 | .gz |
64-bit ARM servers, development boards, and routers | Download |
| Linux | ARMv7 | .gz |
Older devices using 32-bit ARMv7 | Download |
| Linux | MIPS softfloat | .gz |
Routers using the MIPS soft-float ABI | Download |
Do not guess from the router model alone. Check the CPU architecture and ABI in the device management page, firmware status page, or terminal. ARM64, ARMv7, and MIPS are not interchangeable; MIPS devices also require the correct endianness and floating-point ABI. The MIPS package on this page is specifically for soft-float environments.
After downloading .gz, extract it to obtain the executable, grant execute permission, and use the command line to specify the working directory or configuration file. For long-running processes, use a system service to prevent the process from stopping when the terminal closes.
Installation flow
Installing the client is only the first step. Importing, checking, and enabling the configuration in a fixed order makes it easier to locate parsing, system proxy, and policy-selection issues.
Complete the desktop setup wizard, move the macOS app to Applications, install the APK on Android, or open the app from the App Store on iOS. On first launch, review prompts about network permissions, the firewall, or network configuration, and approve access only after understanding its purpose.
Add a usable subscription URL on the configuration or subscription page, or import a compatible local configuration file. After importing, check for YAML parsing errors, unsupported fields, or download failures. Keep the original subscription URL rather than overwriting your only configuration copy.
For regular use, start with Rule mode so domains and addresses follow the configured connection rules. Then open the main policy group and choose an available entry. Global mode routes more connections through one policy and is useful for short tests, but should not be enabled long-term without understanding its scope.
Enable the system proxy or network takeover feature according to the client’s capabilities, then test the connection in a browser. If only some apps fail, check whether they follow the system proxy. If everything fails, check the configuration status, current policy, log errors, DNS, and local network in that order.
Download FAQ
These answers cover client selection, package formats, processor architectures, and first-time configuration. For more extensive runtime issues, visit the troubleshooting page and investigate by category.
Most desktop and mobile users should start with Clash Plus for their platform. For more detailed desktop configuration management, choose Clash Verge Rev on Windows, macOS, or Linux. If you want a similar interface across systems, consider FlClash.
The Mihomo core requires you to prepare configurations, startup parameters, and a process-management method yourself. If you are unfamiliar with the command line, system services, and network forwarding, you do not need to download the core separately.
The EXE installer writes program files through a setup wizard and creates launch shortcuts as designed by the app, making it suitable for normal desktop use. A ZIP archive must be extracted to a stable folder, with updates and removal managed manually, making it suitable for portable folders or controlled test environments.
Do not run the program directly from a ZIP preview window. If you choose ZIP, extract it completely and avoid directories that are frequently synchronized, automatically cleaned, or permission-restricted.
Open About This Mac from the Apple menu. If the chip name starts with M1, M2, M3, M4, or another M-series designation, choose Apple Silicon or ARM64. If it shows an Intel processor, choose Intel x64. The correct architecture usually reduces translation dependencies and compatibility issues.
Recent Android phones and tablets generally use arm64-v8a. Older 32-bit ARM devices use armeabi-v7a. Clash Meta for Android offers a universal package; choose it when the architecture is unknown, keeping in mind that it is usually larger than a single-architecture package.
If installation immediately reports that the device is incompatible, recheck the system version and CPU architecture instead of repeatedly installing the same file.
The Mihomo core is mainly used on servers, routers, gateway devices, development boards, containers, and environments managed through scripts. Users need to understand configuration paths, permissions, logs, system services, DNS, and forwarding rules. For everyday computers and phones, a GUI client is more straightforward.
The client itself does not include a ready-to-use connection configuration. After installation, import a valid subscription or local configuration, confirm that it parses successfully, choose an operating mode and policy group, and enable the system proxy or network takeover feature for the device platform.
If the connection fails after enabling it, first check the first clear error in the client log. Then check subscription updates, configuration fields, the current policy, system time, DNS, and the local network in order. Avoid changing multiple settings at once.