Windows11安装WSL2 + docker

参考 Win11 安装 WSL2 + Docker 新手友好教程（官方正版，实测成功） - 知乎

一、安装WSL

1、按下 Win + X，在弹出的菜单中选择「Windows 终端 (管理员)」（如果没有，选择「Windows PowerShell (管理员)」也可）；

2、执行安装命令  wsl --install

3、按照原指导命令执行后，会自动开启 WSL 相关功能、下载 WSL2 内核、安装默认的 Ubuntu 发行版（无需手动选择）；然后重启电脑，会弹出ubuntu终端设置密码即可。

但是本人执行命令后并没有安装ubuntu系统。只是完成了wsl的安装。通过验证命令 wsl -l -v 查看报错

 

未能从 “https://raw.githubusercontent.com/microsoft/WSL/master/distributions/DistributionInfo.json” 提取分发列表。与服务器的连接被重置 错误代码： Wsl/WININET_E_CONNECTION_RESET

 

尝试了一些网上的办法，如配置DNS，配置host 均没有解决。

4、通过导入命令手动安装ubuntu

先手动下载ubuntu对应的wsl镜像

Ubuntu 24.04.5.1 (Noble Numbat)

执行导入命令 

# 先创建存放目录
mkdir D:\wsl\Ubuntu2404
# 从本地文件安装
wsl --install --from-file D:\wsl\ubuntu-24.04.5-wsl-amd64.wsl --location D:\wsl\Ubuntu2404

执行完直接启动，设置用户名密码 即可。 这样就完成了wsl安装和ubuntu初始化。

二、安装并关联docker

方式一：直接在windows subsystem的ubuntu中通过apt命令安装docker engine，和Linux安装无本质区别。

方式二：windows安装docker desktop，和wsl的ubuntu进行关联

1、下载  Docker Desktop: The #1 Containerization Tool for Developers | Docker

2、打开安装包后，无需修改任何设置（默认勾选「Use WSL 2 instead of Hyper-V」，正是我们需要的），直接点击「OK」；

安装完成完成后，打开设置，勾选「Start Docker Desktop when you log in」（可选，建议勾选，开机自动启动 Docker）

3、关联 WSL2 与 Docker

1. 打开 Docker Desktop，点击右上角的「Settings」（设置图标，齿轮形状）；
2. 在左侧菜单中找到「Resources」（资源），点击子菜单「WSL Integration」（WSL 集成）；
3. 在「Enable integration with my default WSL distro」下方，找到「Ubuntu」，开启右侧的开关（变成蓝色即为开启）；
4. 点击右下角的「Apply & restart」，Docker 会自动重启，集成配置生效（重启约 1-2 分钟）。

4、验证关联成功

1. 打开 Ubuntu 终端，输入以下命令：

      docker --version

1. 若正常输出版本号，说明 WSL2 与 Docker 关联成功；
2. 再输入以下命令，测试 Docker 能否正常运行：

     docker run hello-world

5、这里在拉取docker镜像时报错

在docker desktop关联wsl 的ubuntu时，会生成 ~/.docker/config.json文件，里面写了 "credsStore": "desktop"，删除~/.docker/config.json文件即可。

然后使用docker.io/library/hello-world:latest - 镜像下载 | docker.io查找镜像拉取并启动即可。

6、优化：免 sudo 执行 Docker 命令（可选，提升体验）

默认情况下，在 Ubuntu 终端中执行 Docker 命令需要加 sudo（输入密码），可通过以下命令设置免 sudo，提升使用体验：

# 将当前用户加入 docker 用户组
sudo usermod -aG docker $USER
# 刷新组权限（无需重启终端）
newgrp docker

设置完成后，再执行 docker run hello-world，无需输入密码即可正常运行。