Show HN: Kakehashi – Experimental userspace to run macOS binaries on Linux ARM
Show HN: Kakehashi – Experimental userspace to run macOS binaries on Linux ARM (github.com)
要約
Kakehashiは、Linux ARM上でmacOSバイナリを実行するための実験的なユーザー空間翻訳レイヤーです。Darwin Mach-Oバイナリをロードし、libSystemをマッピングしてBSDシステムコールを翻訳することで、clangや7-Zip、curlなどの実際のゲストプログラムを実行できます。これは、高価なmacOSランナーの代わりに安価なLinux ARMランナーでmacOSツールを実行することを目的としており、CIでのコスト削減に貢献します。
全文翻訳
Kakehashi
重要なお知らせ
皆様からのスターによるプロジェクトへのご支援、誠にありがとうございます。しかしながら、私はこのプロジェクトを維持することができなくなりました。管理すべきことが多すぎること、macOSバイナリを手動で転送する必要があること、そして最も重要なこととして、人々の関心を理解するためのIssueやPRの不足が、プロジェクト終了の理由です。これは誰のせいでもありません。このようなプロジェクト(開発にAIも使用しています)を維持することがいかに難しいかは理解しています。もし、PR、フォークの作成、または(現時点では私にはない)新しいプロジェクトのアイデアの提案を通じて、このプロジェクトの継続を支援することに興味がある方がいらっしゃいましたら、喜んでお引き受けいたします。改めて、すべてに感謝いたします。
ユーザースペースのmacOS ARM64 → Linux aarch64翻訳レイヤーです。CLIファーストで、JITや命令エミュレータはありません。
Darwin Mach-OバイナリをLinuxにロードし、スタンドアロンのlibSystemをマッピングし、ゲストとホストの境界でBSDシステムコールを翻訳し、aarch64上で実際のツールをネイティブに実行します。
| 機能 / 対象 | 環境 |
|---|---|
ライブ実行 (kh run) | Linux aarch64 のみ(ベアメタル、UTM、Colima、Docker、OrbStack) |
ドライロード (kh run --dry-load) | 任意のホスト(macOSを含む) |
| 設計ドキュメント | docs/ |
インストールとクイックスタート
cargo install kakehashi
# またはチェックアウトから:
cargo install --path crates/kh-cli --force
ゲスト環境セットアップ(「ボトル」)
Kakehashiは、ネイティブmacOSバイナリを含むゲストファイルシステムルート(「ボトル」)を必要とします。ボトルの場所は厳密に固定されており、変更することはできません。
-
固定パス構造: ランタイムはゲスト環境を以下のパスで探します。
~/.local/share/kakehashi/bottle/ストレージ制約: ファイルシステムとパスの仕組みにより、ボトルはホストの内部システムドライブに配置する必要があります。外部ドライブや非ネイティブマウントシステム(例: exFAT)は厳密にサポートされていません。
-
手動バイナリ転送: macOS 26+ インストールから、以下のコアシステムディレクトリをホストのボトルディレクトリに手動でコピーしてください。
/bin→~/.local/share/kakehashi/bottle/bin//sbin→~/.local/share/kakehashi/bottle/sbin//usr/bin→~/.local/share/kakehashi/bottle/usr/bin//usr/lib/zsh→~/.local/share/kakehashi/bottle/usr/lib/zsh/(インタラクティブなzsh、zle.soおよびその他のモジュール。kh bottle statusで確認してください。)
(注: この基本的なユーティリティセット(
rm、zsh、codesignを含む)は、非圧縮で約256MBを占有し、ランタイム分離に不可欠です。/usr/lib/zshは約1MBの追加です。libpcre.0.dylib/libiconv.2.dylibはdyld共有キャッシュ内にありコピーできません。kh bottle ensureはこれらをlibSystemにエイリアスします。) -
Xcode Command Line Toolsのインストール: 基本ディレクトリがステージングされたら、以下を実行して環境の残りをブートストラップします。
kh install xcode-toolsこれにより、公式Apple CLT(
clang、git、SDKを含む)がボトルにプルされ展開されます。
注: ゲスト実行はホストのCWDを使用します。ゲストの/Volumes/linux/…はホストの/に直接マッピングされます。
検証済みエコシステム(動作するもの)
Docker/Colima/OrbStackおよびUTM(Linux aarch64)で検証済みです。ゲストコードはネイティブARM64として実行され、ランタイムはシステムコール、スレッド、フォールトでのみ介入します。
7-Zip
kh run 7zz -- a demo.7z README.md
kh run 7zz -- t demo.7z
curl
kh run curl -- --version
kh run curl -- -sS -o body http://example.com
Apple git (CLT)
kh run git -- --version
kh run git -- clone --depth 1 https://github.com/octocat/Hello-World.git hw
Apple clang (CLT)
kh run clang -- --version
kh run clang -- -c hello.c -o hello.o
未検証の機能
curlの全機能、実際のApple Security.framework、git LFS/svn、GUI、codesign、macOSアプリスタック全体。ネストされたclang/ldプロセスは、プロセスの起動コストがかかりますが、正しさのギャップではありません。
参考ハードウェアと構成
このプロジェクトは、以下の環境設定を使用して明示的にテストされ、安定性が検証されています。
- ビルドホスト(
kh-libsystemのコンパイル): MacBook Pro M1 (2020)、8 GB RAM / 256 GB SSD、macOS 26.6.1実行中。 - テストホスト(
kh runの実行): 同じM1 Macホスト上のUTM内で、Ubuntu 26.04 live-server (arm64)。
仕組み
- 静的なボトルパス(
~/.local/share/kakehashi/bottle/)を解決します。 - Mach-O + dylibをロードし、シンボルをバインドし、BSDハイパーコールをランタイムに配線します。
LC_MAINにジャンプします。ゲストARM64はCPU上でネイティブに実行されます。- システムコール、ヘルパー、pthreadコンテキストの境界が
kh-runtimeを通過し、元に戻ります。
注: クリーンルーム開発プロセスです。Darlingから派生したものではありません。ツリー内にAppleのプロプライエタリなブロブはありません。
クレート
| クレート | 役割 |
|---|---|
kakehashi | バイナリ kh(これをインストールしてください) |
kh-loader | Mach-Oの解析、マッピング、バインディング、実行 |
kh-runtime | メモリ、トラップ、BSDシステムコール、ボトル、スレッド。libSystem.B.dylibを埋め込み |
kh-libsystem | スタンドアロンのdylibソース(aarch64-apple-darwinのみ) |
kh-libsystemのレイアウト
crates/kh-libsystem/src/
core/ # syscalls, errno, heap, process, host helpers
dylib/ # libsystem_c, pthread, libcurl, libc++, libz, …
frameworks/ # CoreFoundation, Security, CoreServices (soft)
要件
- Rust 1.88+
- Linux aarch64 (ライブ
kh run用) - ページサイズ: 4 KiBおよび16 KiB(Asahiクラス)
パフォーマンス
ゲストコードはネイティブに実行されます。コストは境界のクロスオーバー(TLS、alt stack、NEON、dispatch)であり、エミュレータではありません。
マルチファイル7zzは、ネイティブLinux 7zzに対して約×1.24で実行されます。ネストされたApple clangは、-cc1/ldホップごとにプロセスの起動コストがかかります。ロードパスは最適化されていますが、ネイティブmacOSとの壁時計パリティは主なCI目標ではありません。docs/roadmap.mdを参照してください。
ライセンス
Apache-2.0 — LICENSE.txt、NOTICE。
詳細なドキュメント: docs/。コントリビューティングガイドライン: CONTRIBUTING.md。