OSX-KVM - Linux上构建macOS虚拟环境的开源工具

注意

本README.md文档记录了创建虚拟黑苹果系统的过程。

注意：本仓库中包含的所有二进制文件和资源都是可重新生成的（包含了所有指令！）。

:green_heart: 需要这方面的商业支持吗？我可以通过电子邮件进行仅限商业支持选项的交流。注意：项目赞助者可以访问Private OSX-KVM仓库，并获得直接支持。

在内容缓存方面遇到困难？我们可以提供帮助。

使用Proxmox和macOS？务必查看Nick的博客。

是的，我们现在支持离线macOS安装 - 请参阅此文档 🎉

回馈贡献

本项目始终需要您的帮助、时间和关注。我正在寻求以下工作项目的帮助（欢迎提交拉取请求！）：

关于在流行云提供商（Hetzner、GCP、AWS）上运行macOS的文档。请参阅这是否合法？部分及相关参考。
记录（分享）您如何使用本项目构建+测试开源项目/完成工作。
记录如何使用本项目进行XNU内核调试和开发。
记录启动一批无头macOS虚拟机（构建农场）的过程。
记录使用munki向此类构建农场部署软件的方法。
默认启用或简化VNC + SSH支持。
欢迎改进稳定性！
（不那么）疯狂的想法 - 通过OpenCV自动化macOS安装。

要求

现代Linux发行版。例如Ubuntu 24.04 LTS 64位或更高版本。
QEMU >= 8.2.2
需要支持Intel VT-x / AMD SVM的CPU（grep -e vmx -e svm /proc/cpuinfo）
= macOS Sierra需要支持SSE4.1的CPU
= macOS Ventura需要支持AVX2的CPU

注意：已知较旧的AMD CPU存在问题，但现代AMD Ryzen处理器运行良好（甚至适用于macOS Sonoma）。

安装准备

安装QEMU和其他软件包。

sudo apt-get install qemu-system uml-utilities virt-manager git \
    wget libguestfs-tools p7zip-full make dmg2img tesseract-ocr \
    tesseract-ocr-eng genisoimage vim net-tools screen -y

此步骤可能需要针对您的Linux发行版进行调整。

在QEMU系统上克隆此仓库。后续步骤将使用此仓库中的文件。
```
cd ~

git clone --depth 1 --recursive https://github.com/kholia/OSX-KVM.git

cd OSX-KVM
```
可以通过以下命令拉取仓库更新：
```
git pull --rebase
```
本仓库大量使用基于rebase的工作流。

KVM可能需要在主机上进行以下调整才能工作。

sudo modprobe kvm; echo 1 | sudo tee /sys/module/kvm/parameters/ignore_msrs

要使此更改永久生效，可以使用以下命令。

sudo cp kvm.conf /etc/modprobe.d/kvm.conf  # 仅适用于intel设备

sudo cp kvm_amd.conf /etc/modprobe.d/kvm.conf  # 仅适用于amd设备

将用户添加到kvm和libvirt组（可能需要）。
```
sudo usermod -aG kvm $(whoami)
sudo usermod -aG libvirt $(whoami)
sudo usermod -aG input $(whoami)
```
注意：执行此命令后需要重新登录。
获取macOS安装程序。
```
./fetch-macOS-v2.py
```
您可以在此选择所需的macOS版本。执行此步骤后，当前文件夹中应该有BaseSystem.dmg文件。

注意：如果进展缓慢，请让>= Big Sur设置停留在国家选择屏幕和其他类似位置一段时间。初始macOS设置向导最终会成功。

示例运行：
```
$ ./fetch-macOS-v2.py
1. High Sierra (10.13)
2. Mojave (10.14)
3. Catalina (10.15)
4. Big Sur (11.7)
5. Monterey (12.6)
6. Ventura (13) - 推荐
7. Sonoma (14)

选择要下载的产品 (1-7): 6
```
注意：现代NVIDIA GPU在HighSierra上受支持，但在macOS的后续版本中不受支持。
将下载的BaseSystem.dmg文件转换为BaseSystem.img文件。
```
dmg2img -i BaseSystem.dmg BaseSystem.img
```
创建一个虚拟硬盘镜像，用于安装macOS。如果您将磁盘镜像名称从mac_hdd_ng.img更改为其他名称，则需要更新引导脚本以指向新的镜像名称。
```
qemu-img create -f qcow2 mac_hdd_ng.img 256G
```
注意：为获得最佳结果，请在快速SSD/NVMe磁盘上创建此HDD镜像文件。
现在您已准备好安装macOS 🚀

安装

CLI方法（主要）。只需运行OpenCore-Boot.sh脚本即可开始安装过程。
```
./OpenCore-Boot.sh
```
注意：此脚本适用于所有最新的macOS版本。
使用macOS安装程序中的磁盘工具对连接到macOS虚拟机的虚拟磁盘进行分区和格式化。对于现代macOS版本，使用APFS（默认）。
继续安装macOS 🙌
（可选）使用libvirt（virt-manager / virsh工具）使用此macOS虚拟机磁盘。
- 编辑macOS-libvirt-Catalina.xml文件并更改各种文件路径（在该文件中搜索CHANGEME字符串）。通常以下命令就能解决问题。
```
sed "s/CHANGEME/$USER/g" macOS-libvirt-Catalina.xml > macOS.xml

virt-xml-validate macOS.xml
```
- 通过运行以下命令创建虚拟机。
```
virsh --connect qemu:///system define macOS.xml
```

如果需要，为libvirt-qemu用户授予必要的权限,

sudo setfacl -m u:libvirt-qemu:rx /home/$USER
sudo setfacl -R -m u:libvirt-qemu:rx /home/$USER/OSX-KVM

启动 virt-manager 并启动 macOS 虚拟机。

无界面的macOS

使用提供的 boot-macOS-headless.sh 脚本。
```
./boot-macOS-headless.sh
```

设定正确的期望

恭喜你成功搭建了 虚拟黑苹果 系统!这样的系统可以用于各种目的(例如软件构建、测试、逆向工程),再加上本仓库中记录的一些调整,它可能就是你所需要的全部。

然而,这样的系统缺乏图形加速、可靠的声音子系统、USB 3功能和其他类似的功能。要启用这些功能,请查看我们的说明。我们希望在这个领域恢复我们的测试和文档工作。如果你能为这项工作提供资金支持,请联系我们。

获得"超越原生苹果硬件"的性能是可能的,但这需要付出努力、保持耐心,也许还需要一点运气。

安装后

查看网络说明,了解如何在虚拟机中设置网络,包括出站和入站,以便通过SSH、VNC等远程访问你的虚拟机。
要直通GPU和其他设备,请参阅这些说明。
需要不同的分辨率?查看本仓库中包含的说明。
iMessage出现问题?查看本仓库中包含的说明。
强烈推荐的macOS优化 - https://github.com/sickcodes/osx-optimizer

这合法吗?

"秘密"的Apple OSK字符串在互联网上广泛可用。它也包含在这里可以获得的公开法庭文件中。我不是律师,但似乎Apple试图将OSK字符串作为商业机密的尝试并未成功。由于这些原因,本仓库中自由包含了OSK字符串。

请查看Dortania的OpenCore安装指南中'黑苹果的合法性'文档部分。

Gabriel Somlo也对在QEMU/KVM下运行macOS涉及的法律方面有一些看法。

你可能还会对这篇'宣布适用于macOS的Amazon EC2 Mac实例'文章感兴趣。

注意:理解并接受(或不接受)Apple的EULA是你的责任。

注意:这不是法律建议,所以请自行做出适当的评估,如果你有任何顾虑,请与你的律师讨论(文字来源:Dortania)

动机

我的目标是以一种简单、可重复的方式,在不过度"投资"Apple封闭生态系统的情况下,实现基于macOS的教育任务、构建+测试、内核调试、逆向工程和macOS安全研究。

这些 虚拟黑苹果 系统并不是为了取代真正的物理macOS系统。

就我个人而言,这个仓库是我"退出"Apple生态系统的一种方式。它帮助我测试和比较了 Canon CanoScan LiDE 120 扫描仪和 Brother HL-2250DN 激光打印机的互操作性。现在这些设备在现代版本的Ubuntu上运行得相当不错(为自由软件欢呼)。此外,很久以前,我不得不完全擦除我当时全新的 MacBook Pro (Retina, 15-inch, Late 2013) 并在其上安装Xubuntu - 因为 OS X 内核在上面不断崩溃!

背景故事:在之前的生活中,我是加拿大的一名(贫穷)学生,Apple让我破解Apple钥匙串的工作变得比需要的更加困难。这就是我对黑苹果系统产生兴趣的原因。