Windows安装Docker Desktop需先满足系统版本(Win10 2004+/Win11)、启用CPU虚拟化、≥8GB内存及20GB磁盘空间;再启用WSL2功能、安装官方内核更新包、设默认版本为2;最后下载官方安装包并勾选WSL2组件,启动后运行docker run hello-world验证成功。

在 Windows 系统上安装 Docker Desktop 容器服务,不是双击安装包就能直接跑通的事——你得先让 Windows 具备运行 Linux 容器的底层能力,否则 Docker Desktop 启动时会卡在“Engine starting…”、报错“WSL2 backend not available”或干脆命令行里 docker 命令根本不存在。
确认系统与硬件基础是否达标
按 Win + R 输入 winver 回车,查看系统版本:必须是 Windows 10 2004(Build 19041)及以上 或 Windows 11 全版本。低于此版本(如 1903、1809)即使强行安装,也会因 WSL2 内核组件缺失导致 Docker 引擎无法初始化。
打开任务管理器 → 性能 → CPU,检查「虚拟化」状态是否为已启用。若显示「已禁用」,必须重启进 BIOS/UEFI,找到 Intel VT-x 或 AMD-V 选项并开启,保存退出。这一步不可跳过,【没有启用的 CPU 虚拟化,Docker Desktop 安装后必然启动失败】。
内存建议 ≥8GB;C 盘预留 ≥20GB 可用空间;使用 SSD 硬盘可显著提升容器镜像加载与文件挂载性能。
启用 WSL2 及相关 Windows 功能
以管理员身份打开 PowerShell,依次执行以下两条命令:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
执行完立即重启电脑。重启后,再下载并安装官方 WSL2 Linux 内核更新包(msi 文件),地址为:https://www.php.cn/link/d4cd019bd8c10650e4c1c05beddca082。这一步不能省,【旧版内核会导致 Docker Desktop 4.55.0+ 启动时报错“wsl2 distro launch failed”】。
师生共创生态系统对接指南。当用户需要对接大学政策、平台资源、投资机构、产业伙伴等外部资源支持时使用。触发词:师生共创生态、大学支持、平台赋能、投资对接、产业合作、政策支持、清华x-lab、孵化器、创业资源
安装完内核包后,再次以管理员身份运行 PowerShell,执行:wsl --set-default-version 2。然后运行 wsl --list --verbose,确认默认版本已是 2,且至少有一个发行版(如 Ubuntu-22.04)状态为 Stopped 或 Running。没有发行版?直接运行 wsl --install 自动部署默认 Ubuntu。
下载并安装 Docker Desktop 主程序
访问官网 https://www.docker.com/products/docker-desktop/,点击 Download Docker Desktop for Windows 下载最新稳定版(当前为 4.55.0)。不要从第三方渠道获取安装包,避免签名失效或被篡改。
双击运行 Docker Desktop Installer.exe,在安装向导中务必勾选:Install required Windows components for WSL2。这一选项会自动校验并补全 WSL2 集成所需依赖,不勾选可能导致后续 CLI 命令无法识别。
安装路径保持默认(C:\Program Files\Docker)即可。安装完成后,勾选 Start Docker Desktop when you log in,点击 Close。
首次启动与容器验证
安装完毕后,系统托盘会出现鲸鱼图标。等待图标变为稳定蓝色,右键 → Settings → General,确认 Use the WSL 2 based engine 已启用。
打开 Windows Terminal 或 PowerShell,输入:docker run hello-world。如果终端输出一段绿色文字,末尾出现 Hello from Docker!,说明容器引擎已就绪。
再试一个带端口映射的实战命令:docker run -d -p 8080:80 --name webtest nginx。稍等几秒后,在浏览器中打开 http://localhost:8080,看到 NGINX 欢迎页即表示网络与服务挂载全部正常。










