从零开始：Windows WSL 2 与 Docker 环境配置

在 Windows 上运行 Docker 的最佳实践是基于 WSL 2 (Windows Subsystem for Linux)。这种方式比传统的 Hyper-V 虚拟机更轻量、性能更强，且能实现 Linux 与 Windows 文件的无缝交互。

---

第一阶段：准备与安装 WSL 2

在安装 Docker 之前，必须确保系统已正确配置 WSL 2。

1. 检查系统版本

   按下 Win + R，输入 winver。确保你的版本：

   • Windows 10: 版本 2004 或更高（内部版本 19041 或更高）。
   • Windows 11: 全版本支持。

2. 启用虚拟化支持

   进入 BIOS/UEFI 设置，确保 Virtualization Technology (VT) 已启用。

   你可以在任务管理器的“性能”选项卡中确认“虚拟化：已启用”。

3. 一键安装 WSL

   以 管理员身份 打开 PowerShell，输入：

   wsl --install

4. 重启电脑

   安装完成后，必须重启计算机以应用系统组件更改。

---

第二阶段：安装 Docker Desktop

1. 下载安装包

   访问 Docker 官网，下载 Windows 版安装程序。

2. 执行安装

   运行安装程序，确保勾选 “Use the WSL 2 based engine”。

3. 启用 WSL 2 集成

   在 Docker Desktop 设置中，进入 Resources > WSL Integration，勾选你的 Linux 发行版。

---

第三阶段：配置镜像加速

配置镜像加速 (国内环境必选)

由于 Docker Hub 官方服务器位于海外，国内用户拉取镜像可能较慢。请在 Docker Desktop 的 Settings > Docker Engine 中修改 JSON 配置文件。

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "registry-mirrors": [
    "[https://mirror.baidubce.com](https://mirror.baidubce.com)",
    "[https://docker.m.daocloud.io](https://docker.m.daocloud.io)",
    "[https://hub-mirror.c.163.com](https://hub-mirror.c.163.com)",
    "[https://mirror.ccs.tencentyun.com](https://mirror.ccs.tencentyun.com)"
  ]
}

Tip

修改完成后，请务必点击右下角的 Apply & Restart 按钮，使配置生效。

第四阶段：使用 Docker Compose

在 Windows 上安装 Docker Desktop 后，docker-compose 已经默认安装完成。你无需进行额外配置即可直接使用。

验证 Compose 状态

打开 PowerShell 或 WSL 终端，运行：

docker compose version