docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e SHORTNAME=catalina \
    sickcodes/docker-osx:latest

# docker build -t docker-osx .

Big Sur (11)

docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e SHORTNAME=big-sur \
    sickcodes/docker-osx:latest

# docker build -t docker-osx .

Monterey (12)


docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e GENERATE_UNIQUE=true \
    -e MASTER_PLIST_URL='https://raw.githubusercontent.com/sickcodes/osx-serial-generator/master/config-custom.plist' \
    -e SHORTNAME=monterey \
    sickcodes/docker-osx:latest

# docker build -t docker-osx .

Ventura (13)


docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e GENERATE_UNIQUE=true \
    -e MASTER_PLIST_URL='https://raw.githubusercontent.com/sickcodes/osx-serial-generator/master/config-custom.plist' \
    -e SHORTNAME=ventura \
    sickcodes/docker-osx:latest

# docker build -t docker-osx .

Sonoma (14)


docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e GENERATE_UNIQUE=true \
    -e CPU='Haswell-noTSX' \
    -e CPUID_FLAGS='kvm=on,vendor=GenuineIntel,+invtsc,vmware-cpuid-freq=on' \
    -e MASTER_PLIST_URL='https://raw.githubusercontent.com/sickcodes/osx-serial-generator/master/config-custom-sonoma.plist' \
    -e SHORTNAME=sonoma \
    sickcodes/docker-osx:latest

# docker build -t docker-osx .

红杉 (15)


docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e GENERATE_UNIQUE=true \
    -e CPU='Haswell-noTSX' \
    -e CPUID_FLAGS='kvm=on,vendor=GenuineIntel,+invtsc,vmware-cpuid-freq=on' \
    -e MASTER_PLIST_URL='https://raw.githubusercontent.com/sickcodes/osx-serial-generator/master/config-custom-sonoma.plist' \
    -e SHORTNAME=sequoia \
    sickcodes/docker-osx:latest

# docker build -t docker-osx .

Tahoe (16)


docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e GENERATE_UNIQUE=true \
    -e CPU='Haswell-noTSX' \
    -e CPUID_FLAGS='kvm=on,vendor=GenuineIntel,+invtsc,vmware-cpuid-freq=on' \
    -e MASTER_PLIST_URL='https://raw.githubusercontent.com/sickcodes/osx-serial-generator/master/config-custom-sonoma.plist' \
    -e SHORTNAME=tahoe \
    sickcodes/docker-osx:latest

docker build -t docker-osx .

旧系统

High Sierra


docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e SHORTNAME=high-sierra \
    sickcodes/docker-osx:latest

# docker build -t docker-osx .

Mojave


docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e SHORTNAME=mojave \
    sickcodes/docker-osx:latest

# docker build -t docker-osx .

手动下载镜像并在 Docker 中使用

这是一种特别好的下载容器的方式，以防 Docker 的 CDN（或您的连接）恰好很慢。

wget https://images2.sick.codes/mac_hdd_ng_auto.img

docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v "${PWD}/mac_hdd_ng_auto.img:/image" \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e GENERATE_UNIQUE=true \
    -e MASTER_PLIST_URL=https://raw.githubusercontent.com/sickcodes/Docker-OSX/master/custom/config-nopicker-custom.plist \
    -e SHORTNAME=catalina \
    sickcodes/docker-osx:naked

共享目录、共享文件、共享文件夹、挂载文件夹

最简单且最安全的方式是 sshfs

# on Linux/Windows
mkdir ~/mnt/osx
sshfs user@localhost: -p 50922 ~/mnt/osx
# wait a few seconds, and ~/mnt/osx will have full rootfs mounted over ssh, and in userspace
# automated: sshpass -p <password> sshfs user@localhost:/ -p 50922 ~/mnt/osx

(VFIO) iPhone USB 直通 (VFIO)

如果您使用的是笔记本电脑，请参阅下一节 usbfluxd 部分。

如果您使用的是台式机，您可以使用 @Silfalion 的说明：https://github.com/Silfalion/Iphone_docker_osx_passthrough

(USBFLUXD) iPhone USB -> 网络式直通 OSX-KVM Docker-OSX

usbfluxd 的视频设置教程也可在此处获取：https://www.youtube.com/watch?v=kTk5fGjK_PM

此方法在笔记本电脑、PC 等任何设备上均可正常工作！

感谢 @nikias 通过 https://github.com/corellium 提供的 usbfluxd！

这是在 Linux 内部完成的。

在 Linux 上打开 3 个终端

在 Linux 上通过 USB 连接您的设备，允许您使用 https://github.com/corellium/usbfluxd 将 usbmuxd 暴露在端口 5000 上，供同一网络上的另一台系统使用。

确保已安装 usbmuxd、socat 和 usbfluxd。

sudo pacman -S libusbmuxd usbmuxd avahi socat

在 AUR 上可用：https://aur.archlinux.org/packages/usbfluxd/

yay usbfluxd

插入你的 iPhone 或 iPad。

Terminal 1

sudo systemctl start usbmuxd
sudo avahi-daemon

Terminal 2:

# on host
sudo systemctl restart usbmuxd
sudo socat tcp-listen:5000,fork unix-connect:/var/run/usbmuxd

Terminal 3:

sudo usbfluxd -f -n

连接到运行 usbfluxd 的主机

这是在 macOS 内部完成的。

安装 homebrew。

172.17.0.1 通常是 Docker 网桥 IP，即你的 PC，但你可以使用 ip addr 中的任何 IP...

macOS 终端：

# on the guest
brew install make automake autoconf libtool pkg-config gcc libimobiledevice usbmuxd

git clone https://github.com/corellium/usbfluxd.git
cd usbfluxd

./autogen.sh
make
sudo make install

接受 USB over TCP 连接，并显示为本地：

（你可能需要将 172.17.0.1 更改为主机的 IP 地址。例如，检查 ip addr）

# on the guest
sudo launchctl start usbmuxd
export PATH=/usr/local/sbin:${PATH}
sudo usbfluxd -f -r 172.17.0.1:5000

关闭 Xcode 等应用程序并重新打开，你的设备应该会显示出来！

如果你需要在 Linux 上重新开始，请清除当前的 usbfluxd、usbmuxd 和 socat：

sudo killall usbfluxd
sudo systemctl restart usbmuxd
sudo killall socat

使用 https://github.com/sickcodes/osx-optimizer 让容器更快

查看 https://github.com/sickcodes/osx-optimizer 中的命令！

跳过 GUI 登录屏幕（风险自负！）
在 macOS 上禁用 spotlight 索引，以大幅加快 Virtual Instances 的速度。
禁用沉重的登录屏幕壁纸
禁用更新（风险自负！）

通过将 /var/lib/docker 移动到外部驱动器、块存储、NFS 或任何其他可想象的位置来增加磁盘空间。

按照下面的教程移动 /var/lib/docker

使用服务器的磁盘或 SSD，而不是廉价的大容量物理磁盘存储。
块存储、NFS 等。

教程在此：https://sick.codes/how-to-run-docker-from-block-storage/

只有在你愿意清除当前所有 Docker 镜像/层的情况下，才遵循上述教程。

安全模式：暂时禁用 docker，以便你可以暂时移动 Docker 文件夹。

在你已经移出镜像之前，不要执行此操作 https://github.com/dulatello08/Docker-OSX/#quick-start-your-own-image-naked-container-image

killall dockerd
systemctl disable --now docker
systemctl disable --now docker.socket
systemctl stop docker
systemctl stop docker.socket

现在，Docker 守护进程已关闭，将 /var/lib/docker 移动到某个位置

然后，将 /var/lib/docker 符号链接到某个位置：

mv /var/lib/docker /run/media/user/some_drive/docker
ln -s /run/media/user/some_drive/docker /var/lib/docker

# now check if /var/lib/docker is working still
ls /var/lib/docker

如果你看到文件夹，则说明成功了。你可以重启 Docker，或者如果你想确保万无一失，可以直接重启系统。

重要通知：

2021-11-14 - 添加了 High Sierra、Mojave

在构建时选择以下其中一项，使用 docker pull 时无关紧要：

--build-arg SHORTNAME=high-sierra 
--build-arg SHORTNAME=mojave
--build-arg SHORTNAME=catalina
--build-arg SHORTNAME=big-sur
--build-arg SHORTNAME=monterey
--build-arg SHORTNAME=ventura
--build-arg SHORTNAME=sonoma

技术细节

目前存在多个镜像，每个镜像都有不同的用途（详见下文）：

High Sierra (10.13)
Mojave (10.14)
Catalina (10.15)
Big Sur (11)
Monterey (12)
Ventura (13)
Sonoma (14)
Auto（预制的 Catalina）
Naked（使用您自己的 .img）
Naked-Auto（使用您自己的 .img 并通过 SSH 登录）

High Sierra：

Mojave：

Catalina:

Big Sur：

Monterey 制作你自己的镜像：

Ventura 制作你自己的镜像：

Sonoma 制作你自己的镜像：

预制的 Catalina 系统，由 Sick.Codes 提供：用户名：user，密码：alpine

Naked：自带镜像设置（先使用上述任意一种）：

裸车自动：与上述相同，但包含 -e USERNAME 和 -e PASSWORD 以及 -e OSX_COMMANDS="put your commands here"

功能

在 Linux 上使用 usbfluxd 通过 iPhone OSX KVM 运行!
在 Linux 上运行 macOS Monterey 虚拟机!
文件夹共享-
USB 直通（支持热插拔）
已启用 SSH (localhost:50922)
如果使用 ./vnc 版本，则已启用 VNC (localhost:8888)
通过序列号生成器! 进行 iMessage 安全研究
已启用 X11 转发
基于 QEMU + KVM 运行
支持 Big Sur、自定义镜像、Xvfb 无头模式
你可以使用 docker commit 克隆你的容器

要求

最低安装需要 20GB+++ 磁盘空间（如果使用 Xcode 则需要 50GB）
应在 BIOS 设置中启用虚拟化
一个支持 kvm 的 x86_64 主机
至少 50 GBs 用于 :auto（一半用于基础镜像，一半用于运行时镜像

待办事项

面向安全研究人员的文档
GPU 加速
对 virt-manager 的支持

Docker

基于本仓库内容构建的镜像也可在 Docker Hub 上获取，以便使用：https://hub.docker.com/r/sickcodes/docker-osx

可用 Docker 镜像及其预期用途的完整列表可在说明中找到。

Kubernetes

Docker-OSX 支持 Kubernetes。

Kubernetes Helm Chart 和文档可在 helm 目录下找到。

感谢 cephasara 贡献了这一重要贡献。

支持

小问题与故障

如果您在运行 Docker-OSX 时遇到小问题或有任何疑问，请随时提交 issue。

已解决的问题

不过，在提交 issue 之前，请先查看已关闭的 issue，并确认您正在使用本仓库的最新版本——您的问题可能已经得到解决！您也可以在下方此处的问答部分找到答案。

功能请求与更新

关注 @sickcodes！

专业支持

对于更复杂的需求，我们提供以下支持服务：

企业支持、商业支持或常规支持。
自定义镜像、自定义脚本、咨询（可按小时计费！）
与您或您的开发团队进行一对一交流。

如果您感兴趣，请联系 @sickcodes on Twitter 或点击此处。

许可证/贡献

Docker-OSX 采用 GPL v3+ 许可证。我们欢迎并非常感谢贡献。事实上，您被允许将 Docker-OSX 作为工具来创建专有软件。

其他基于 Docker/QEMU 的有趣项目

免责声明

如果你认真对待 Apple Security，并且有可能在 Apple Bug Bounty Program 中找到六位数的漏洞赏金，那么你来对地方了！更多说明：Hackintosh、OSX-KVM 或 Docker-OSX 合法吗？

本项目中提及的产品名称、徽标、品牌及其他商标均为其各自商标持有人的财产。这些商标持有人与我们的仓库没有任何关联。他们以任何方式都不赞助或认可本项目。

说明

容器镜像

已经设置好或只是想快速创建一个容器？请查看我们的快速入门，或参见我们容器创建示例部分中的更多用例。

有多种不同的 Docker-OSX 镜像可供选择，适用于不同的用途。

sickcodes/docker-osx:latest - 我只想试用一下。
sickcodes/docker-osx:latest - 我想使用 Docker-OSX 在 Xcode 中开发/保护应用（登录 Xcode、Transporter）
sickcodes/docker-osx:naked - 我想将 Docker-OSX 用于 CI/CD 相关目的（登录 Xcode、Transporter）

使用 :latest 或 big-sur 创建你的个人镜像。然后，从镜像中拉取该镜像。之后，你将能够复制该镜像并将其导入到 :naked 容器中，以便反复将容器恢复到之前的状态。

sickcodes/docker-osx:auto - 我只对使用命令行感兴趣（适用于编译软件或无头使用 Homebrew）。
sickcodes/docker-osx:naked - 我需要 iMessage/iCloud 用于安全研究。
sickcodes/docker-osx:big-sur - 我想运行 Big Sur。
sickcodes/docker-osx:monterey - 我想运行 Monterey。
sickcodes/docker-osx:ventura - 我想运行 Ventura。
sickcodes/docker-osx:sonoma - 我想运行 Sonoma。
sickcodes/docker-osx:high-sierra - 我想运行 High Sierra。
sickcodes/docker-osx:mojave - 我想运行 Mojave。

初始设置

在做其他任何事情之前，你需要在 BIOS 中开启硬件虚拟化。具体方法取决于你的特定机器（和 BIOS），但应该很简单。

然后，你需要在主机上安装 QEMU 和其他一些依赖项：

# ARCH
sudo pacman -S qemu libvirt dnsmasq virt-manager bridge-utils flex bison iptables-nft edk2-ovmf

# UBUNTU DEBIAN
sudo apt install qemu qemu-kvm libvirt-clients libvirt-daemon-system bridge-utils virt-manager libguestfs-tools

# CENTOS RHEL FEDORA
sudo yum install libvirt qemu-kvm

然后，启用 libvirt 并加载 KVM 内核模块：

sudo systemctl enable --now libvirtd
sudo systemctl enable --now virtlogd

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

sudo modprobe kvm

我想在 Windows 上运行 Docker-OSX

使用 WSL2（Windows 11 + Windows 子系统 Linux）可以在 Windows 上运行 Docker-OSX。

你必须安装 build 22000+（21H2 或更高版本）的 Windows 11。

首先，在管理员 powershell 中运行此命令在你的计算机上安装 WSL。更多信息，请查看这里。

这将默认安装 Ubuntu。

wsl --install

你可以使用 wsl -l -v 在 PowerShell 中确认 WSL2 已启用。要查看其他可用的发行版，请使用 wsl -l -o。

如果你之前安装过 WSL1，请升级到 WSL 2。检查此链接以从 WSL1 升级到 WSL2。

WSL 安装完成后，前往 C:/Users/<Your_Name>/.wslconfig 并在文件末尾添加 nestedVirtualization=true（如果文件不存在，请创建它）。有关 .wslconfig 文件的更多信息，请查看此链接。请确保在文件资源管理器选项中已选中“显示隐藏文件”和“显示文件扩展名”。结果应如下所示：

[wsl2]
nestedVirtualization=true

进入你的 WSL 发行版（在 powershell 中运行 wsl），并使用 kvm-ok 命令检查 KVM 是否已启用。输出应如下所示：

INFO: /dev/kvm exists
KVM acceleration can be used

如果尚未安装，请使用命令 sudo apt -y install bridge-utils cpu-checker libvirt-clients libvirt-daemon qemu qemu-kvm 进行安装。

现在，如果尚未安装，请下载并安装 Docker for Windows。

安装完成后，进入设置并勾选以下 2 个复选框：

General -> "Use the WSL2 based engine";
Resources -> WSL Integration -> "Enable integration with my default WSL distro",

确保已安装 x11-apps。如果未安装，请使用命令 sudo apt install x11-apps -y 进行安装。

最后，有 3 种方式获取视频输出：

WSLg：这是最简单且易于使用的选项。可能会出现一些问题，例如键盘未完全透传或在桌面上看到第二个鼠标 - WSLg 上的问题 - 但仍推荐此选项。

要使用 WSLg 内置的 X-11 服务器，请将 docker run 命令中的这两行更改为指向 WSLg 的 Docker-OSX。

-e "DISPLAY=${DISPLAY:-:0.0}" \
-v /mnt/wslg/.X11-unix:/tmp/.X11-unix \

或者尝试：

-e "DISPLAY=${DISPLAY:-:0}" \
-v /mnt/wslg/.X11-unix:/tmp/.X11-unix \

对于 Windows 上的 Ubuntu 20.x，请参阅 https://github.com/sickcodes/Docker-OSX/discussions/458

VNC: 请参阅 VNC 部分以获取更多信息。你也可以向 qemu 添加 -vnc 参数。通过 VNC 客户端连接到你的 mac 虚拟机。这里有一个操作指南
桌面环境: 这将为你提供完整的桌面 Linux 体验，但会占用计算机稍多的资源。这里有一个示例指南，但也有其他帮助设置桌面环境的指南。DE 示例

在创建你的容器时的额外启动说明

启动 macOS 基础系统（按 Enter 键）
点击 Disk Utility
擦除最大的磁盘（默认约为 200gb），切勿修改较小的磁盘。 -- 如果你无法点击 erase，你可能需要将磁盘大小减少 1kb
（可选）使用未使用的空间创建一个分区来容纳操作系统和你的文件，如果你想要限制容量。（对于 Xcode 12，分区至少需要 60gb。）
点击 Reinstall macOS
系统在安装过程中可能需要多次重启

故障排除

常规检查

如果你在启动时遇到困难，这是一个很好的起点，尤其是如果你还不太熟悉 Docker。

只是想快速创建一个容器？查看我们的容器创建示例部分。

更具体/高级的故障排查问题和答案可在更多问题和答案中找到。您还应该查看已关闭的问题。即使您无法在此文档中找到，其他人可能已经得到了类似您问题的解答！

确认您的 CPU 支持虚拟化

参见初始设置。

Docker 未知服务器操作系统错误

docker: unknown server OS: .
See 'docker run --help'.

这意味着你的 docker 守护进程未运行。

pgrep dockerd 应返回空值

因此，你有几种选择。

sudo dockerd 用于前台运行 Docker。我使用此方式。

或者

sudo systemctl --start dockerd 用于立即启动 dockerd。

或者

sudo systemctl --enable --now dockerd 用于在每次重启时启动 dockerd，并立即启动。

使用更多 CPU 核心/SMP

示例：

-e EXTRA='-smp 6,sockets=3,cores=2'

-e EXTRA='-smp 8,sockets=4,cores=2'

-e EXTRA='-smp 16,sockets=8,cores=2'

注意，与内存不同，CPU 使用率是共享的。因此，你可以将所有 CPU 分配给容器。

确认你的用户属于 Docker 组、KVM 组、libvirt 组

将自己添加到 Docker 组

如果你使用 sudo dockerd 或 dockerd 由 systemd/systemctl 控制，则你必须属于 Docker 组。如果你不属于 Docker 组：

sudo usermod -aG docker "${USER}"

如有需要，也请将自己添加到 kvm 和 libvirt 组：

sudo usermod -aG libvirt "${USER}"
sudo usermod -aG kvm "${USER}"

另请参阅：初始设置。

Docker 守护进程是否已启用？

# run ad hoc
sudo dockerd

# or daemonize it
sudo nohup dockerd &

# enable it in systemd (it will persist across reboots this way)
sudo systemctl enable --now docker

# or just start it as your user with systemd instead of enabling it
systemctl start docker

与 Docker-OSX QEMU macOS 共享文件夹

与来宾系统共享文件夹非常简单。

您的文件夹将进入 Arch 容器内的 /mnt/hostshare，然后通过 QEMU 传递。

然后在 mac 内部使用 sudo -S mount_9p hostshare 进行挂载。

例如，

FOLDER=~/somefolder

    -v "${FOLDER}:/mnt/hostshare" \
    -e EXTRA="-virtfs local,path=/mnt/hostshare,mount_tag=hostshare,security_model=passthrough,id=hostshare" \

完整示例：

# stat mac_hdd_ng.img
SHARE=~/somefolder

docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -v "${PWD}/mac_hdd_ng.img:/home/arch/OSX-KVM/mac_hdd_ng.img" \
    -v "${SHARE}:/mnt/hostshare" \
    -e EXTRA="-virtfs local,path=/mnt/hostshare,mount_tag=hostshare,security_model=passthrough,id=hostshare" \
    sickcodes/docker-osx:latest

# !!! Open Terminal inside macOS and run the following command to mount the virtual file system
# sudo -S mount_9p hostshare

将 Linux NFS 驱动器共享到 macOS

要通过 NFS 共享文件夹，请在主机上设置一个文件夹，例如 /srv/nfs/share，然后将其追加到 /etc/exports：

/srv/nfs/share      127.0.0.1/0(insecure,rw,all_squash,anonuid=1000,anongid=985,no_subtree_check)

您可能需要现在重新加载导出，这将开始共享该目录。

# reload shared folders
sudo exportfs -arv

来源与说明

为 anonuid 和 anongid 授予共享文件夹的权限，其中 anonuid 和 anongid 需与您的 linux 用户相匹配；id -u

id -u ; id -g 将输出 userid:groupid

chown 1000:985 /srv/nfs/share
chmod u+rwx /srv/nfs/share

使用附加标志 --network host 启动 Docker-OSX 容器

在 mac 终端中创建并挂载 nfs 文件夹：

mkdir -p ~/mnt
sudo mount_nfs -o locallocks 10.0.2.2:/srv/nfs/share ~/mnt

通过 QEMU 将 USB 驱动器共享到 macOS

挂载 USB 驱动器（热插拔/热插 USB）

启动您的容器。

选择一个端口，例如，7700。

lsusb 以获取 vid:pid

在 Linux 上： sudo usbredirserver -p 7700 1e3d:2096

现在，在 Docker 窗口中按 Enter 键以查看 (qemu) 控制台。

即使机器已启动，您也可以使用如下命令添加/移除磁盘：

chardev-add socket,id=usbredirchardev1,port=7700,host=172.17.0.1

device_add usb-redir,chardev=usbredirchardev1,id=usbredirdev1,debug=4

在 macOS 启动时挂载 USB 驱动器到 Docker OSX

PORT=7700
IP_ADDRESS=172.17.0.1

-e EXTRA="-chardev socket,id=usbredirchardev1,port=${PORT},host=${IP_ADDRESS} -device usb-redir,chardev=usbredirchardev1,id=usbredirdev1,debug=4" \`

Fedora：通过桥接网络启用互联网连接

Fedora 的默认防火墙设置可能会阻止 Docker 的网络接口访问互联网。为了解决此问题，你需要在防火墙中将该接口加入白名单：

# Set the docker0 bridge to the trusted zone
sudo firewall-cmd --permanent --zone=trusted --add-interface=docker0
sudo firewall-cmd --reload

嵌套硬件虚拟化

检查您的机器是否已启用硬件虚拟化：

sudo tee /sys/module/kvm/parameters/ignore_msrs <<< 1

egrep -c '(svm|vmx)' /proc/cpuinfo

虚拟网络适配器

快速互联网连接

-e NETWORKING=vmxnet3

互联网连接缓慢

-e NETWORKING=e1000-82545em

CI/CD 相关改进

减小镜像大小的技巧

像往常一样启动容器，并删除不必要的文件。一种有用的方法是使用 du -sh * 从 / 目录开始，并查找可以删除文件的大目录。例如不必要的缓存文件、 Xcode 平台等。
一旦你对释放的空间量感到满意，使用 sudo trimforce enable 启用 trim，然后重启。
使用 dd if=/dev/zero of=./empty && rm -f empty 将磁盘上的空闲空间清零
关闭虚拟机并使用 docker cp stoppedcontainer:/home/arch/OSX-KVM/mac_hdd_ng.img . 复制出 qcow 镜像
运行 qemu-img check -r all mac_hdd_ng.img 以修复任何错误。
运行 qemu-img convert -O qcow2 mac_hdd_ng.img deduped.img 并再次检查错误
可选： 运行 qemu-img convert -c -O qcow2 deduped.img compressed.img 以进一步压缩镜像。这可能会降低运行时速度，但应将大小减少约 25%。
再次检查错误，并构建一个新的 docker 镜像。例如使用此 Dockerfile

FROM sickcodes/docker-osx
USER arch
COPY --chown=arch ./deduped.img /home/arch/OSX-KVM/mac_hdd_ng.img

使用 Telnet 无头运行 Docker-OSX

首先确保 autoboot 已启用

接下来，你需要设置 SSH 以自动启动。

sudo systemsetup -setremotelogin on

确保提交新的 docker 镜像并保存，或按照减少磁盘空间]一节中的说明重新构建。

然后使用以下参数运行它。

# Run with the -nographic flag, and enable a telnet interface
  docker run \
    --device /dev/kvm \
    -p 50922:10022 \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e EXTRA="-monitor telnet::45454,server,nowait -nographic -serial null" \
    mycustomimage

在本地构建 Docker-OSX 时，使用哪些镜像源是合适的？

如果你要在本地构建 Docker-OSX，你可能希望使用 Arch Linux 的镜像源。

镜像源位置可在此处找到（使用两位国家代码）：https://archlinux.org/mirrorlist/all/

docker build -t docker-osx:latest \
    --build-arg RANKMIRRORS=true \
    --build-arg MIRROR_COUNTRY=US \
    --build-arg MIRROR_COUNT=10 \
    --build-arg SHORTNAME=catalina \
    --build-arg SIZE=200G .

自定义 QEMU 参数（直通设备）

使用便捷的运行时参数提供程序选项 -e EXTRA=，将任意设备/目录传递给 Docker 容器及 QEMU 参数。

# example customizations
docker run \
    -e RAM=4 \
    -e SMP=4 \
    -e CORES=4 \
    -e EXTRA='-usb -device usb-host,hostbus=1,hostaddr=8' \
    -e INTERNAL_SSH_PORT=23 \
    -e MAC_ADDRESS="$(xxd -c1 -p -l 6 /dev/urandom | tr '\n' ':' | cut -c1-17)" \
    -e AUDIO_DRIVER=alsa \
    -e IMAGE_PATH=/image \
    -e SCREEN_SHARE_PORT=5900 \
    -e DISPLAY=:0 \
    -e NETWORKING=vmxnet3 \
    --device /dev/kvm \
    --device /dev/snd \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    docker-osx:latest

生成序列号

在 ./custom 中生成序列号，或者让 docker 在运行时生成它们（见下文）。

在任何时候，登录 iCloud 等之前，请验证您的序列号。

# this is a quick way to check your serial number via cli inside OSX
ioreg -l | grep IOPlatformSerialNumber

# test some commands
sshpass -p 'alpine' ssh user@localhost -p 50922 'ping google.com'

# check your serial number
sshpass -p 'alpine' ssh user@localhost -p 50922 'ioreg -l | grep IOPlatformSerialNumber'

开始使用序列号

# ARCH
pacman -S libguestfs

# UBUNTU DEBIAN
apt install libguestfs -y

# RHEL FEDORA CENTOS
yum install libguestfs -y

在 ./custom 文件夹中，您将找到 4 脚本。

config-nopicker-custom.plist
opencore-image-ng.sh

这两个文件来自 OSX-KVM。

你不需要修改这两个文件。

config.plist 中有 5 个值被替换为占位符。点击此处查看这些值，没有理由。

generate-unique-machine-values.sh 此脚本将生成序列号，附带 Mac 地址，并输出到 CSV/TSV，同时生成一个 bootdisk image。

你可以创建数百个，./custom/generate-unique-machine-values.sh --help

./custom/generate-unique-machine-values.sh \
    --count 1 \
    --tsv ./serial.tsv \
    --bootdisks \
    --output-bootdisk OpenCore.qcow2 \
    --output-env source.env.sh

或者，如果你有一些特定的序列号……

generate-specific-bootdisk.sh

generate-specific-bootdisk.sh \
    --model "${DEVICE_MODEL}" \
    --serial "${SERIAL}" \
    --board-serial "${BOARD_SERIAL}" \
    --uuid "${UUID}" \
    --mac-address "${MAC_ADDRESS}" \
    --output-bootdisk OpenCore-nopicker.qcow2

此示例在运行时以无头模式生成一组随机序列号

# proof of concept only, generates random serial numbers, headlessly, and quits right after.
docker run --rm -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -e NOPICKER=true \
    -e GENERATE_UNIQUE=true \
    -e DEVICE_MODEL="iMacPro1,1" \
    sickcodes/docker-osx:auto

# -e OSX_COMMANDS='ioreg -l | grep IOPlatformSerialNumber' \

此示例在运行时生成一组特定的序列号

# run the same as above 17gb auto image, with SSH, with nopicker, and save the bootdisk for later.
# you don't need to save the bootdisk IF you supply specific serial numbers!

docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -e NOPICKER=true \
    -e GENERATE_SPECIFIC=true \
    -e DEVICE_MODEL="iMacPro1,1" \
    -e SERIAL="C02TW0WAHX87" \
    -e BOARD_SERIAL="C027251024NJG36UE" \
    -e UUID="5CCB366D-9118-4C61-A00A-E5BAF3BED451" \
    -e MAC_ADDRESS="A8:5C:2C:9A:46:2F" \
    -e OSX_COMMANDS='ioreg -l | grep IOPlatformSerialNumber' \
    sickcodes/docker-osx:auto

此示例在运行时使用您现有的图像，以 1000x1000 显示分辨率生成一组特定的序列号

# run an existing image in current directory, with a screen, with SSH, with nopicker.

stat mac_hdd_ng.img # make sure you have an image if you're using :naked

docker run -it \
    -v "${PWD}/mac_hdd_ng.img:/image" \
    --device /dev/kvm \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -p 50922:10022 \
    -e NOPICKER=true \
    -e GENERATE_SPECIFIC=true \
    -e DEVICE_MODEL="iMacPro1,1" \
    -e SERIAL="C02TW0WAHX87" \
    -e BOARD_SERIAL="C027251024NJG36UE" \
    -e UUID="5CCB366D-9118-4C61-A00A-E5BAF3BED451" \
    -e MAC_ADDRESS="A8:5C:2C:9A:46:2F" \
    -e WIDTH=1000 \
    -e HEIGHT=1000 \
    sickcodes/docker-osx:naked

如果你想生成序列号，可以在运行时使用 -e GENERATE_UNIQUE=true \

或者你可以在 ./custom 文件夹中生成它们。然后使用：

    -e GENERATE_SPECIFIC=true \
    -e SERIAL="" \
    -e BOARD_SERIAL="" \
    -e UUID="" \
    -e MAC_ADDRESS="" \

使序列号在重启后持久化


stat mac_hdd_ng_testing.img
touch ./output.env

# generate fresh random serial numbers, with a screen, using your own image, and save env file with your new serial numbers for later.

docker run -it \
    --device /dev/kvm \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -p 50922:10022 \
    -e NOPICKER=true \
    -e GENERATE_UNIQUE=true \
    -e GENERATE_SPECIFIC=true \
    -e DEVICE_MODEL="iMacPro1,1" \
    -v "${PWD}/output.env:/env" \
    -v "${PWD}/mac_hdd_ng_testing.img:/image" \
    sickcodes/docker-osx:naked

要使用 iMessage 或 iCloud，您需要更改 5 值。

SERIAL
BOARD_SERIAL
UUID
MAC_ADDRESS

ROM 只是小写的 mac 地址，每个单词之间没有 :。

你可以让容器为你生成它们，使用 -e GENERATE_UNIQUE=true

或者让容器使用特定的值，使用 -e GENERATE_SPECIFIC=true

    -e GENERATE_SPECIFIC=true \
    -e DEVICE_MODEL="iMacPro1,1" \
    -e SERIAL="C02TW0WAHX87" \
    -e BOARD_SERIAL="C027251024NJG36UE" \
    -e UUID="5CCB366D-9118-4C61-A00A-E5BAF3BED451" \
    -e MAC_ADDRESS="A8:5C:2C:9A:46:2F" \

更改显示分辨率

显示分辨率由以下行控制：

https://github.com/sickcodes/Docker-OSX/blob/master/custom/config-nopicker-custom.plist#L819

Docker-OSX 不会挂载该磁盘，而是使用这个巧妙的技巧生成一个新的 OpenCore.qcow2：

-e GENERATE_UNIQUE=true \
-e WIDTH=800 \
-e HEIGHT=600 \

要使用 WIDTH/HEIGHT，必须与 -e GENERATE_UNIQUE=true 或 -e GENERATE_SPECIFIC=true 一起使用。

由于需要使用 libguestfs 创建新的启动分区，启动时间将延长约 30 秒。

-e GENERATE_SPECIFIC=true \
-e WIDTH=1920 \
-e HEIGHT=1080 \
-e SERIAL="" \
-e BOARD_SERIAL="" \
-e UUID="" \
-e MAC_ADDRESS="" \

更改 Docker-OSX 分辨率示例

# using an image in your current directory
stat mac_hdd_ng.img

docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v "${PWD}/mac_hdd_ng.img:/image" \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e GENERATE_SPECIFIC=true \
    -e DEVICE_MODEL="iMacPro1,1" \
    -e SERIAL="C02TW0WAHX87" \
    -e BOARD_SERIAL="C027251024NJG36UE" \
    -e UUID="5CCB366D-9118-4C61-A00A-E5BAF3BED451" \
    -e MAC_ADDRESS="A8:5C:2C:9A:46:2F" \
    -e MASTER_PLIST_URL=https://raw.githubusercontent.com/sickcodes/Docker-OSX/master/custom/config-nopicker-custom.plist \
    -e WIDTH=1600 \
    -e HEIGHT=900 \
    sickcodes/docker-osx:naked

# generating random serial numbers, using the DIY installer, along with the screen resolution changes.
docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e GENERATE_UNIQUE=true \
    -e WIDTH=800 \
    -e HEIGHT=600 \
    sickcodes/docker-osx:latest

这里还有几种其他分辨率！如果你的分辨率无效，它将默认为 800x600。

    -e WIDTH=800 \
    -e HEIGHT=600 \

    -e WIDTH=1280 \
    -e HEIGHT=768 \

    -e WIDTH=1600 \
    -e HEIGHT=900 \

    -e WIDTH=1920 \
    -e HEIGHT=1080 \

    -e WIDTH=2560 \
    -e HEIGHT=1600 \

本示例展示了如何在容器创建后更改分辨率。

第一步是停止 docker 守护进程

sudo systemctl stop docker

第二步是修改容器配置

/var/lib/docker/containers/[container-id]/config.v2.json

（假设你原始的 WIDTH 为 1024，HEIGHT 为 768，你可以搜索 1024 并将其替换为新值。768 同理。）

最后一步是重启 docker 守护进程

sudo systemctl restart docker

在 Mac OSX 中挂载物理磁盘

将磁盘作为卷传入容器，然后再次将磁盘传入 QEMU 命令行附加参数中。

使用 config-custom.plist，因为你可能希望看到启动菜单，否则省略第一行：

DISK_TWO="${PWD}/mount_me.img"

-e MASTER_PLIST_URL='https://raw.githubusercontent.com/sickcodes/osx-serial-generator/master/config-custom.plist' \
-v "${DISK_TWO}:/disktwo" \
-e EXTRA='-device ide-hd,bus=sata.5,drive=DISK-TWO -drive id=DISK-TWO,if=none,file=/disktwo,format=qcow2' \

物理磁盘挂载示例

OSX_IMAGE="${PWD}/mac_hdd_ng_xcode_bigsur.img"
DISK_TWO="${PWD}/mount_me.img"

docker run -it \
    --device /dev/kvm \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e MASTER_PLIST_URL='https://raw.githubusercontent.com/sickcodes/osx-serial-generator/master/config-custom.plist' \
    -v "${OSX_IMAGE}":/image \
    -v "${DISK_TWO}":/disktwo \
    -e EXTRA='-device ide-hd,bus=sata.5,drive=DISK-TWO -drive id=DISK-TWO,if=none,file=/disktwo,format=qcow2' \
    sickcodes/docker-osx:naked

另请参阅：此处。

在 Linux 上提取 APFS 磁盘

在 Docker-OSX 中，我们使用的是 qcow2 镜像。

这意味着镜像会随着你的使用而增长，但客户机操作系统认为你有 200GB 可用空间。

只读

# mount the qemu image like a real disk
sudo modprobe nbd max_part=8
sudo qemu-nbd --connect=/dev/nbd0 ./image.img
sudo fdisk /dev/nbd0 -l

mkdir -p ./mnt
sudo mount /dev/nbd0p1 ./mnt

# inspect partitions (2 partitions)
sudo fdisk /dev/nbd0 -l

# mount using apfs-linux-rw OR apfs-fuse
mkdir -p ./part

sudo mount /dev/nbd0p2 ./part
sudo apfs-fuse -o allow_other /dev/nbd0p2 ./part

当您完成对磁盘的检查后，可以卸载分区、磁盘并移除回环设备：

sudo umount ./part
sudo umount ./mnt
sudo qemu-nbd --disconnect /dev/nbd0
sudo rmmod nbd

USB 直通

首先，QEMU 必须以 root 身份启动。

通过更改容器内设备的权限，也有可能实现 USB 直通。参见此处。

例如，使用以下内容创建一个新的 Dockerfile

FROM sickcodes/docker-osx
USER arch
RUN sed -i -e s/exec\ qemu/exec\ sudo\ qemu/ ./Launch.sh
COPY --chown=arch ./new_image.img /home/arch/OSX-KVM/mac_hdd_ng.img

其中 new_image.img 是您提取的 qcow2 镜像。然后使用 docker build . 进行重建

接下来，我们需要找出要传递给虚拟机的 USB 设备的总线和端口号：

lsusb -t
/:  Bus 02.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/6p, 5000M
/:  Bus 01.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/12p, 480M
    |__ Port 2: Dev 5, If 0, Class=Human Interface Device, Driver=usbhid, 12M
    |__ Port 2: Dev 5, If 1, Class=Chip/SmartCard, Driver=, 12M
    |__ Port 3: Dev 2, If 0, Class=Wireless, Driver=, 12M
    |__ Port 3: Dev 2, If 1, Class=Wireless, Driver=, 12M
    |__ Port 5: Dev 3, If 0, Class=Video, Driver=uvcvideo, 480M
    |__ Port 5: Dev 3, If 1, Class=Video, Driver=uvcvideo, 480M

在本示例中，我们想要透传一个智能卡设备。我们想要的设备位于总线 1 和端口 2。

如果你的设备是 usb 2.0 (ehci) 与 usb 3.0 (xhci)，也可能存在差异。参见此处以获取更多详细信息。

# hostbus and hostport correspond to the numbers from lsusb
# runs in privileged mode to enable access to the usb devices.
docker run \
  --privileged \
  --device /dev/kvm \
  -e RAM=4 \
  -p 50922:10022 \
  -e "DISPLAY=${DISPLAY:-:0.0}" \
  -e EXTRA="-device virtio-serial-pci -device usb-host,hostbus=1,hostport=2" \
  mycustomimage

在 MacOS shell 中执行 system_profiler SPUSBDataType 时，你应该能看到设备出现。

重要提示：在虚拟机运行期间，这将导致主机系统失去对该 USB 设备的访问权限！

容器创建示例

快速启动你自己的镜像（裸容器镜像）

这是我最喜欢的容器。你可以提供一个现有的磁盘镜像作为 Docker 命令行参数。

使用 sudo find /var/lib/docker -name mac_hdd_ng.img -size +10G 拉取镜像
使用命令参数 -v "${PWD}/mac_hdd_ng.img:/image" 提供你自己的本地镜像，并在指示 Docker 创建容器时使用 sickcodes/docker-osx:naked。
- 裸镜像用于启动任何现有的 .img 文件，例如当前工作目录中的文件（$PWD）
- 默认情况下，此镜像有一个名为 NOPICKER 的变量，其值为 "true"。这会跳过磁盘选择菜单。使用 -e NOPICKER=false 或除单词 true 以外的任何字符串来进入启动菜单。
  
  这允许你使用其他磁盘，而不是跳过启动菜单，例如恢复磁盘或磁盘工具。

docker pull sickcodes/docker-osx:naked

# run your own image + SSH
# change mac_hdd_ng.img
docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v "${PWD}/mac_hdd_ng.img:/image" \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    sickcodes/docker-osx:naked

# run local copy of the auto image + SSH + Boot menu
docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v "${PWD}/mac_hdd_ng_auto.img:/image" \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e "NOPICKER=false" \
    sickcodes/docker-osx:naked

构建具有视频输出的 OSX 容器

快速入门命令应开箱即用，前提是您保留以下行。适用于 auto 和 naked 机器：

    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \

带有任意命令行参数的预构建镜像

-e OSX_COMMANDS 允许你在容器内运行任何命令

docker pull sickcodes/docker-osx:auto

# boot to OS X shell + display + specify commands to run inside OS X!
docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e "OSX_COMMANDS=/bin/bash -c \"put your commands here\"" \
    sickcodes/docker-osx:auto

# Boots in a minute or two!

或者，如果你已经拥有一张图片，并且只想登录并执行任意命令：

docker pull sickcodes/docker-osx:naked-auto

# boot to OS X shell + display + specify commands to run inside OS X!
docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e USERNAME=yourusername \
    -e PASSWORD=yourpassword \
    -e "OSX_COMMANDS=/bin/bash -c \"put your commands here\"" \
    sickcodes/docker-osx:naked-auto

# Boots in a minute or two!

构建无头 OSX 容器

对于无头容器，请从您的 docker run 命令中删除以下两行：

    # -v /tmp/.X11-unix:/tmp/.X11-unix \
    # -e "DISPLAY=${DISPLAY:-:0.0}" \

从自定义镜像构建无头容器

这对于 CI/CD 流水线尤其有帮助。

# run your own image headless + SSH
docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    -v "${PWD}/mac_hdd_ng.img:/image" \
    sickcodes/docker-osx:naked

构建一个允许在 localhost 上使用不安全 VNC 的无头容器（！仅限本地使用！）

必须将 -it 更改为 -i，才能与 QEMU 控制台进行交互

要退出使用 -i 的容器，你必须 docker kill <containerid>。例如，要终止所有进程，docker ps | xargs docker kill。

原生 QEMU VNC 示例

docker run -i \
    --device /dev/kvm \
    -p 50922:10022 \
    -p 5999:5999 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e EXTRA="-display none -vnc 0.0.0.0:99,password=on" \
    sickcodes/docker-osx:big-sur

# type `change vnc password myvncusername` into the docker terminal and set a password
# connect to localhost:5999 using VNC
# qemu 6 seems to require a username for vnc now

完全没有使用 TLS/HTTPS 加密！

或者 ssh -N root@1.1.1.1 -L 5999:127.0.0.1:5999，其中 1.1.1.1 是你的远程服务器 IP。

（注意：如果你关闭端口 5999 并使用 SSH 隧道，这就变得安全了。）

构建一个无头容器以通过安全 VNC 远程运行

添加以下行：

-e EXTRA="-display none -vnc 0.0.0.0:99,password=on"

在 Docker 终端中，按 enter 直到看到 (qemu)。

输入 change vnc password someusername

为你的新 vnc 用户名^ 设置一个密码。

你还需要容器 IP：docker inspect <containerid> | jq -r '.[0].NetworkSettings.IPAddress'

或者 ip n 通常会首先显示容器 IP。

现在 VNC 使用 Docker 容器 IP 进行连接，例如 172.17.0.2:5999

通过 SSH 进行远程 VNC：ssh -N root@1.1.1.1 -L 5999:172.17.0.2:5999，其中 1.1.1.1 是你的远程服务器 IP，172.17.0.2 是你的局域网容器 IP。

现在你可以直接通过 VNC 连接到任何使用此命令构建的容器！

我想使用 SPICE 而不是 VNC

可选地，你可以启用 SPICE 协议，它允许使用 remote-viewer 访问你的 OSX 容器，而不是 VNC。

注意：-disable-ticketing 将允许未经身份验证的访问 VM。请参阅 spice 手册以获取设置身份验证访问（“Ticketing”）的帮助。

  docker run \
    --device /dev/kvm \
    -p 3001:3001 \
    -p 50922:10022 \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    -e EXTRA="-monitor telnet::45454,server,nowait -nographic -serial null -spice disable-ticketing,port=3001" \
    mycustomimage

然后只需执行 remote-viewer spice://localhost:3001 并添加 --spice-debug 用于调试。

基于已配置和设置好的容器创建镜像

# You can create an image of an already configured and setup container.
# This allows you to effectively duplicate a system.
# To do this, run the following commands

# make note of your container id
docker ps --all
docker commit containerid newImageName

# To run this image do the following
docker run \
    --device /dev/kvm \
    --device /dev/snd \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    newImageName

docker pull sickcodes/docker-osx:auto

# boot directly into a real OS X shell with no display (Xvfb) [HEADLESS]
docker run -it \
    --device /dev/kvm \
    -p 50922:10022 \
    sickcodes/docker-osx:auto

# username is user
# password is alpine
# Wait 2-3 minutes until you drop into the shell.

运行 Docker-OSX 的原始版本


docker pull sickcodes/docker-osx:latest

docker run -it \
    --device /dev/kvm \
    --device /dev/snd \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    sickcodes/docker-osx:latest

# press CTRL + G if your mouse gets stuck
# scroll down to troubleshooting if you have problems
# need more RAM and SSH on localhost -p 50922?

运行但在 OS X 中启用 SSH（原始版本）！

docker run -it \
    --device /dev/kvm \
    --device /dev/snd \
    -p 50922:10022 \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -e "DISPLAY=${DISPLAY:-:0.0}" \
    sickcodes/docker-osx:latest

# turn on SSH after you've installed OS X in the "Sharing" settings.
ssh user@localhost -p 50922

安装完所有内容后自动启动 OS X

添加额外选项 -e NOPICKER=true。

旧机器：

# find your containerID
docker ps

# move the no picker script on top of the Launch script
# NEW CONTAINERS
docker exec containerID mv ./Launch-nopicker.sh ./Launch.sh

# VNC-VERSION-CONTAINER
docker exec containerID mv ./Launch-nopicker.sh ./Launch_custom.sh

# LEGACY CONTAINERS
docker exec containerID bash -c "grep -v InstallMedia ./Launch.sh > ./Launch-nopicker.sh
chmod +x ./Launch-nopicker.sh
sed -i -e s/OpenCore\.qcow2/OpenCore\-nopicker\.qcow2/ ./Launch-nopicker.sh
"

安装后 big-sur 镜像启动缓慢。这是预期行为吗？

容器设置中的自动更新仍处于开启状态。您可能希望将其关闭。我们对此有未来的开发计划。

什么是 `${DISPLAY:-:0.0}`？

$DISPLAY 是指向您的 X11 显示服务器的 shell 变量。

${DISPLAY} 的作用相同，但允许您像这样连接变量：

例如，${DISPLAY}_${DISPLAY} 会打印 :0.0_:0.0
例如，$DISPLAY_$DISPLAY 会打印 :0.0

...因为 $DISPLAY_ 不是 $DISPLAY

${variable:-fallback} 允许您设置一个“回退”变量，当 $variable 未设置时进行替换。

您还可以使用 ${variable:=fallback} 来设置该变量（在您当前的终端中）。

在 Docker-OSX 中，我们假设 :0.0 是您的默认 $DISPLAY 变量。

您可以查看您的

echo $DISPLAY

这样，${DISPLAY:-:0.0} 将使用你的 X11 服务器为你设置的任何变量，否则 :0.0

什么是 `-v /tmp/.X11-unix:/tmp/.X11-unix`？

-v 是一个 Docker 命令行选项，允许你将一个卷传递给容器。

我们让 Docker 容器使用的目录是一个 X 服务器显示套接字。

/tmp/.X11-unix

如果我们让 Docker 容器使用与我们自身环境相同的显示套接字，那么在 Docker 容器内运行的任何应用程序也会显示在你的屏幕上！https://www.x.org/archive/X11R6.8.0/doc/RELNOTES5.html

启动或创建容器时出现 ALSA 错误

在初始化或启动进入容器时，你可能会在 (qemu) 控制台中看到如下形式的错误： ALSA lib blahblahblah: (function name) returned error: no such file or directory。这些错误或多或少是预期之中的。只要你能启动进入容器且一切运行正常，就没有理由为此担心。