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

Docker Desktop 安装与配置完整教程图文版适用系统Windows 10 / 1164 位更新时间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/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.exe2. 打开命令提示符按Win R输入cmd回车打开 cmd 终端然后执行以下指令请记得把路径改成自己的磁盘符start /w D:\software\Docker Desktop\Docker Desktop Installer.exe install --installation-dirD:\software\Docker Desktop说明命令中前面一个路径是安装包所在 exe 文件存放的路径后面一个路径是程序本体最终安装目录。建议两者路径最好保持一致方便后续找文件、卸载和清理缓存。3. 完成安装配置回车后会弹出配置页面。默认选择Per-user installation单用户安装勾选创建桌面快捷方式方便后续启动然后点击OK完成安装配置。4. 等待安装完成等待安装进度走完出现安装完成提示即可。到这里基本就安装成功了。5. 验证 Docker 是否安装成功打开 cmd 终端输入docker --version看到上图所示的版本信息说明 Docker 已经安装成功。四、首次启动与 WSL 2 配置1. 打开 Docker Desktop接下来打开软件进行一些初始化设置。点击Accept接受协议。2. 如果出现 WSL 相关提示如果出现以下窗口则是因为没有安装 WSL需要先下载并安装 WSL。3. 下载 WSLGitHub 下载链接https://github.com/microsoft/WSL/releases4. 安装 WSL打开下载好的安装包选择以管理员身份重启按提示完成安装即可安装成功。5. 重新打开 Docker Desktop重启完成后重新打开 Docker Desktop 进行初始化设置。五、修改磁盘镜像存储位置强烈建议1. 进入设置点击右上角齿轮图标进入设置修改磁盘镜像存储数据。2. 修改磁盘镜像位置在Resources - Advanced页面点击Browse修改路径。非常建议修改至少几十个 G 的数据放到 C 盘非常占用系统盘空间。3. 应用并重启修改完后不要忘记点击右下角的Apply restart。在弹出的窗口中点击Yes, move itDocker 会自动把已有镜像数据迁移到新路径。六、配置国内镜像加速1. 打开 Docker Engine 配置为了防止拉取镜像时卡顿我们还需要配置国内镜像资源。在Settings - Docker Engine中粘贴下面这份国内镜像源配置。{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}}如图所示只要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 -a3. 拉取镜像很慢或超时检查第六步的国内镜像加速是否配置成功如果某个镜像源响应较慢可以调整registry-mirrors列表中的顺序。4. 卸载与清理建议安装时使用统一的目录方便之后卸载和查找文件。卸载后如仍有残留可以手动检查并清理%APPDATA%\Docker等缓存目录避免残留文件继续占用磁盘。