企业官网建设流程全解析

• 文档
• 教程

macOS 官方安装器无法直接获取 10.7 及更早的版本时，"在线恢复安装器（Online Method）"是 OpenCore 引导方案中最通用的替代路径：它借助 OpenCorePkg 自带的macrecovery.py脚本，从 Apple 恢复服务直接拉取 10.7 至今几乎所有版本的恢复镜像，并把它们布置到一张 FAT32 启动 U 盘上。读完本文，你将掌握macrecovery.py各命令行参数的完整用法、10.7 到最新版本（Tahoe）的现成下载命令，以及"格式化 U 盘 + 构建com.apple.recovery.boot目录"的完整制作流程，并了解 macOS 12 以上版本 USB 栈变化、XhciPortLimit失效等关键避坑点。

什么是"在线恢复安装器"方法

本仓库的安装器总览文档明确区分了两种安装器形态：

• 离线安装器（Offline）：包含一份完整的 macOS 系统副本，体积通常在 8GB 以上，只能在 macOS 内制作；
• 在线安装器（Online）：只包含约 500MB 的恢复镜像（Recovery Image），启动后由恢复环境再从 Apple 服务器拉取完整系统，因此在三平台（macOS / Linux / Windows）上都能制作，但目标机器必须有一块被 macOS 支持的网卡并能联网。

关联文档所讲的正是后者，它支持从 Lion（10.7）一直覆盖到最新版本（Tahoe，26）。由于下载源是 Apple 的恢复服务（仓库在 why-oc.md 中也确认了这一事实），不同 macOS 版本的 Board ID 与 MLB 组合即可精确锁定对应版本，这也是macrecovery.py无需任何 Apple 开发者账号即可工作的原因。

需要说明的是：这一方法适用于 10.7–11 及更新版本的恢复安装，而 10.4–10.6 需要走 Legacy macOS: Disk Images 的镜像恢复法；10.7–10.12（除 10.9 外）也可参考 Legacy macOS: Offline Method 获取完整安装包。

前置准备：获取 macrecovery.py 并确认运行环境

macrecovery.py无需单独下载，它随 OpenCorePkg 一起发布，位于压缩包内的Utilities/macrecovery/目录。运行它只需要：

• 一份 OpenCorePkg 发行包（同时还能拿到稍后要用的EFI目录与OpenShell.efi等工具）；
• 安装了 Python 3 的运行环境（Linux / macOS 自带或可一键安装；Windows 需自行安装 Python 3 并注意使用py启动器）。

在 Linux 下，先进入脚本所在目录（路径以实际解压位置为准）：

cd ~/Downloads/OpenCore-0/Utilities/macrecovery/

在 Windows 下，则是在资源管理器中定位到Utilities/macrecovery/后，在当前路径栏输入cmd打开命令提示符（详见 windows-install.md）。后续所有命令中，Linux / macOS 使用python3 ./macrecovery.py，Windows 使用py macrecovery.py。

下载恢复镜像：macrecovery.py 命令全解析

macrecovery.py的核心用法是：

python3 ./macrecovery.py -b <Board ID> -m <MLB 序列号> [-os <版本>] download

同一版本出现两条命令，是因为该版本存在多个历史机型（例如 10.7 同时适配早期与后期 Mac 机型，10.15 同时覆盖 Intel 与部分兼容机型），两者的 Board ID 不同但都能获取到对应镜像，按你的硬件世代任选其一即可。

以下是仓库文档中 10.7 到最新版本的全部现成命令：

# Lion (10.7): python3 ./macrecovery.py -b Mac-2E6FAB96566FE58C -m 00000000000F25Y00 download python3 ./macrecovery.py -b Mac-C3EC7CD22292981F -m 00000000000F0HM00 download # Mountain Lion (10.8): python3 ./macrecovery.py -b Mac-7DF2A3B5E5D671ED -m 00000000000F65100 download # Mavericks (10.9): python3 ./macrecovery.py -b Mac-F60DEB81FF30ACF6 -m 00000000000FNN100 download # Yosemite (10.10): python3 ./macrecovery.py -b Mac-E43C1C25D4880AD6 -m 00000000000GDVW00 download # El Capitan (10.11): python3 ./macrecovery.py -b Mac-FFE5EF870D7BA81A -m 00000000000GQRX00 download # Sierra (10.12): python3 ./macrecovery.py -b Mac-77F17D7DA9285301 -m 00000000000J0DX00 download # High Sierra (10.13): python3 ./macrecovery.py -b Mac-7BA5B2D9E42DDD94 -m 00000000000J80300 download python3 ./macrecovery.py -b Mac-BE088AF8C5EB4FA2 -m 00000000000J80300 download # Mojave (10.14): python3 ./macrecovery.py -b Mac-7BA5B2DFE22DDD8C -m 00000000000KXPG00 download # Catalina (10.15): python3 ./macrecovery.py -b Mac-CFF7D910A743CAAF -m 00000000000PHCD00 download python3 ./macrecovery.py -b Mac-00BE6ED71E35EB86 -m 00000000000000000 download # Big Sur (11): python3 ./macrecovery.py -b Mac-2BD1B31983FE1663 -m 00000000000000000 download # Monterey (12): python3 ./macrecovery.py -b Mac-E43C1C25D4880AD6 -m 00000000000000000 download # Ventura (13): python3 ./macrecovery.py -b Mac-B4831CEBD52A0C4C -m 00000000000000000 download # Sonoma (14): python3 ./macrecovery.py -b Mac-827FAC58A8FDFA22 -m 00000000000000000 download # Sequoia (15): python3 ./macrecovery.py -b Mac-7BA5B2D9E42DDD94 -m 00000000000000000 download # Latest (Tahoe, 26): python3 ./macrecovery.py -b Mac-CFF7D910A743CAAF -m 00000000000000000 -os latest download

下载需要一段时间，完成后脚本会在当前目录输出恢复镜像文件，例如download-done.png所示的结果：一个约 462.7MB 的镜像文件加上配套的.chunklist校验清单：

BaseSystem 与 RecoveryImage 的区别：根据Linux 制作文档的说明，不同版本下载到的产物命名不同——部分得到BaseSystem.dmg+BaseSystem.chunklist，另一部分得到RecoveryImage.dmg+RecoveryImage.chunklist，二者行为完全一致，后文提到 BaseSystem 时同样适用于 RecoveryImage。

制作 FAT32 启动 U 盘

第一步：格式化 U 盘为 FAT32 + GUID 分区表

恢复启动的核心要求是：FAT32 文件系统 + GUID 分区方案（GPT）。在 macOS 的磁盘工具中，将 U 盘名称设为MYVOLUME、格式选MS-DOS (FAT)、方案选GUID Partition Map即可（见下图）：

若你在 Windows 或 Linux 上制作，仓库提供了等效方案：

• Windows：windows-install.md 给出三条路线——图形界面的"磁盘管理"（适合 UEFI 系统）、Rufus 的 Large FAT32（适合 16GB 以上大容量盘）、命令行diskpart（clean→convert gpt→create partition primary→format fs=fat32 quick，适合 legacy 引导场景）；
• Linux：linux-install.md 使用gdisk重建 GPT 分区（分区类型码0700），再执行sudo mkfs.vfat -F 32 -n "OPENCORE" /dev/<分区块设备>格式化为 FAT32。

注意：FAT32 单分区上限约 32GB，若使用更大的 U 盘，Windows 端务必走 Rufus 的 Large FAT32 路线。

第二步：构建 com.apple.recovery.boot 目录

格式化完成后，在 U 盘根目录新建一个名为com.apple.recovery.boot的文件夹，把刚才下载的镜像与校验文件一起放进去。Windows 文档中特别强调：.dmg与.chunklist两个文件必须同时复制，缺一不可。最终结构如下：

U盘根目录 (FAT32 / GPT) └── com.apple.recovery.boot/ ├── BaseSystem.dmg（或 RecoveryImage.dmg） └── BaseSystem.chunklist（或 RecoveryImage.chunklist）

关键注意事项与排错要点

macOS 12 及以上：先映射 USB 端口

仓库文档对 macOS 12+ 的明确建议是：由于新版系统对 USB 栈做了改动，安装前务必先用 USBToolBox 等工具完成 USB 端口映射，否则安装过程可能遇到端口识别异常。

XhciPortLimit 失效导致启动循环

⚠️ 对 macOS 11.3 及更新版本，XhciPortLimit补丁已被证实失效，开启它会导致启动循环（boot loop）。如果你已经完成 USB 端口映射并禁用了XhciPortLimit，即可正常引导 macOS 11.3+；这也是仓库在多个安装文档中反复强调必须先做 USB 映射的原因。

Mavericks（10.9）只能走在线方法

mac-install-pkg.md 的离线方法覆盖 10.7、10.8、10.10–10.12，唯独不包含 10.9；如需 Mavericks，必须使用本文的在线恢复方法。

10.7–10.9 恢复启动的驱动要求

在后续配置 EFI 时请注意：opencore-efi.md 明确指出，要引导 OS X 10.7–10.9 的恢复分区，需要在Drivers中保留OpenPartitionDxe.efi（若使用 OpenDuet 的 legacy 用户则驱动已内置，无需重复添加）。

目标机的网络前提

由于恢复环境需要再次联网下载完整系统，目标机器必须具备一块 macOS 支持的网卡（有线或可驱动的无线网卡），并保证安装全程网络畅通。

下一步：接入 OpenCore EFI 环境

与离线安装器不同，在线恢复方法不需要执行createinstallmedia——mac-install.md 中明确提示，使用"Legacy macOS: Online Method"的用户可直接跳到 Setting up OpenCore's EFI environment。接下来你需要：

1. 挂载 U 盘上由 GPT 自动生成的EFI分区；
2. 从 OpenCorePkg 中取出EFI文件夹放到该分区根目录，并根据 opencore-efi.md 清理多余的 Drivers/Tools（OpenRuntime.efi必须保留，OpenShell.efi建议保留便于排错）；
3. 按 ktext.md 收集所需的 Kexts 与 ACPI 文件，填入对应目录；
4. 回到引导环境选择com.apple.recovery.boot启动项，即可进入恢复模式完成系统安装。

至此，一条覆盖 10.7 到最新版本的 OpenCore 恢复安装链路就完整打通了：macrecovery.py负责取镜像，FAT32 +com.apple.recovery.boot负责承载引导，OpenCore EFI 负责接管启动，三者的配合正是仓库中"在线安装器"方案的完整闭环。

• 文档
• 教程