工具

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 的使用。

关于此条目

类型
工具
类别
固件工具
关联
基础工具
目标
固件

来源复核于

说明已依据一手来源复核;这不代表已运行验证、经过安全审计或确认兼容。

报告条目过时 建议修正翻译

一手来源

  1. README.md GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  2. docs/sw/m1n1-user-guide.md GitHub · AsahiLinux/docs · 修订 0d1f891
  3. proxyclient/tools/run_guest.py GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  4. proxyclient/hv GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  5. requirements.txt GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  6. .github/workflows/test.yml GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  7. .github/workflows/build.yml GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  8. LICENSE GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  9. LICENSE.MIT GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  10. AGENTS.md GitHub · AsahiLinux/m1n1 · 修订 7cde7d1
  11. https://asahilinux.org/llm-policy/
  12. https://github.com/AsahiLinux/m1n1/releases/tag/v1.9.9
  13. https://github.com/AsahiLinux/m1n1/releases/tag/v2.0.0

同分区更多条目:固件与硬件

固件与硬件分区全部 29 项资源