ProjectClash / Clash

# Clash
English · 简体中文
Clash is a proxy kernel based on **mihomo v1.19.32**, with Go bindings and build tooling for Apple applications. It produces `Clash.xcframework` for iOS, macOS and tvOS.
To install the official app, use the App Store link above. This repository is for developers building or integrating the kernel.
## Upstream history and modifications
Clash is an independent derivative of MetaCubeX/mihomo, based on v1.19.32, commit `88dcbf7f1614a67c3b36b848ee3592dfa92ada36`. It is not affiliated with MetaCubeX. The upstream project asks unaffiliated downstream projects not to use “mihomo” in their names.
This repository retains the original mihomo commits and contributor identities. Its first source publication records the accumulated Clash adaptations in one commit, joining the existing README history with the official upstream baseline. Later changes are published as separate logical commits; stable upstream upgrades retain the official upstream commits as merge parents. Compare the upstream baseline with a Clash revision to inspect the Apple bindings, SDK build tools and kernel modifications. This initial publication does not reconstruct the development history of those adaptations.
The upstream GPL-3.0 license remains in LICENSE. See NOTICE and THIRD_PARTY_LICENSES.md for attribution and dependency licenses.
## Project repositories
| Repository | Contents |
| --- | --- |
| Clash | Proxy kernel, Go bindings and Apple SDK build tools |
| Clash-Adapter | Swift packet-flow bridge and provider lifecycle components |
| Clash-Client | Native iOS, iPadOS, macOS and tvOS applications and extensions |
## Versions and downloads
| Component | Current reference |
| --- | --- |
| Upstream engine | mihomo **v1.19.32**, recorded in `UPSTREAM_VERSION` |
| Released Apple SDK | `v1.19.32-clash.3` |
| Client integration | Kernel and Adapter commits pinned in the Client's `Dependencies.lock.json` |
The upstream engine version, SDK release tag and App Store app versions are separate. Use a release tag to reproduce an SDK release; `main` can contain later changes. Client and Adapter source are currently published by commit, without their own release tags.
SDK downloads include all five Apple slices, license notices and a source manifest. Each release also provides the notices separately, the source archive for the embedded EasyTier core used by macOS, and `SHA256SUMS` for checking downloaded assets.
## What is included
- The mihomo-based proxy engine: protocol implementations, DNS, routing rules, proxy groups and providers.
- `bind/clash`: the API exposed to Apple applications through gomobile.
- `cmd/build_libbox`: SDK generation and platform packaging.
- `docs/config.yaml`: configuration reference included with the source.
An application supplies configuration, storage, the Network Extension integration and signing. Platform capabilities differ; a configuration accepted by the parser does not establish end-to-end support for every protocol or rule on every