工具
m1n1 Apple Silicon 引导与硬件研究工具
Asahi Linux 面向 Apple Silicon Mac 的引导程序与硬件研究环境。它将 Apple 的启动链衔接到 Linux,加载附加在其后的设备树、initramfs 和内核;在代理模式下,Python 客户端可通过 USB 连接实时探查硬件,并在 m1n1 的虚拟机监控器中运行 macOS 或 Linux,同时追踪其硬件访问。
使用条件与局限
- 处于活跃开发中:所审阅的 main 提交(2026-10-19)比 v2.0.0 标签(2026-10-02)多 53 个提交;该标签说明称其为首个 GPL 版本,其余与 v1.9.9 相同。GitHub 上最新的发行版 v1.9.9 提供第二阶段 m1n1.bin,以及只含 m1n1 boot.bin 的纯 UEFI 软件包。
- 只能在 Apple Silicon Mac 上运行。构建需要 aarch64-linux-gnu-gcc 交叉工具链(或 ARM64 原生工具链)、macOS 上的 LLVM 与 lld,或仓库附带的 compose 环境;支持链式加载的构建还需 Rust 的 aarch64-unknown-none-softfloat 目标。Python 代理客户端(依赖 pyserial、construct、asn1)在另一台主机上通过 USB 与 m1n1 通信。
- m1n1 由 Apple 的 kmutil 在 macOS 恢复环境中安装为自定义启动对象,通常由 Asahi Linux 安装器完成。run_guest.py 接受 Mach-O 格式的客体,例如来自使用者自有 macOS 安装的 XNU kernelcache;仓库不附带任何 Apple 固件、内核或 macOS 组件。proxyclient/hv 收有 27 个追踪脚本,覆盖 AGX、DCP、NVMe 和 SMC 等硬件模块。
- CI 会构建 main 分支、检查 C 与 Rust 代码格式,并在 Ubuntu 及 macOS 14、15 上运行代理客户端的 pytest 测试套件;这些测试覆盖其汇编器、目标文件加载和工具链处理,不涉及在 Mac 硬件上的行为。
- v1.9.9 及以前的代码仍采用 MIT 许可;自 v2.0.0 起 m1n1 采用 GPL-2.0-or-later,内嵌的 libfdt、部分 Arm Trusted Firmware 代码、dlmalloc 等第三方代码及随附的 Rust crate 保留各自许可。Asahi Linux 的 LLM 政策以其净室逆向工程规则为由,广泛禁止在实质性贡献中使用生成式 AI;AGENTS.md、CLAUDE.md 和 GEMINI.md 则称维护者出于法律原因禁止任何 AI 或 LLM 的使用。
关于此条目
- 类型
- 工具
- 类别
- 固件工具
- 关联
- 基础工具
- 目标
- 固件
来源复核于
说明已依据一手来源复核;这不代表已运行验证、经过安全审计或确认兼容。
一手来源
- README.md GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- docs/sw/m1n1-user-guide.md GitHub · AsahiLinux/docs · 修订 0d1f891
- proxyclient/tools/run_guest.py GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- proxyclient/hv GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- requirements.txt GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- .github/workflows/test.yml GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- .github/workflows/build.yml GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- LICENSE GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- LICENSE.MIT GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- AGENTS.md GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
- https://asahilinux.org/llm-policy/
- https://github.com/AsahiLinux/m1n1/releases/tag/v1.9.9
- https://github.com/AsahiLinux/m1n1/releases/tag/v2.0.0