Docker Desktop 安装与配置完整教程（图文版）

Docker Desktop 安装与配置完整教程（图文版）

适用系统：Windows 10 / 11（64 位）
更新时间：2026 年 8 月 12 日
说明：本教程内容覆盖下载、安装、WSL 2、镜像存储路径迁移、国内镜像加速和最终验证

一、Docker Desktop 简介

Docker Desktop 是 Docker 官方推出的 Windows / macOS 桌面客户端，内置 Docker Engine、Docker CLI、Docker Compose 等常用组件。装好之后，你可以在 Windows 上直接使用 docker 命令构建、运行和管理容器。

在 Windows 上使用 Docker Desktop，推荐以 WSL 2 作为后端运行环境。WSL 2 启动更快、兼容性更好、资源占用也更合理，所以本教程会重点说明 WSL 2 的安装和配置。

二、下载安装包

1. 打开官网下载页面

下载网址：

https://www.docker.com/products/docker-desktop/

图1-官网下载

2. 下载合适版本的安装包

在官网选择 Windows 版本，下载 Docker Desktop Installer.exe 安装包。

3. 下载后先不要急着直接安装

下载后切记不要直接双击安装，因为 Docker Desktop 默认会装到 C 盘，后续拉取的镜像数据也默认放在 C 盘，长期使用会占用大量系统盘空间。

建议提前准备一个非系统盘目录，例如：

D:\software\Docker Desktop

三、通过命令行把 Docker Desktop 安装到指定目录

1. 找到安装包所在目录

找到下载好的 Docker Desktop Installer.exe，比如我的安装包放在：

D:\software\Docker Desktop\Docker Desktop Installer.exe

2. 打开命令提示符

按 Win + R 输入 cmd 回车，打开 cmd 终端，然后执行以下指令（请记得把路径改成自己的磁盘符）：

start /w "" "D:\software\Docker Desktop\Docker Desktop Installer.exe" install --installation-dir=D:\software\Docker Desktop

说明：命令中前面一个路径是安装包所在 exe 文件存放的路径，后面一个路径是程序本体最终安装目录。建议两者路径最好保持一致，方便后续找文件、卸载和清理缓存。

3. 完成安装配置

回车后会弹出配置页面。

图2-安装配置

默认选择 Per-user installation（单用户安装），勾选创建桌面快捷方式方便后续启动，然后点击 OK 完成安装配置。

4. 等待安装完成

等待安装进度走完，出现安装完成提示即可。

图3-安装完成

到这里基本就安装成功了。

5. 验证 Docker 是否安装成功

打开 cmd 终端，输入：

docker --version

图4-验证版本

看到上图所示的版本信息，说明 Docker 已经安装成功。

四、首次启动与 WSL 2 配置

1. 打开 Docker Desktop

接下来打开软件，进行一些初始化设置。

图5-欢迎界面

点击 Accept 接受协议。

2. 如果出现 WSL 相关提示

如果出现以下窗口，则是因为没有安装 WSL，需要先下载并安装 WSL。

图6-WSL缺失提示

3. 下载 WSL

GitHub 下载链接：

https://github.com/microsoft/WSL/releases

4. 安装 WSL

打开下载好的安装包，选择以管理员身份重启，按提示完成安装即可安装成功。

图7-WSL安装

5. 重新打开 Docker Desktop

重启完成后，重新打开 Docker Desktop 进行初始化设置。

图8-初始化界面

五、修改磁盘镜像存储位置（强烈建议）

1. 进入设置

点击右上角齿轮图标进入设置，修改磁盘镜像存储数据。

图9-设置入口

2. 修改磁盘镜像位置

在 Resources -> Advanced 页面点击 Browse 修改路径。

图10-磁盘镜像位置

非常建议修改：至少几十个 G 的数据放到 C 盘，非常占用系统盘空间。

3. 应用并重启

修改完后，不要忘记点击右下角的 Apply & restart。

图11-应用并重启

在弹出的窗口中点击 Yes, move it，Docker 会自动把已有镜像数据迁移到新路径。

六、配置国内镜像加速

1. 打开 Docker Engine 配置

为了防止拉取镜像时卡顿，我们还需要配置国内镜像资源。

在 Settings -> Docker Engine 中，粘贴下面这份国内镜像源配置。

图12-国内镜像配置

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1ms.run",
    "https://mirror.baidubce.com",
    "https://hub-mirror.c.163.com",
    "https://dockerproxy.net"
  ]
}

2. 应用配置

不要忘了点击 Apply & restart，让配置生效。

七、验证配置是否成功

1. 在 cmd 中验证

最后在 cmd 终端执行以下命令：

docker info --format "{{json .RegistryConfig}}"

图13-验证镜像源

如图所示，只要 registry-mirrors 列表中出现刚才配置的国内镜像地址，就说明配置成功了。

2. 验证 Docker 环境

还可以继续执行：

docker --version
docker info

如果想进一步确认 Docker 可以正常拉取并运行镜像，可以执行：

docker run hello-world

八、安装完成总结

到这里已经完全配置成功了。你现在可以正常使用 Docker 拉取镜像、创建容器和管理开发环境。

整个安装过程的关键点可以归纳为：

  • 下载安装包后不要直接安装，先用命令行指定非系统盘目录
  • 首次启动时如提示缺少 WSL，按教程安装即可
  • 把磁盘镜像位置迁移到非系统盘，避免 C 盘空间告急
  • 配置国内镜像加速，避免拉取镜像慢或超时

九、常见问题与提示

1. 提示“WSL 2 未安装”

按第四步从 GitHub 或百度网盘下载 WSL 安装包安装，然后重新打开 Docker Desktop。

2. C 盘空间占用过高

把磁盘镜像位置迁移到非系统盘（第五步），并定期清理无用资源：

docker system prune -a

3. 拉取镜像很慢或超时

检查第六步的国内镜像加速是否配置成功；如果某个镜像源响应较慢，可以调整 registry-mirrors 列表中的顺序。

4. 卸载与清理

建议安装时使用统一的目录，方便之后卸载和查找文件。卸载后如仍有残留，可以手动检查并清理 %APPDATA%\Docker 等缓存目录，避免残留文件继续占用磁盘。

posted @ 2026-08-13 10:37  郑征航  阅读(13)  评论(0)    收藏  举报