用 Docker 运行 macOS：从零到可登录桌面的 5 个步骤-平芜编程栈

用 Docker 运行 macOS：从零到可登录桌面的 5 个步骤

【免费下载链接】macosMacOS inside a Docker container.项目地址: https://gitcode.com/GitHub_Trending/macos/macos

这个项目（仓库名macos）把 macOS 装进单个 Docker 容器，让没有苹果硬件的 Linux 机器也能用一条 Compose 命令拉起一台可远程操作的 mac，省去手工配虚拟机的折腾。

一句话讲清它能干什么

能：在 Linux 宿主上启动一个带 Web 控制台的 macOS 虚拟机，支持 USB 直通、宿主目录共享、多种网络模式。
能：借 KVM 拿到接近原生的性能，CPU、内存、磁盘大小都可用环境变量调。
不能：Docker Desktop（跨平台版）不暴露 KVM，跑不了；官方 EULA 也只允许在苹果硬件上安装。
不能：安装过程仍需你在恢复菜单里手动点选，并非装好即自动登录。

维度	传统 VM 方案	本项目（Docker 容器）
启动耗时	分钟级、需手动建 VM	秒级拉取、Compose 一键
磁盘占用	需预置大镜像	容器按需分配
远程访问	依赖外部 VNC 工具	内置 Web 控制台
镜像分发	手动拷 iso/vhd	`docker pull`一条命令

环境自检（跑之前先确认这 3 件事）

CPU 虚拟化开关：宿主需开启 VT-x 或 AMD-V，这是 KVM 加速的前置条件。grep -Ec '(vmx|svm)' /proc/cpuinfo输出大于 0 即支持。
内存下限：默认给虚拟机 4GB，宿主可用内存需 ≥ 4G。free -h看 Mem 的 available 列是否 ≥ 4Gi。
磁盘余量：磁盘镜像默认 64G，宿主需留足空间。df -h .剩余（avail）≥ 32G 才稳妥。

落地：从 0 到桌面可见

推荐用 Compose 部署，仓库已内置编排文件；docker run或 Kubernetes 方式详见 compose.yml 与 kubernetes.yml。

拉取与启动

这一步会看到容器起来、日志打印 QEMU 版本并开始下载恢复镜像。

git clone https://gitcode.com/GitHub_Trending/macos/macos cd macos docker compose up -d

首次登录（含默认凭据，标注安全风险提醒）

这一步会看到黑屏进度条，随后进入 macOS 恢复菜单。在「磁盘工具」把最大的 VirtIO 盘格式化为 APFS，点「重新安装 macOS」，到「创建电脑账户」界面自行设置用户名与密码。这里没有固定默认账号，凭据由你在安装界面创建。Web 端口默认无访问保护，切勿直接暴露到公网，需要时用PROTECT: "Y"开启鉴权。

通过浏览器 / VNC 访问桌面

这一步会在浏览器里看到可直接拖拽操作的 macOS 桌面。打开 http://127.0.0.1:8006 进入 Web 控制台；习惯 VNC 客户端的话，用映射出的 5900 端口连接即可。

它适合塞进哪些工作流

跨平台 CI 中的 macOS 构建节点

场景：iOS / macOS 应用需要在 Apple 环境里编译签名。收益：一条命令起干净节点，跑完即销毁，互不污染。落地提示：给容器挂独立 macvlan 网段，避免与宿主抢 IP。

教学 / 培训用的可重置沙箱

场景：课堂上要快速复制多台同配置系统。收益：改一下 Compose 即可多开，/storage目录决定能否重置。落地提示：保留./macos:/storage挂载，删掉目录即还原空白机。

个人开发机上的临时调试环境

场景：本机缺依赖，或想隔离做破坏性实验。收益：资源占用可控，出问题重启容器即可。落地提示：把RAM_SIZE、CPU_CORES先调小，装完稳定后再加。

底层为什么快：KVM 与容器隔离

分工是核心：KVM 负责把虚拟指令翻译给物理 CPU，拿到接近原生的计算性能；Docker 只把 QEMU、OpenCore 固件和初始化脚本打包成可分发单元，再用设备映射把宿主能力喂给虚拟机。 | 容器内进程 | 对应宿主机资源 | |---|---| | QEMU 虚拟机 |/dev/kvm硬件加速 | | 磁盘镜像（/storage） | 挂载目录./macos| | Web / VNC 服务 | 映射端口8006/5900|

踩坑清单（按出现频率排序）

首次拉取镜像慢 → 恢复镜像大、还要再下载 macOS 安装文件 → 保持耐心，或用镜像加速器。
启动即报 KVM 不可用 → 宿主没开 VT-x/AMD-V 或没映射/dev/kvm→ 进 BIOS 开虚拟化，确认 compose 里devices含/dev/kvm。
端口 8006 被占用 → 宿主已有进程监听 → 改成空闲端口，如8007:8006。
内存不足导致启动失败 →RAM_SIZE超过宿主可用内存 → 先设 4G 以内，装完再提。
AMD 多核或大内存时卡死 → AMD 对多核 / >8G 安装不稳定 → 单核 4G 装完，稳定后再逐步加。