Docker Desktop

Docker Desktop 是 Docker 为 Windows 和 macOS 用户提供的桌面客户端，集成了 Docker Engine、Docker CLI、Docker Compose、Docker Scout、Docker Build Cloud 等工具，是桌面开发者的首选安装方式。

系统要求

Windows

要求	说明
操作系统	Windows 10/11（64位）
版本要求	Home/Pro/Education/Enterprise
WSL 2	推荐启用（性能更好）
虚拟化	需要 BIOS 开启硬件虚拟化
内存	最低 4GB，推荐 8GB 以上
磁盘	至少 20GB 可用空间

macOS

要求	说明
操作系统	macOS 12.0 Monterey 及以上
芯片	Intel 或 Apple Silicon（M1/M2/M3）
内存	最低 4GB，推荐 8GB 以上
磁盘	至少 20GB 可用空间

下载安装

Windows 安装

1. 下载安装包

前往 Docker 官网 下载 Docker Desktop Installer.exe。

国内网络较慢可使用镜像站下载，或通过以下命令下载：

winget install Docker.DockerDesktop

2. 安装步骤

1. 双击运行 Docker Desktop Installer.exe
2. 勾选 Use WSL 2 instead of Hyper-V（推荐）
3. 勾选 Add shortcut to desktop
4. 点击 Ok 开始安装
5. 安装完成后点击 Close and restart 重启系统

3. 启用 WSL 2（可选但推荐）

# 启用 WSL
wsl --install

# 设置默认版本为 WSL 2
wsl --set-default-version 2

# 安装 Ubuntu（可选）
wsl --install -d Ubuntu

macOS 安装

1. 下载安装包

前往 Docker 官网 下载，注意选择对应芯片版本：

• Intel 芯片：选择 Docker Desktop for Mac with Intel chip
• Apple Silicon：选择 Docker Desktop for Mac with Apple Silicon

2. 安装步骤

1. 打开下载的 .dmg 文件
2. 将 Docker 图标拖到 Applications 文件夹
3. 打开 Applications，双击 Docker 启动
4. 首次运行会要求输入系统密码

配置 Docker Desktop

常用配置项

打开 Docker Desktop → 点击右上角齿轮图标进入 Settings：

General（常规）

• Start Docker Desktop when you log in：登录时自动启动
• Use WSL 2 based engine：使用 WSL 2（Windows）

Resources（资源）

CPUs:    建议分配物理 CPU 的一半
Memory:  建议 4GB 以上
Swap:    1GB
Disk:    根据需要设置虚拟磁盘大小

Docker Engine（引擎配置）

可以直接编辑 daemon.json，配置镜像加速：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerhub.icu"
  ],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

配置完成后点击 Apply & restart 生效。

验证安装

安装完成后，打开终端（Windows 使用 PowerShell 或 CMD，macOS 使用 Terminal）验证：

# 查看 Docker 版本
docker version

# 查看 Docker 信息
docker info

# 运行测试容器
docker run hello-world

成功输出类似如下内容则表示安装成功：

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

常见问题

Windows：WSL 2 安装失败

# 手动安装 WSL 2 内核更新
# 下载并安装：https://aka.ms/wsl2kernel

# 或通过命令更新
wsl --update

Windows：Docker Desktop 无法启动

1. 检查 BIOS 是否开启虚拟化（Intel VT-x / AMD-V）
2. 检查 Hyper-V 是否开启：

   # 开启 Hyper-V
   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

3. 重置 Docker Desktop：Settings → Troubleshoot → Reset to factory defaults

macOS：Docker Desktop 占用内存过多

在 Settings → Resources 中降低内存分配，或使用更轻量的 OrbStack 替代。

镜像拉取很慢

配置国内镜像加速，详见镜像加速配置。

Docker Desktop 替代方案

如果不想使用 Docker Desktop（如许可证问题），可以考虑：

工具	说明
OrbStack	macOS 专用，更轻量快速，免费使用
Podman Desktop	开源跨平台，兼容 Docker 命令
Rancher Desktop	开源，包含 K8s，适合进阶用户
Lima（macOS）	轻量级 Linux VM，运行 Docker

总结

Docker Desktop 是 Windows 和 macOS 开发者最方便的 Docker 使用方式，集成了日常开发所需的所有工具。安装完成后记得：

1. 配置镜像加速提升拉取速度
2. 合理分配内存和 CPU 资源
3. 定期更新到最新版本