5分钟搞定可启动macOS ISO：macos-iso-builder GitHub Actions快速上手教程

5分钟搞定可启动macOS ISO：macos-iso-builder GitHub Actions快速上手教程

【免费下载链接】macos-iso-builderGenerate bootable macOS installer ISO or DMG images directly from Apple servers via GitHub Actions - no Mac required. Mac OS X 10.7 - macOS 26 Tahoe项目地址: https://gitcode.com/gh_mirrors/mac/macos-iso-builder

macos-iso-builder是一个开源工具，可让你无需 Mac 电脑，直接通过 GitHub Actions 从苹果官方服务器构建可启动的 macOS 安装镜像（ISO / DMG），覆盖从 Mac OS X 10.7 Lion 到 macOS 26 Tahoe 的几乎所有版本。本文带你快速上手这套 GitHub Actions 工作流，5 分钟即可下载到自己的 macOS 安装镜像。

macos-iso-builder 是什么？🍎

这个项目由两部分组成（详见 README.md）：

• 镜像完全来自Apple 官方源，合法可靠
• ISO 适合虚拟机（Proxmox / QEMU / VirtualBox / VMware），DMG 适合制作 U 盘启动盘
• 支持版本：Lion、Mojave、Catalina、Big Sur、Monterey、Ventura、Sonoma、Sequoia 直到最新的 Tahoe

两条工作流：选对才能一次成功 ✅

打开你的 fork 仓库 Actions 页面，左侧有两条工作流可选：

💡 第一次使用建议先跑Recovery ISO，几分钟就能体验到完整流程。

GitHub Actions 构建步骤（无需 Mac）🚀

第 1 步：Fork 仓库

使用 GitHub 账号，在仓库页面点击Fork，把 macos-iso-builder 复制到你自己的账号下。

第 2 步：启用 Actions 工作流

1. 进入你 fork 后的仓库，点击顶部的Actions选项卡
2. 点击绿色的"I understand my workflows, go ahead and enable them"按钮启用工作流

第 3 步：运行工作流并配置参数

1. 在左侧边栏选择Recovery ISO或Full Installer
2. 点击Run workflow，配置两个参数：
   • macOS version— 选择版本，如Sequoia、Sonoma
   • Image format— 虚拟机选iso，U 盘启动选dmg
3. 再次点击绿色Run workflow按钮，开始构建

第 4 步：下载镜像

构建完成后，刷新页面，滚动到Artifacts区域，点击产物链接（如macOS_Sequoia_15.7.4.iso）即可下载。

⚠️ 注意：Recovery ISO 产物是压缩包，使用前请先解压。

ISO 还是 DMG？镜像格式怎么选

• ISO：Proxmox、QEMU、VirtualBox、VMware 直接挂载即可
• DMG：用 Rufus（Windows）、dd（Linux）或asr（macOS）写入 U 盘；文件名带.img后缀（如macOS_Sequoia.dmg.img），是为了让 Rufus 无需切换"所有文件"就能找到它

已有 Mac？本地运行 mkmaciso 脚本 💻

如果你手边就有 macOS，也可以直接运行 mkmaciso 脚本本地构建：

./mkmaciso tahoe # 指定版本，如 tahoe、sequoia、sonoma ./mkmaciso --help # 查看所有参数

不带参数运行会进入交互菜单。环境要求（来自 README.md）：

• macOS 10.9 或更新（推荐 Intel Mac，Apple Silicon 可用但有限制）
• 构建时需要 20-40GB 空闲空间
• 联网 + sudo 权限

实用技巧与注意事项 ⚡

1. 优先查 Releases 页面— 别人可能已经构建好你要的版本，可直接下载，省资源
2. 负责任地使用— GitHub 托管 runner 是免费公共资源，请按需构建，避免无意义重复运行
3. 虚拟机性能— Proxmox 用户可以考虑 GPU passthrough 获得更好体验
4. dd写入请三思— Linux 下用dd烧录 U 盘时务必确认目标设备，它不会询问确认
5. U 盘剩余空间— DMG 烧录后 U 盘通常有剩余空间，可建一个 FAT32 分区放 EFI 文件

项目文件速查 📁

• 项目说明文档：README.md
• 本地构建脚本：mkmaciso
• 完整安装镜像工作流：.github/workflows/build-macos-image.yml
• 恢复镜像工作流：.github/workflows/build-recovery.yml
• 开源协议：LICENSE（GPLv3）

法律提示：本工具从苹果官方服务器下载镜像，请遵守《苹果软件许可协议》。macOS 是 Apple Inc. 的商标。

【免费下载链接】macos-iso-builderGenerate bootable macOS installer ISO or DMG images directly from Apple servers via GitHub Actions - no Mac required. Mac OS X 10.7 - macOS 26 Tahoe项目地址: https://gitcode.com/gh_mirrors/mac/macos-iso-builder