Docker Desktop

一、简介

Docker Desktop 是 Docker 官方的桌面应用程序，专为在 Windows 和 macOS（也支持 Linux）上使用而设计。它将 Docker 引擎、Docker CLI、Docker Compose、Kubernetes 等打包在一起，提供了简单、直观的图形化界面，让开发、运维人员可以轻松地在本地构建、测试和运行 Docker 容器。

• 官网：https://www.docker.com/
• 下载地址：https://www.docker.com/products/docker-desktop/

核心功能：

• 图形化管理容器、镜像、数据卷（Volume）和网络
• 内置 Docker 引擎，开箱即用的 docker / docker compose 命令
• 一键启动本地 Kubernetes 集群
• Windows 上基于 WSL2 后端运行，性能接近原生 Linux

注意：Docker Desktop 个人使用免费，大型企业（250人以上或年营收超 1000 万美元）商业使用需购买付费许可。

二、Windows 安装

1. 环境要求

• Windows 10 64 位：版本 2004（Build 19041）及以上，或 Windows 11
• 开启 WSL2（推荐）或 Hyper-V 虚拟化功能
• BIOS 中已开启虚拟化（VT-x / AMD-V）

2. 安装 WSL2

方式一：一键安装（推荐，Windows 10 21H2 及以上）

用管理员身份打开 PowerShell 执行，完成后重启电脑：

wsl --install

方式二：手动安装

用管理员身份打开 PowerShell，执行下面两条命令启用所需功能，然后重启电脑：

# 部署映像服务和管理工具
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

下载安装 Linux 内核更新包：

下载地址：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

设置 WSL 默认版本为 2：

wsl --set-default-version 2

# 查看已安装发行版的版本
wsl -l -v

更新 WSL 到最新版本（可选）：

wsl --update

3. 安装 Linux 发行版（以 Ubuntu 为例）

进入微软应用商店，搜索 Linux，选择安装 Linux 发行版，这里以 Ubuntu 20 为例。安装完成后，打开 Ubuntu 终端，首次会提示设置用户名和密码。

# 将 apt 源更换为中科大镜像，加快下载速度
sudo sed -i 's/archive.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list

# 修改 root 密码
sudo passwd root

4. 安装 Docker Desktop

1. 下载 Windows 安装包：Docker Desktop Installer.exe
2. 双击安装程序，保持默认选项即可（务必勾选 “Use WSL 2 instead of Hyper-V”）
3. 安装完成后重启电脑
4. 启动 Docker Desktop，等待右下角引擎启动完成（鲸鱼图标停止动画）即可使用

三、macOS 安装

1. 环境要求

• macOS 版本需满足当前 Docker Desktop 的最低要求（建议保持较新系统）
• 先确认芯片类型：点击左上角苹果菜单 → “关于本机”，查看芯片是 Apple（M1/M2/M3/M4） 还是 Intel

2. 下载安装包（按芯片类型二选一）

• Apple 芯片（M 系列）：https://desktop.docker.com/mac/main/arm64/Docker.dmg
• Intel 芯片：https://desktop.docker.com/mac/main/amd64/Docker.dmg

也可以使用 Homebrew 一键安装（自动匹配芯片版本）：

brew install --cask docker

3. 安装与启动

1. 双击下载好的 Docker.dmg，将 Docker 图标拖入 Applications（应用程序）文件夹
2. 在启动台中打开 Docker，首次启动会要求输入系统密码，授权安装网络组件
3. 等待顶部菜单栏的鲸鱼图标停止动画（引擎就绪），即可开始使用

提示：macOS 重启后 Docker 不会自动启动，可在 Settings → General 中勾选 “Start Docker Desktop when you sign in” 实现开机自启。

四、安装后验证

打开终端（Windows 可用 PowerShell 或 Ubuntu 终端）执行：

# 查看版本
docker --version

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

能正常输出版本号和 “Hello from Docker!” 字样，即表示安装成功。

五、常用配置

1. 配置镜像加速

打开 Settings → Docker Engine，在 JSON 配置中加入 registry-mirrors，点击 Apply & Restart：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1ms.run"
  ]
}

2. 资源限制

Settings → Resources：可调整分配给 Docker 的 CPU、内存、磁盘配额（Windows 下对应 WSL2 后端的资源占用）。

六、常见问题

1. Windows 提示 “WSL 2 is not installed”：按本文第二部分步骤安装 WSL2 并重启电脑。
2. Windows 提示虚拟化未开启：进入 BIOS 开启 Virtualization Technology（VT-x / AMD-V）。
3. WSL 版本异常或过旧：执行 wsl --update，再用 wsl -l -v 确认发行版运行在 WSL2。
4. Mac 引擎启动失败：确认 macOS 版本满足要求，并确认下载的安装包与芯片类型匹配。
5. Apple 芯片需要运行 x86 镜像：运行命令时加 --platform linux/amd64 参数。
6. 拉取镜像缓慢：按第五部分配置镜像加速地址。