English · 简体中文
Important
Development has moved to Clash-Client.
This is the historical repository formerly located at TokenPLS/Hako-Client, transferred to ProjectClash on October 10, 2026. It is retained as an archive and will receive no further code updates or releases.
Use the active repository for current source, build instructions, releases and new issues. Outstanding reports have been transferred with their discussions; their original issue links redirect to the new locations.
Historical commits, contributor attribution, branches, tags, releases and download assets are retained. Stars and fork relationships remain attached to this historical repository. Earlier names and build instructions below describe the historical version, not the current project.
Historical README
English · 简体中文
A native, rule-based proxy client for iPhone, iPad, Mac and Apple TV, powered by the Hako kernel.
Use the App Store link to install the official app. The instructions below are for building from source.
This repository contains the Apple applications, their extensions, shared libraries and resources needed to build them. The Hako kernel and Adapter components are maintained in separate repositories; their source revisions are pinned in Dependencies.lock.json.
| Directory | Contents |
|---|---|
apple/HakoClient |
Platform applications, extensions and XcodeGen project specification |
apple/HakoClientKit |
Shared configuration and profile models |
apple/HakoClientUI |
Shared interface components |
apple/HakoMacClient |
macOS components |
The source distribution is pre-release. The App Store app version and a checkout of this repository are separate artifacts; pin a source revision when reproducing a build.
The iOS and macOS projects wrap the static Core in a shared framework, with the required header-copy build step included in project generation. Available features depend on the pinned Kernel and Adapter revisions; the iOS/tvOS SDK does not include EasyTier.
- macOS with Xcode 27.0 and the iOS, macOS and tvOS SDKs.
- XcodeGen and Git available on your command path.
- Go with automatic toolchain selection enabled, or the Go 1.26.6 toolchain selected by the pinned kernel's binding module.
- Python 3 with PyYAML.
git clone https://github.com/TokenPLS/Hako-Client.git
cd Hako-Client
python3 -m venv .build/python-env
source .build/python-env/bin/activate
python3 -m pip install PyYAML
python3 scripts/bootstrap.py
python3 scripts/configure.pyThe first bootstrap fetches the pinned public Kernel and Adapter sources, installs the pinned gomobile tools and builds the five-slice SDK. It requires network access and can take several minutes. The configure step generates the Xcode project.
Open apple/HakoClient/HakoClient.xcodeproj and choose a scheme:
| Platform | Scheme |
|---|---|
| iPhone / iPad | HakoClient |
| Apple TV | HakoTV |
| Mac | HakoMac |
For an unsigned iOS Simulator build:
xcodebuild -project apple/HakoClient/HakoClient.xcodeproj \
-scheme HakoClient -configuration Release \
-destination 'generic/platform=iOS Simulator' CODE_SIGNING_ALLOWED=NO buildSet your own bundle identifier family and Apple Developer Team ID:
python3 scripts/configure.py --bundle-base org.yourname.clash --team YOURTEAMIDConfigure signing and capabilities for the app and its extensions in Xcode, including Network Extensions, App Groups and any iCloud capabilities you use. Certificates and provisioning profiles are not included. An unsigned build checks compilation; installing on a device requires your own signing setup.
Report app problems in Issues. Include the platform and OS version, app version or source revision, reproduction steps, and expected versus actual behavior. Share only the configuration and logs needed to reproduce the problem, with credentials and subscription links removed.
Kernel issues can be reported in Hako; packet bridge and provider lifecycle issues belong in Hako-Adapter.
GPL-3.0. Third-party resource licenses remain with their resources.