WSL 2 安装 Docker（Docker Desktop + WSL 集成）一、手册说明针对「Docker Des

一、手册说明

针对「Docker Desktop + WSL 2 集成」方案，包含完整前置准备、安装配置、验证测试、问题排查及优化配置，确保零基础用户也能顺利完成安装。

在 PowerShell 中执行以下命令，确认 Ubuntu 版本为 2：

wsl -l -v

输出示例（需确保 VERSION 列显示 2）：

  NAME                   STATE           VERSION
  Ubuntu-22.04           Running         2

Docker Desktop 首次启动会自动初始化；
点击 Docker Desktop 右上角「设置」；
左侧菜单栏选择「Resources」→「WSL Integration」；
勾选以下选项：
1. ✅ Enable integration with my default WSL distro（启用默认 WSL 发行版集成）；
2. ✅ Ubuntu（勾选你安装的 Ubuntu 发行版，如 Ubuntu-22.04）；

打开 Ubuntu 终端（可通过 Windows 搜索「Ubuntu」启动）；
执行以下命令验证 Docker 版本：
1. ```
 docker --version
```
2. 预期输出示例：Docker version 26.0.0, build 2ae903e（版本号可能不同，无报错即可）。
执行测试容器，验证 Docker 能否正常运行：
1. ```
 docker run hello-world
```
2. 预期输出：包含「Hello from Docker!」的欢迎信息，说明 Docker 安装并运行正常。

若需从另一台电脑访问当前 WSL 中的 Docker，执行以下步骤：

在 WSL 终端执行（避免每次执行 docker 命令需加 sudo）：

# 将当前用户加入 docker 用户组（永久生效）
sudo usermod -aG docker $USER

# 让权限立即生效（无需重启终端）
newgrp docker

重新登录远程 WSL 终端，执行：

docker ps

解决方案：执行以下命令（WSL 终端）：

  sudo usermod -aG docker $USER
  newgrp docker

解决方案：
- 关闭 Docker Desktop；
- 在 PowerShell 中执行 wsl --shutdown，关闭所有 WSL 实例；
- 重新启动 Docker Desktop，再次配置 WSL 集成。

Docker Desktop 会随 Windows 开机自启，若需关闭自启：设置 → General → 取消勾选「Start Docker Desktop when you log in」；
查看所有运行中的容器：docker ps；
停止/删除容器：docker stop 容器ID / docker rm 容器ID；
查看已下载镜像：docker images。