win11如何安装Docker Desktop_win11Docker Desktop新手必看入门教程-Windows系列-PHP中文网

docker desktop在windows 11安装失败需依次启用bios虚拟化、开启wsl2与虚拟机平台功能、更新并设wsl2为默认版本、安装ubuntu、指定非系统盘安装路径、配置国内镜像及wsl集成。

win11如何安装docker desktop_win11docker desktop新手必看入门教程

如果您在 Windows 11 系统上尝试安装 Docker Desktop，但安装失败、启动报错或无法正常运行容器，则可能是由于系统组件缺失、虚拟化未启用或安装路径配置不当所致。以下是解决此问题的步骤：

一、检查并启用硬件虚拟化

Windows 11 运行 Docker Desktop 的前提条件是 CPU 虚拟化技术（Intel VT-x 或 AMD-V）必须在 BIOS/UEFI 中启用，否则 WSL2 和 Hyper-V 均无法工作。

1、重启电脑，在开机自检阶段反复按 F2 / Del / F10 / Esc（具体按键依主板品牌而定）进入 BIOS/UEFI 设置界面。

2、在 Advanced、CPU Configuration 或 Security 等菜单中查找 Virtualization Technology、Intel VT-x、AMD SVM Mode 或 SVM Support 等选项。

3、将该选项设置为 Enabled，保存设置并退出（通常按 F10）。

4、重新进入 Windows 后，按 Ctrl+Shift+Esc 打开任务管理器，切换至“性能”选项卡，确认右下角显示 虚拟化：已启用。

现代 Docker Desktop 默认依赖 WSL2 作为运行时后端，需提前启用子系统与虚拟机平台功能，且必须以管理员权限执行命令。

1、按下 Win + X，选择“终端（管理员）”或“Windows PowerShell（管理员）”。

2、依次执行以下两条命令（每条执行完毕无报错即可）：

disman.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

disman.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

3、执行完成后，必须重启电脑，否则后续步骤无法生效。

WSL2 是 Docker Desktop 的核心运行环境，需确保其内核版本为最新，并设置为默认版本，同时安装一个可用的 Linux 发行版（如 Ubuntu）。

1、重启后，再次以管理员身份打开终端，运行：wsl --update，等待更新完成。

2、运行：wsl --set-default-version 2，将 WSL 默认版本设为 2。

Narration Box

Narration Box是一款面向有声书、课程、视频和广告旁白的 AI 语音生成工具。

下载

3、打开 Microsoft Store，搜索并安装 Ubuntu 22.04 LTS（推荐稳定版本）。

4、首次启动 Ubuntu，按提示设置用户名和密码（密码输入时无回显，属正常现象）。

5、验证是否成功：运行 wsl --list --verbose，确认输出中对应发行版的 VERSION 列显示为 2。

Docker Desktop 安装程序默认将 WSL 镜像及容器数据写入 C:\Users\%username%\AppData\Local\Docker\wsl\，极易耗尽系统盘空间。可通过命令行指定安装目录规避该问题。

1、将下载好的 Docker Desktop Installer.exe 放入目标磁盘非系统分区，例如：D:\software\docker_desktop\Docker Desktop Installer.exe。

2、以管理员身份打开命令提示符或 PowerShell，切换至该目录所在驱动器（如 D:）。

3、执行安装命令（注意替换为您的实际路径）：

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

4、安装过程中，务必勾选 Use WSL 2 instead of Hyper-V (recommended) 选项。

因 Docker Hub 国内直连缓慢且存在速率限制，启用国内镜像源可显著提升拉取镜像速度；同时需手动开启 WSL 发行版集成，否则容器无法调用 Linux 子系统资源。

1、启动 Docker Desktop，点击右上角齿轮图标进入 Settings。

2、左侧选择 Resources → WSL Integration，勾选 Enable integration with my default WSL distro 并确保 Ubuntu 开关为开启状态。

3、点击左侧 Docker Engine，将右侧 JSON 内容替换为：

{ "registry-mirrors": [ "https://mirror.baidubce.com", "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com" ] }

4、点击 Apply & Restart，使配置生效。