Windows 安装 Docker Desktop 详细指南
一、为什么选择 Docker?
- :一次构建,处处运行
在 Windows 系统上安装 Docker Desktop 的完整流程,包括启用 Hyper-V 和 WSL 2 虚拟化组件、更新内核、下载安装包及配置国内镜像加速器。内容涵盖版本选择、命令执行细节、常见问题排查及验证方法,帮助用户快速完成容器化环境部署。

| 版本 | 适用设备 | 市场占有率 |
|---|---|---|
| AMD64 | Intel/AMD 主流 CPU 的 Win10/11 | >99% |
| ARM64 | Surface Pro X 等 ARM 架构设备 | <1% |
💡 普通用户 99% 选 AMD64!
查看本机架构:设置 > 系统 > 关于→ 检查 '系统类型'
# 以管理员身份打开 PowerShell 执行以下命令
# 启用 Hyper-V 虚拟化平台
dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart
# 启用 WSL 2 虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重启电脑生效!
这两条 PowerShell 命令是通过 dism.exe 工具启用 Windows 系统的两个核心虚拟化组件,为 Docker Desktop 运行容器提供底层支持。
dism.exe 是什么?dism(Deployment Image Servicing and Management,部署映像服务和管理工具)是 Windows 内置的系统维护工具,可用于启用/禁用系统功能、修复系统映像等。这里的 /online 参数表示操作当前正在运行的 Windows 系统(而非离线映像)。
/enable-feature:启用指定系统功能;/featurename:Microsoft-Hyper-V:目标功能是 Hyper-V(包含 Hyper-V 管理器、虚拟机监控程序等);/all:启用该功能所有子组件(避免遗漏依赖);/norestart:临时不重启系统(后续需手动重启生效)。/featurename:VirtualMachinePlatform:目标功能是 '虚拟机平台'(专门为 WSL 2 设计的轻量级虚拟化层,基于 Hyper-V 技术但更精简);/all 启用所有子功能,/norestart 暂不重启)。VirtualMachinePlatform 正是 WSL 2 运行的必要基础——没有它,WSL 2 无法启动,Docker 也就无法通过 WSL 2 高效运行 Linux 容器。简单说:Docker 在 Windows 上的运行依赖'虚拟化环境',而这两个组件共同构成了虚拟化的基础:
现在 Docker Desktop 安装时会自动检测并优先使用 WSL 2(需 VirtualMachinePlatform 支持),若 WSL 2 不可用才会回退到 Hyper-V。因此,启用这两个组件是为了确保 Docker 有可用的虚拟化环境,避免'缺少依赖'导致安装失败。
/norestart 只是暂时不重启,最终必须重启)。这两条命令的本质是:为 Docker 在 Windows 上运行'铺路'——启用系统自带的虚拟化组件,让 Docker 能创建容器运行所需的'沙箱环境'。
普通用户只需按步骤执行,重启后即可继续安装 Docker Desktop~
重启后,在 cmd 中输入命令:wsl --status。
若输出中包含 默认版本:2 和 内核版本:…,说明 VirtualMachinePlatform 已生效(WSL 2 依赖它)。
![图片]
重启后,打开'服务'(services.msc),查找以下服务:
若状态为 '正在运行',说明 Hyper-V 组件已生效(部分场景下可能按需启动,非必须一直运行)。
![图片]
👉 双击安装
若提示:您的系统已安装了更高版本的 Windows 子系统 Linux 更新。安装程序即将退出。
![图片]
执行:
wsl --set-default-version 2
![图片]
✅ 认准 'Download for Windows - AMD64' 按钮
![图片]
Docker Desktop Installer.exe![图片]
要理解 Docker Desktop 安装界面这三个选项的含义,我们可以逐个拆解:
意思是 '使用 WSL 2 替代 Hyper-V(推荐)'。
意思是 '允许此安装使用 Windows 容器'。
意思是 '在桌面添加快捷方式'。
非常直观:勾选后,Docker Desktop 的启动快捷方式会自动出现在电脑桌面,方便你后续一键打开程序~
简单总结:
![图片]
安装完成后桌面就会出现一个图标,双击。
![图片]
进入:
![图片]
点击接受,然后:
![图片]
使用 github 账号登录:
![图片]
这个提示的意思是:你的 Windows 子系统 for Linux (WSL) 版本太旧了,需要更新。
这个命令会自动下载并安装最新版本的 WSL。
![图片]
输入以下命令并按回车执行:
wsl --update
更新完成后,点击提示窗口中的 'Restart' 按钮,或手动重启电脑,使更新生效。
![图片]
简单来说:你的 WSL 该升级了,运行一下它给出的命令就行。 这是 Windows 系统组件的正常更新流程,按照提示操作即可。
docker --version # 输出示例:Docker version 24.0.7, build afdd53b
![图片]
docker run hello-world # 出现 "Hello from Docker!" 即成功!
![图片]
若长时间卡在'拉取中'或提示 pull access denied/network timeout,说明拉取出错,需排查以下问题:
Settings进入 Docker Engine 选项卡
![图片]
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com"
]
}
![图片]
Apply & RestartWSL 2 installation is incomplete解决方案:
wsl --updateDocker Desktop requires a newer WSL kernel解决方案: 升级 Windows 系统至 21H2 或更高版本
排查步骤:
netsh winsock reset 重置网络栈
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online