在 Devin 中试用 DeepWiki 处理私有仓库
DeepWiki

sickcodes/Docker-OSX

菜单

安装与基本使用

相关源文件

本页面提供了安装 Docker-OSX 和开始基本用法的详细说明。它涵盖了先决条件、安装方法、运行容器以及初始设置步骤。有关不同镜像变体及其特定用途的信息，请参阅 镜像变体。有关高级配置选项，请参阅 配置与自定义。

安装工作流程

下图说明了完整的 Docker-OSX 安装和设置过程

来源： README.md589-614 README.md25-29

先决条件

硬件要求

  • x86_64 系统，支持硬件虚拟化
  • 至少 20GB 可用磁盘空间（建议 Xcode 使用 50GB）
  • 最低 4GB RAM（推荐 8GB+）

主机系统配置

首先，在您的 BIOS/UEFI 设置中启用虚拟化。具体操作因主板制造商而异，但通常涉及启用标记为“Virtualization Technology”、“VT-x”、“AMD-V”或类似的选项。

然后，根据您的 Linux 发行版安装必要的软件包

发行版安装命令
Arch Linuxsudo pacman -S qemu libvirt dnsmasq virt-manager bridge-utils flex bison iptables-nft edk2-ovmf
Ubuntu/Debiansudo apt install qemu qemu-kvm libvirt-clients libvirt-daemon-system bridge-utils virt-manager libguestfs-tools
CentOS/RHEL/Fedorasudo yum install libvirt qemu-kvm

启用 libvirt 并加载 KVM 内核模块

确保您的用户属于所需的组

来源： README.md589-614 README.md749-766

安装方法

Docker-OSX 可以通过从 Docker Hub 拉取预构建的镜像或从源代码构建来安装。

此方法从 Docker Hub 下载预构建的镜像

方法二：从源代码构建

此方法从源代码构建 Docker-OSX

来源： README.md25-29 Dockerfile25-27

系统架构

下图说明了 Docker-OSX 组件的交互方式

来源： Dockerfile194-217 README.md427-442

基本用法

运行默认配置的 Docker-OSX

以下命令以默认设置启动 Docker-OSX

Docker Run 命令结构

下图说明了 Docker run 命令的结构及其关键参数

来源： Dockerfile283-334 README.md1194-1217

运行特定 macOS 版本

Docker-OSX 通过 SHORTNAME 环境变量支持各种 macOS 版本

Catalina (10.15)

Big Sur (11)

Monterey (12)

Ventura (13)

Sonoma (14)

来源： README.md60-156

使用您自己的磁盘映像

要在 Docker-OSX 中使用您自己的磁盘映像

您也可以下载一个预制映像并使用它

来源： README.md211-231 README.md1636-1662

首次设置

首次运行 Docker-OSX 时，您需要完成 macOS 的安装

  1. 启动到 macOS 基础系统（在提示时按 Enter）
  2. 系统加载后，从实用工具菜单中打开“磁盘工具”
  3. 抹掉最大的磁盘（默认大约 200GB）
    • 如果无法点击“抹掉”，您可能需要将磁盘大小减小 1KB
  4. （可选）为操作系统和文件创建一个分区
    • 对于 Xcode，分配至少 60GB
  5. 关闭磁盘工具，然后点击“重新安装 macOS”
  6. 按照屏幕上的说明完成安装

注意：安装过程中系统可能需要多次重启。

来源： README.md684-697

常用配置选项

Docker-OSX 支持通过环境变量进行各种自定义设置

内存分配

来源： Dockerfile192-193 README.md738-748

CPU 核心数

来源： Dockerfile196-197 README.md740-746

显示分辨率

要更改显示分辨率，请使用 WIDTH 和 HEIGHT 环境变量，并结合 GENERATE_UNIQUE=true 或 GENERATE_SPECIFIC=true

常见分辨率

  • 800x600
  • 1280×768
  • 1600×900
  • 1920×1080
  • 2560×1600

来源： README.md1413-1488 Dockerfile331-333

网络配置

使用 ADDITIONAL_PORTS 环境变量转发其他端口

来源： README.md925-962 Dockerfile283-285

共享文件夹

使用 9p 文件系统在主机和 macOS 之间共享文件夹

macOS 系统启动后，使用以下命令挂载共享文件夹：

来源： README.md998-1036

重用和管理容器

重用现有容器

要重用现有容器，而不是每次都创建一个新容器

您可以使用以下命令筛选 Docker-OSX 容器：

来源： README.md791-818

保存容器更改

保存容器的状态

来源： README.md1822-1837

故障排除

Docker 守护进程未运行

如果遇到“docker: unknown server OS”错误，请启动 Docker 守护进程

来源： README.md715-734

显示/X11 问题

如果您遇到显示权限问题

来源： README.md838-856

RAM分配问题

如果您看到“无法设置虚拟机内存‘pc.ram’：无法分配内存”错误，说明您尝试分配的内存超过了可用内存。请释放系统内存。

来源： README.md859-886

LibGTK 错误

如果您看到涉及“连接被拒绝”的 LibGTK 相关错误，请确保您的 X11 服务器正在运行并且配置正确。请参阅上面的显示/X11 问题部分。

来源： README.md831-837

在 Windows 上运行

可以使用 WSL2（Windows Subsystem for Linux）在 Windows 上运行 Docker-OSX。要求

  • Windows 11（版本 22000+ / 21H2 或更高版本）
  • 已启用嵌套虚拟化的 WSL2

有关在 Windows 上运行的完整说明，请参阅 README.md616-681

下一步