macOS 安装 Docker

macOS 上运行 Docker 有以下几种方式：

1. Docker Desktop（官方推荐）
2. OrbStack（轻量替代方案，推荐）
3. Lima + Docker（开源免费）

方式一：Docker Desktop

详细安装步骤请参考 Docker Desktop 章节。

简要步骤：

1. 前往 Docker 官网 下载
2. 注意区分 Intel 芯片 和 Apple Silicon（M1/M2/M3）
3. 打开 .dmg，将 Docker 拖入 Applications
4. 启动 Docker Desktop，等待初始化完成

# 验证安装
docker version
docker run hello-world

方式二：OrbStack（推荐替代方案）

OrbStack 是专为 macOS 设计的 Docker Desktop 替代品，启动更快、内存占用更少，个人用途免费。

安装方式一：官网下载

前往 https://orbstack.dev/download 下载安装包。

安装方式二：Homebrew

brew install orbstack

安装后，OrbStack 会自动接管 Docker CLI，无需任何额外配置：

# 验证
docker version
docker run hello-world

OrbStack 的优势：

• 启动时间约 2 秒（Docker Desktop 约 30 秒）
• 内存占用约 300MB（Docker Desktop 约 2GB+）
• 原生 Apple Silicon 支持
• 内置 Linux 虚拟机，支持 orb 命令直接进入 Linux 环境

方式三：Homebrew + Lima（开源免费）

Lima 是一个开源的 macOS 虚拟机工具，可以运行 Linux 并在其中使用 Docker。

# 安装 Lima
brew install lima

# 创建并启动包含 Docker 的虚拟机
limactl start --name=docker template://docker

# 配置 Docker 上下文
docker context create lima-docker --docker "host=unix:///Users/$USER/.lima/docker/sock/docker.sock"
docker context use lima-docker

# 验证
docker run hello-world

使用 Homebrew 安装 Docker CLI（仅命令行）

如果只需要 Docker CLI（连接远程 Docker 或 WSL Docker），可以只安装客户端：

# 只安装 Docker CLI（不含 Docker Engine）
brew install docker

# 安装 Docker Compose 插件
brew install docker-compose

配置镜像加速

Docker Desktop 配置

打开 Docker Desktop → Preferences → Docker Engine，添加镜像加速：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerhub.icu"
  ]
}

命令行配置

# 编辑或创建 daemon.json（Docker Desktop 使用 GUI 配置更方便）
# 配置文件位置：~/.docker/daemon.json

常见问题

Apple Silicon（M1/M2/M3）兼容性

大多数镜像都支持 linux/arm64 架构，少数只有 linux/amd64 的镜像可以通过模拟运行（性能略低）：

# 强制使用 amd64 平台（模拟运行）
docker run --platform linux/amd64 some-x86-image

# 查看当前系统架构
uname -m  # 输出 arm64 表示 Apple Silicon

Docker Desktop 占用过多资源

在 Docker Desktop → Preferences → Resources 中降低内存分配，或改用 OrbStack。

提示：Cannot connect to the Docker daemon

确认 Docker Desktop 或 OrbStack 已启动并运行。

# 检查 Docker 是否运行
docker info

各方案对比

特性	Docker Desktop	OrbStack	Lima
安装难度	简单	简单	中等
启动速度	慢（30s+）	快（2s）	中等
内存占用	高（2GB+）	低（~300MB）	中等
个人免费	是	是	是
商业免费	部分免费	是	是
图形界面	有	有	无
Apple Silicon	支持	原生支持	支持

总结

• 日常开发：推荐 OrbStack，更快更轻量，个人和商业都免费
• 团队统一：推荐 Docker Desktop，官方支持，功能完整
• 极简需求：使用 Lima，开源免费，完全可定制