目录

前言

环境说明

架构原理

第一步：启用 Windows 虚拟化功能

第二步：修复 Hypervisor 启动配置

第三步：安装 WSL 2 与 Ubuntu

第四步：启动 Docker Desktop

第五步：验证安装

常见问题

总结

---

前言

Docker 是目前最流行的容器化平台，但其底层依赖 Linux 内核特性（cgroups 和 namespace）。在 Windows 11 家庭版上运行 Docker，需要先通过 WSL 2（Windows Subsystem for Linux 2）提供一个真实的 Linux 内核环境。本文记录完整的配置排障过程。

---

环境说明

项目	版本
操作系统	Windows 11 家庭版（Home）
Docker Desktop	4.66.1
Docker Engine	29.3.1

---

架构原理

Windows 上运行 Docker 的调用链：

应用程序
   ↓
Docker Desktop（Windows 管理界面）
   ↓
WSL 2（真实 Linux 内核）
   ↓
Hyper-V 虚拟机监控程序
   ↓
Windows 硬件

WSL 2 运行微软维护的真实 Linux 内核，而非模拟层，因此性能接近原生 Linux，Docker 兼容性完整。

---

第一步：启用 Windows 虚拟化功能

以管理员身份打开 PowerShell，启用"虚拟机平台"功能（WSL 2 的必要前提）：

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

---

第二步：修复 Hypervisor 启动配置

问题现象： 虚拟机平台已启用，但 bcdedit 输出中缺少 hypervisorlaunchtype 项，导致 Hyper-V 未随 Windows 启动，WSL 2 无法正常运行。

以管理员身份运行以下命令，将 hypervisor 设为自动启动：

bcdedit /set hypervisorlaunchtype auto

执行成功后显示：操作成功完成。

然后重启电脑使配置生效。

说明： Windows 11 家庭版不带完整的 Hyper-V 管理界面，需要手动通过 bcdedit 配置此项，这是家庭版与专业版配置的主要差异。

---

第三步：安装 WSL 2 与 Ubuntu

重启后，以管理员身份运行：

wsl --install

此命令自动下载并安装 Ubuntu 发行版。安装完成后需要创建 Linux 用户账户：

• 用户名规则： 小写字母或下划线开头，可含小写字母、数字、下划线、连字符

• 密码输入时屏幕不显示字符，属于正常的 Linux 安全机制

注意： 若出现 NAT 模式下的 WSL 不支持 localhost 代理 提示，为代理软件兼容性提示，不影响使用。

---

第四步：启动 Docker Desktop

完成以上步骤后打开 Docker Desktop，界面应正常启动，不再报虚拟化相关错误。

---

第五步：验证安装

打开 PowerShell 或 CMD，运行以下命令验证：

docker version
docker run hello-world

若 hello-world 容器成功运行并输出以下内容，说明环境配置完全成功：

Hello from Docker!
This message shows that your installation appears to be working correctly.

---

常见问题

Q：为什么 Windows 家庭版比专业版配置更复杂？

A：专业版内置完整 Hyper-V 管理工具，家庭版需要手动通过 bcdedit 配置 hypervisor 启动项。

Q：WSL 2 和 WSL 1 有什么区别？

A：WSL 1 通过转译层模拟 Linux 系统调用，WSL 2 运行真实 Linux 内核（基于 Hyper-V 轻量级虚拟机），性能更好，Docker 兼容性完整。

---

总结

Windows 11 家庭版安装 Docker Desktop 的核心逻辑：

Docker 依赖 Linux 内核 → WSL 2 提供真实 Linux 内核 → WSL 2 需要 Hyper-V 支持 → 家庭版需手动配置 hypervisorlaunchtype

理解这条链路，排查问题就变得清晰直接。