Docker Desktop Windows 完整安装指南
发布时间： 2026年4月2日
系统环境： Windows 10/11
Docker 版本： v4.67.0 (Docker Engine: 29.3.1)
前言
本文详细记录了在 Windows 10/11 上安装 Docker Desktop 的完整过程，包括遇到的所有问题和解决方案，适合 Docker 新手参考。
作者刚刚完成从0到1的完整安装，经历了所有常见问题，并成功解决。
一、下载 Docker Desktop
1.1 官网下载
下载地址： www.docker.com/products/do…
下载步骤：
-
打开浏览器，访问 Docker 官网下载页面
-
页面会自动识别你的操作系统
-
点击蓝色按钮 "Download for Windows - AMD64"
◦ 注意： 绝大多数 Windows 电脑选择 AMD64 版本
◦ ARM64 仅用于特殊的 ARM 架构处理器
下载信息：
• 文件名：Docker Desktop Installer.exe
• 文件大小：约 500MB
• 下载时间：5-10分钟（取决于网络速度）
截图参考：
Docker 官网下载页面
二、安装过程
2.1 运行安装程序
-
找到下载的 Docker Desktop Installer.exe
-
双击运行
-
出现用户账户控制提示时，点击 "是"
2.2 安装配置
在安装界面，勾选以下选项：
• ✅ Use WSL 2 instead of Hyper-V（推荐）
◦ 使用 WSL2 作为后端，性能更好
• ✅ Add shortcut to desktop（创建桌面快捷方式）
2.3 等待安装完成
• 安装过程需要 5-10 分钟
• 期间电脑可能短暂卡顿，属于正常现象
• 安装完成后，点击 "Close and restart" 重启电脑
重要： 必须重启电脑才能正常使用 Docker。
三、启动 Docker Desktop
3.1 首次启动
重启电脑后：
-
双击桌面上的 Docker Desktop 图标
-
首次启动需要 2-3 分钟
-
右下角任务栏会显示 Docker 图标（白色鲸鱼）
3.2 同意许可协议
启动后会弹出许可协议页面：
• 阅读 Docker 订阅服务协议
• 点击 "Accept" 按钮同意协议
截图参考：
许可协议页面
3.3 登录（可选）
出现登录页面时，有三个选择：
• Sign up：注册新账号
• Sign in：登录已有账号
• Continue without signing in：不登录继续使用（推荐）
新手建议： 选择 "Continue without signing in" ，可以直接免费使用 Docker Desktop 的基础功能。
截图参考：
登录页面
四、WSL 更新问题
4.1 问题表现
安装完成后，可能弹出提示：
WSL needs updating
Your version of Windows Subsystem for Linux (WSL) is too old.
Run the command below to update or for more information, visit the Microsoft WSL documentation.
wsl --update
截图参考：
WSL 更新提示
4.2 解决方法
方法1：点击 "Try Again" 按钮（推荐）
-
直接点击蓝色的 "Try Again" 按钮
-
Docker Desktop 会自动更新 WSL
-
等待 2-5 分钟，让系统自动完成更新
-
更新完成后 Docker 会继续启动
方法2：手动更新 WSL
如果方法1无效，可以手动更新：
- 打开 CMD 或 PowerShell（以管理员身份运行）
◦ 在开始菜单搜索 CMD
◦ 右键点击 "以管理员身份运行"
- 输入以下命令并回车：
`cmd
wsl --update
`
- 等待更新完成
◦ 会自动下载并安装最新版本的 WSL
◦ 可能需要 2-5 分钟
- 重启电脑
- 重新启动 Docker Desktop
截图参考：
WSL 设置页面
4.3 检查 WSL 版本
更新完成后，可以检查 WSL 版本：
**// cmd
**wsl --version
正常输出示例：
WSL 版本：2.3.24.0
内核版本：5.15.153.1-2
WSLg 版本：1.0.61
MSRDC 版本：1.2.5620
Direct3D 版本：1.611.1-81528511
DXCore 版本：10.0.26100.1-240325-1448.ge-release
Windows 版本：10.0.26200.8117
五、Docker Desktop 主界面
5.1 界面介绍
Docker Desktop 成功启动后，你会看到主界面：
顶部栏：
• 左上角：docker.desktop PERSONAL 标识
• 中间：搜索框（快捷键 Ctrl+K）
• 右侧：帮助、通知、设置、Sign in 按钮
左侧导航栏：
• Containers（容器）
• Images（镜像）
• Volumes（卷）
• Kubernetes
• Docker Hub
• Extensions（扩展）
主内容区域：
• 显示当前没有运行中的容器
• 提供学习中心的引导卡片
底部状态栏：
• Engine running（引擎运行中）
• 资源占用信息（RAM、CPU、Disk）
• 版本号：v4.67.0
截图参考：
Docker Desktop 主界面
5.2 验证安装成功
打开 CMD 或 PowerShell，输入以下命令验证：
查看 Docker 版本：
**// cmd
**docker --version
正常输出：
Docker version 29.3.1, build c2be9cc
截图参考：
验证 Docker 版本
查看运行中的容器：
**// cmd
**docker ps
正常输出：
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
（只显示表头，说明当前没有运行中的容器，属于正常情况）
查看本地镜像：
**// cmd
**docker images
正常输出：
REPOSITORY TAG IMAGE ID CREATED SIZE
（只显示表头，说明当前没有本地镜像，属于正常情况）
截图参考：
Docker 命令验证
六、网络连接问题与镜像加速
6.1 问题表现
尝试运行 docker run hello-world 时，可能出现以下错误：
Unable to find image 'hello-world:latest' locally
docker: Error response from daemon: failed to resolve reference "docker.io/library/hello-world:latest": failed to request: Head "registry-1.docker.io/v2/library/…": dialing registry-1.docker.io:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.
问题原因：
• ❌ 无法连接到 Docker 官方镜像仓库（registry-1.docker.io）
• ❌ 网络超时，目标主机无响应
• ❌ Docker Desktop 没有配置 HTTPS 代理
• ❌ 可能是公司/学校网络限制了对外部网站的访问
截图参考：
网络连接错误
6.2 解决方法：配置镜像加速器
步骤1：打开 Docker Desktop 设置
-
点击 Docker Desktop 右上角的 齿轮图标（Settings）
-
在左侧菜单选择 Docker Engine
截图参考：
Docker Engine 设置
步骤2：配置镜像加速器
在编辑框中，删除原有内容，复制以下配置：
**// json
**{
"registry-mirrors": [
"docker.mirrors.ustc.edu.cn",
"hub-mirror.c.163.com",
"mirror.ccs.tencentyun.com"
],
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"features": {
"buildkit": true
}
}
说明：
• registry-mirrors：配置国内镜像加速器
◦ 中科大镜像源：docker.mirrors.ustc.edu.cn
◦ 网易镜像源：hub-mirror.c.163.com
◦ 腾讯云镜像源：mirror.ccs.tencentyun.com
• 其他配置为默认设置，保持不变
步骤3：保存并重启
点击右下角的 "Apply & Restart" 按钮
• 等待 Docker Desktop 重启完成（1-2分钟）
• 重启完成后，镜像加速器配置生效
步骤4：重新测试
在 CMD 中重新运行：
**// cmd
**docker run hello-world
成功输出：
Hello from Docker!
This message shows that your installation appears to be working correctly.
To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.
To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash
Share images, automate workflows, and more with a free Docker ID:
hub.docker.com/
For more examples and ideas, visit:
docs.docker.com/get-started…
6.3 其他网络问题
问题：浏览器无法访问镜像网站
表现：
在浏览器中访问 docker.mirrors.ustc.edu.cn/ 时，显示：
无法访问此网站
找不到 docker.mirrors.ustc.edu.cn 的服务器 IP 地址。
错误代码: ERR_NAME_NOT_RESOLVED
截图参考：
浏览器无法访问
解决方法：
方法1：修改 DNS
-
按 Win + I 打开 Windows 设置
-
选择 网络和 Internet
-
选择 更改适配器选项
-
右键点击你正在使用的网络（以太网或 Wi-Fi）
-
选择 属性
-
双击 Internet 协议版本 4 (TCP/IPv4)
-
选择 使用下面的 DNS 服务器地址
-
输入：
◦ 首选 DNS 服务器：223.5.5.5
◦ 备用 DNS 服务器：119.29.29.29
-
点击 确定，再点击 确定
-
重新打开浏览器测试
方法2：切换网络
如果公司/学校网络限制了访问，可以尝试：
• 使用手机热点
• 切换到家庭网络
• 使用其他网络环境
问题：配置镜像加速器后仍然失败
表现：
配置了镜像加速器后，运行 docker run hello-world 仍然报错：
failed to request: Head "docker.mirrors.ustc.edu.cn/v2/library/…": dial tcp: lookup docker.mirrors.ustc.edu.cn: no such host
截图参考：
镜像加速失败
解决方法：
尝试其他镜像源：
删除之前的配置，使用这个：
**// json
**{
"registry-mirrors": [
"mirror.ccs.tencentyun.com",
"hub-mirror.c.163.com"
]
}
保存并重启 Docker，再试。
说明： 某些镜像源可能在特定网络环境下不可用，可以尝试切换不同的镜像源。
七、基础命令速查
7.1 Docker 版本信息
**// cmd
**docker --version
查看 Docker 版本
7.2 容器管理
**// cmd
**docker ps
查看运行中的容器
**// cmd
**docker ps -a
查看所有容器（包括停止的）
**// cmd
**docker start <容器ID>
启动容器
**// cmd
**docker stop <容器ID>
停止容器
**// cmd
**docker restart <容器ID>
重启容器
**// cmd
**docker rm <容器ID>
删除容器
7.3 镜像管理
**// cmd
**docker images
查看本地镜像
**// cmd
**docker pull <镜像名>
拉取镜像
**// cmd
**docker rmi <镜像ID>
删除镜像
**// cmd
**docker build -t <镜像名> .
构建镜像
7.4 容器操作
**// cmd
**docker exec -it <容器ID> sh
进入容器
**// cmd
**docker logs <容器ID>
查看容器日志
**// cmd
**docker stats
查看容器资源占用
八、常见问题 FAQ
Q1: Docker Desktop 启动失败怎么办？
A: 检查以下几点：
-
WSL 是否已安装并更新
-
Hyper-V 是否已启用
-
系统版本是否满足要求（Windows 10 21H2+ 或 Windows 11）
-
以管理员身份运行 Docker Desktop
Q2: 没有 "Use WSL 2 instead of Hyper-V" 选项？
A: 说明你的系统不支持 WSL2，可能的原因：
• 系统版本过低（需要 Windows 10 21H2+）
• 未启用虚拟化功能
• 可以手动安装 WSL2：打开 PowerShell（管理员），运行 wsl --install
Q3: 安装后 Docker 图标一直显示灰色？
A: 说明 Docker 未正常启动：
-
打开 Docker Desktop，查看错误信息
-
检查 WSL 是否正常
-
重启电脑
-
重新安装 Docker Desktop
Q4: 网络连接问题一直无法解决？
A: 可以尝试：
-
使用手机热点
-
修改 DNS 为 223.5.5.5 和 119.29.29.29
-
联系网络管理员（如果是公司/学校网络）
-
接受现实：Docker 已成功安装，只是网络限制导致无法拉取外部镜像，这不影响学习 Dockerfile 编写和容器管理
Q5: 没有镜像会影响使用吗？
A: 不会！你可以：
-
自己创建镜像（编写 Dockerfile）
-
从其他设备导入镜像文件（docker save / docker load）
-
学习 Docker 核心概念和命令
-
掌握容器管理和镜像构建
没有预置镜像反而能让你更深入地理解 Docker 的工作原理。
九、总结
9.1 安装成功的关键点
✅ 下载正确的版本（Windows AMD64）
✅ 配置 WSL2（比 Hyper-V 性能更好）
✅ 更新 WSL（解决版本过旧问题）
✅ 配置镜像加速器（解决网络问题）
✅ 验证安装（运行 docker --version）
9.2 常见问题解决思路
| 问题 | 解决方法 |
|---|---|
| WSL 版本过旧 | 运行 wsl --update 或点击 "Try Again" |
| 网络连接超时 | 配置镜像加速器，修改 DNS，切换网络 |
| 无法拉取镜像 | 使用国内镜像源，或手动导入镜像文件 |
| Docker 启动失败 | 检查 WSL、Hyper-V，以管理员身份运行 |
9.3 下一步学习建议
Docker 已成功安装，现在可以学习：
- Dockerfile 编写
◦ 学会创建自己的镜像
◦ 理解镜像构建过程
- 容器管理
◦ 启动、停止、删除容器
◦ 查看容器日志
◦ 进入容器操作
- Docker Compose
◦ 编写 docker-compose.yml
◦ 管理多容器应用
- 实战项目
◦ 用 Docker 部署 Web 应用
◦ 搭建开发环境
◦ 容器化现有项目
十、获取帮助
如果在安装或使用过程中遇到问题：
10.1 官方资源
• Docker 官方文档： docs.docker.com/
• Docker Hub： hub.docker.com/
• Docker 论坛： forums.docker.com/
10.2 技术支持
如果你需要远程协助安装 Docker，可以：
-
参考本教程，按照步骤操作
-
遇到问题，参考常见问题章节
-
仍无法解决，可以寻求专业技术服务
提供的服务包括：
• ✅ 一对一远程协助安装 Docker Desktop
• ✅ 解决 WSL 更新问题
• ✅ 配置镜像加速器
• ✅ 解决网络连接问题
• ✅ 验证安装成功
• ✅ 教你基础的 Docker 命令使用
附录：截图索引
-
Docker 官网下载页面 - 查看
-
许可协议页面 - 查看
-
登录页面 - 查看
-
WSL 更新提示 - 查看
-
WSL 设置页面 - 查看
-
Docker Desktop 主界面 - 查看
-
验证 Docker 版本 - 查看
-
Docker 命令验证 - 查看
-
网络连接错误 - 查看
-
Docker Engine 设置 - 查看
-
浏览器无法访问 - 查看
-
镜像加速失败 - 查看
版权声明： 本教程基于实际安装经验编写，供学习和参考使用。
更新日期： 2026年4月2日
作者： Docker 实践者
祝你在 Docker 的学习之路上越走越远！ 🐳🚀
