WSL2中安装Docker—部署Docker Engine方案

原创 已于 2025-05-07 09:05:36 修改 · 7.9k 阅读 · 96 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#docker #容器 #运维

于 2024-11-30 21:11:57 首次发布

目录

一、介绍

二、与Docker Desktop区别

三、开启WSL2服务

四、WSL2的常用命令 

五、安装Ubuntu系统

六、安装Docker及可视化工具

七、WSL2与宿主机共享相同的网络

1、环境要求

2、配置 .wslconfig 文件

3、重启 WSL2

4、验证镜像网络模式

5、解决常见问题

一、介绍

在WSL2中安装Docker主要有以下两种常见的方法：使用Docker Desktop for Windows（配置WSL2作为后端）和直接在WSL2中安装Docker Engine。本文详细介绍如何在WSL2中安装Docker Engine，并探讨这种方法相对于使用Docker Desktop的优势和注意事项。

实验环境为Windows11 专业版，Linux版本为Ubuntu。

二、与Docker Desktop区别

Docker是一种广泛使用的容器化平台，它允许开发者将应用程序及其依赖项打包到一个可移植的容器中，以便在任何地方都能够以相同的方式运行。在Windows操作系统上，Docker Desktop是一种流行的Docker安装方式，它提供了一个用户友好的图形界面，使得安装和管理Docker变得非常简单，但它同时存在一些局限性和不完善的地方。

  • 一些功能在Docker Desktop上可能无法完全发挥作用，或者仍处于试验阶段，这可能会影响到使用体验。
  • Docker Desktop作为一个独立的应用程序，会占用一定的系统资源，并且可能与其他应用程序产生冲突

为了解决这些问题，一种替代方案是在Windows Subsystem for Linux 2（WSL2）中直接安装Docker Engine。通过在WSL2中安装Docker Engine，开发者可以获得更原生的Docker体验，并且可以避免Docker Desktop的一些限制和问题。 

三、开启WSL2服务

1、开启CPU虚拟化

打开任务管理器(Ctrl+Alt+Esc)，切换到性能，可以在如图中看到CPU虚拟化的状态，默认是禁用，需要进入Bios开启

2、启用虚拟机平台功能

点击【启动或关闭 Windows 功能】

勾选【适用于 Linux 的 Windows 子系统】和【虚拟机平台】这两项

勾选后必须要重启系统才能生效

3、设置WSL的版本为WSL2

按  Win+X 启动 终端(管理员)

设置WSL的版本为WSL2

wsl --set-default-version 2

更新WSL为最新版

wsl --update

四、WSL2的常用命令 

为了便于读者进行相关调试，这里顺便介绍一些WSL中常用的命令

#执行以下命令将启用运行WSL，并安装默认的Ubuntu发行版
wsl --install

#如果想安装其他发行版，可以使用-d标志
wsl --install -d Ubuntu-24.04

#要了解当前WSL2支持的Linux发行版，可以使用这个命令
wsl --list --online

#列出已安装的 WSL 发行版
wsl -l

#设置为默认使用系统版本，例如设置22.04的为默认版本
wsl --set-default Ubuntu-22.04

#关闭所有正在运行的 WSL 实例
wsl --shutdown

#注销并删除一个 WSL 发行版
wsl --unregister <DistroName>

#更新 WSL 到最新版本
wsl --update

#显示 WSL 的状态，包括版本信息
wsl --status

#从 tar 文件导入 WSL 发行版
wsl --import <DistroName> <InstallLocation> <FileName>

#将 WSL 发行版导出到 tar 文件
wsl --export <DistroName> <FileName>

#终止指定的 WSL 发行版
wsl --terminate <DistroName>

五、安装Ubuntu系统

#执行以下命令将启用运行WSL，并安装默认的Ubuntu发行版
wsl --install

#如果想安装其他发行版，可以使用-d标志
wsl --install -d Ubuntu-24.04

#要了解当前WSL2支持的Linux发行版，可以使用这个命令
wsl --list --online

1、查看当前WSL2可安装的Linux发行版 

 2、安装Ubuntu-24.04版本

wsl --install -d Ubuntu-24.04

 3、在WIndows Terminal上，可以找到安装的发行版本

4、系统是首次启动时，需要设置一个用户名和密码

 5、在Windows Termimal上，进入默认WSL系统和退出WSL系统

#Windows终端进入默认WSL系统命令
bash

#WSL系统回退Windows终端命令
exit

六、安装Docker及可视化工具

WSL2中安装好Ubuntu系统后，Docker的安装与直接在Ubuntu物理机上是一样的。

Docker及可视化工具的安装可参考：Ubuntu上安装 Docker及可视化管理工具

七、WSL2与宿主机共享相同的网络

默认情况下，WSL2 使用 NAT 网络模式，与宿主机处于不同的网段。默认的网络配置可能会导致一些网络互通性问题，例如无法通过 localhost 访问 WSL2 中的服务，或者在局域网中无法访问 WSL2 中的服务。为了解决这些问题，Windows 11 23H2 及以上版本引入了 networkingMode=mirrored 配置，使 WSL2 与 Windows 主机共享相同的网络配置。接下来将详细介绍如何设置 WSL2 Ubuntu 的 networkingMode=mirrored，并解决常见问题。

1、环境要求

在开始之前，请确保满足以下环境要求

  • Windows 版本：Windows 11 23H2 或更高版本
  • WSL 版本：WSL2 2.0.0 或更高版本

可以通过以下命令检查 WSL 版本

wsl --version

如果版本低于 2.0.0，可以通过以下命令更新

wsl --update --pre-release

2、配置 .wslconfig 文件

2.1、创建或编辑 .wslconfig 文件

打开 PowerShell 或命令提示符，输入以下命令创建或编辑 .wslconfig 文件：

notepad $env:USERPROFILE\.wslconfig

如果文件已存在，直接编辑即可。

2.2、添加镜像网络配置

在 .wslconfig 文件中添加以下内容：

[wsl2]
networkingMode=mirrored # 启用镜像网络模式，使 WSL2 与 Windows 共享网络
dnsTunneling=true # 启用 DNS 隧道，提高与 VPN 等复杂网络的兼容性
autoProxy=true # 同步 Windows 的代理设置到 WSL2
firewall=true # WSL同步Windows防火墙规则

[experimental]
autoMemoryReclaim=gradual # 可以在gradual 、dropcache 、disabled之间选择，开启会造成WSL中Docker启动异常
sparseVhd=true # 自动清理磁盘空间
hostAddressLoopback=true # 允许通过主机的局域网 IP 访问 WSL2 中的服务
  • networkingMode=mirrored：启用镜像网络模式，使 WSL2 与 Windows 共享网络。
  • dnsTunneling=true：启用 DNS 隧道，提高与 VPN 等复杂网络的兼容性。
  • autoProxy=true：同步 Windows 的代理设置到 WSL2。
  • firewall=true：WSL同步Windows 防火墙规则
  • autoMemoryReclaim=gradual # 可以在gradual 、dropcache 、disabled之间选择，开启会造成WSL中Docker启动异常
  • sparseVhd=true # 自动清理磁盘空间
  • hostAddressLoopback=true：允许通过主机的局域网 IP 访问 WSL2 中的服务

3、重启 WSL2

完成配置后，重启 WSL2 以应用更改：

wsl --shutdown

等待几秒后重新启动 WSL2。

4、验证镜像网络模式

在 WSL2 中运行以下命令查看 IP 地址：

ip addr show eth0

如果 IP 地址与 Windows 主机的 IP 地址一致，说明镜像网络模式已启用。 

    5、解决常见问题

    5.1、Docker 容器无法通过 localhost 访问

    如果使用 Docker，需要在 /etc/docker/daemon.json 中添加以下配置：

    {
  "iptables": false
}

    然后重启 Docker 服务：

    sudo service docker restart
    在 Windows 上安装 WSL 和 Docker
    iCloudEnd的博客
    06-22 1984
    在这个简短的教程中，我们将在 Windows 11（或 Windows 10）上安装 WSL 和 Docker。Docker 允许我们在不影响我们的主操作系统的情况下运行容器化应用程序。安装 WSL 和 Docker 后，我们将运行“hello-world”容器来确认 docker 是否正常运行。
    【项目实战】WSL2 安装Docker Windows使用命令行
    本本本添哥
    05-16 455
    通过以上步骤，你可以在 WSL2 上成功安装并配置 Docker，从而在 Windows 环境中高效地进行开发和容器化操作。如果一切正常，你应该会看到一条欢迎信息，表明 Docker 已经成功安装并运行。首先，确保 Windows 系统已启用 WSL2。为了使组更改生效，需要重启 WSL2 会话。下载 Docker Desktop 安装包，并按照提示完成安装。然后重新打开 WSL2 终端。
    弃用Docker Desktop：在WSL2中玩转Docker之Docker Engine 部署与WSL入门
    jclee95的个人博客
    06-13 5292
    本文介绍基于WSL2的基础用于，以及基于WSL2，部署Docker Engine，实验环境为Windiws11，部署Docker Engine的Linux为Ubuntu发行版本。
    WSL2 安装与Docker安装
    www.passlink.cn
    06-01 1552
    WSL2 安装与Docker安装
    Docker快速入门——Windowns系统下Docker安装（2025最新理解与完整，附带WSL1如何升级为WSL2）
    最新发布
    2403_82491400的博客
    10-14 3777
    Windows 系统安装 Docker 时推荐先安装 WSL 2（Windows Subsystem for Linux 2），主要是因为 Docker 本质上是为 Linux 设计的容器技术，而 WSL 2 为 Windows 提供了一个轻量级、高性能的 Linux 内核环境，使 Docker 能在 Windows 上原生、高效地运行。以管理员身份打开PowerShell（按下 Win + R 键，打开“运行”对话框。以管理员身份打开PowerShell（按下 Win + R 键，打开“运行”对话框。
    Windows使用wsl2安装docker教程
    热门推荐
    Peter Cheung的博客
    01-19 1万+
    本文安装docker，将使用WSL2，而不是vmeare和Hyper-V，也不需要你另外安装Linux系统（如Ubuntu）。查阅资料均来自官网文档（微软官网和docker官网）。下面让我们开始吧！
    win11安装通过WSL安装docker
    何忆清风
    11-04 1万+
    win11安装docker
    【WSL2系列】（三）安装Docker Windows版
    juwikuang的专栏
    08-02 3492
    现在WSL已经越来越流行了。很多软件都开始支持WSL了。 比如MobaXterm，我刚刚装好，就惊奇的发现，WSL已经在那里了。 （我先装的WSL） 同样的，Docker Windows版，也自动使用WSL2作为后台了。 我是先装的WSL2，再装Docker。等我点完了下一步，就Okay了。 这时，因为我们装的是Docker Windows版，所以，我们当然可以在Docker的各种命令行程序中运行docker。并且，我们用的是WSL2后台，所以，我们也可以在WSL2中运行程序。 这样就达到了在WSL2和
    wsl2中安装docker
    陶陶name
    07-16 3296
    这个脚本在执行之前需要先执行chmod +x install-docker.sh这个命令。如果希望每次启动的时候，都给docker启动的话，可以执行下面的这个命令。执行docker version,如果如下所示，则表示安装成功了。这个问题的话，需要执行下面的命令，然后选择1。再推出terminal重新进。
    WSL2安装Docker
    qq_46416934的博客
    08-27 1万+
    推荐阅读知乎版，排版更好一点。
    在 WSL2的 Ubuntu 20.04 中安装 Docker
    luohaitao的专栏
    04-09 1168
    在 WSL2 的 Ubuntu 中，当你运行 sudo systemctl status docker 后，命令会持续输出 Docker 服务的实时状态日志，并占用当前终端（类似“实时监控”模式），导致你无法直接输入其他命令。这是正常行为，因为 status 命令默认会保持活跃状态（除非服务已停止）。
    在 WSL2 中安装 Ubuntu 并安装 Docker
    Ynxv_764的博客
    03-15 1588
    1. 安装WSL 2. Ubuntu 中文环境设置 3. Ubuntu 中安装Docker 4. 在WSL2中启用systemctl
    Windows安装WSL子系统及docker，以及WSL和docker配置、使用及问题解决
    sym的博客
    12-11 8582
    在Windows操作系统中，Ubuntu子系统（也称为Windows Subsystem for Linux, WSL）为开发者提供了一个在Windows环境下运行Linux环境的平台。然而，有时用户在按照Ubuntu子系统或者使用WSL时，可能会遇到各种问题，下面总结一下解决方式。想要在Windows上安装Docker（实际上是基于Hyper-V或者WSL2这两项虚拟化技术），需要开启虚拟化功能，所以不管是对于系统还是硬件都有一定的要求。
    window下使用linux子系统及基于wsl2安装docker
    S_ZaiJiangHu的博客
    03-13 8367
    wsl2是linux子系统内核，windows内置了它。 1、下载docker for windows 2、应用程序功能 开启虚拟机和linux子系统 3、安装docker 4、可能提示无法运行，需要升级linux内核，https://docs.microsoft.com/zh-cn/windows/wsl/install-manual#step-4—download-the-linux-kernel-update-package下载下就好 ...
    Windows wsl2安装Docker
    天河有尽后为涯，星海无边前作岸。
    02-25 1223
    由于众所周知的原因，国内访问国外的某些网站会访问不了或者访问极慢，Docker的安装网站就在其中。wsl2的Ubuntu安装好后，就可以安装Docker了。Windows 10 专业版 22H2。5、运行hello-world测试。提示则代表Docker运行正常了。所以推荐使用阿里的镜像进行安装。1、使用官方脚本自动安装。3、查看Docker状态。4、启动Docker。
    在本地windows中利用wsl2部署docker应用
    m0_62177801的博客
    06-30 4673
    如何将应用部署到docker中
    Win10或Win11 WSL2 安装Docker
    DN金猿的博客
    09-04 7759
    由于新款Mac性价比走低，近期转为使用Windows作为主力开发系统。但是在开发过程中需要上Linux测试，或者说部署一些服务，例如MySQL，Nexus OSS等。本人又是一个Docker重度依赖者。之前一直是长期在Windows下启动一个Linux虚拟机辅助开发操作。占用大量磁盘内存资源不说，操作和维护也极为繁琐。直到近期了解到Win10 2004正式版版本支持WSL2，问题得到了完美的解决。WSL2相比WSL1来说可以完美支持Docker。
    WSL2的安装以及在其下的Ubuntu安装docker、milvus教程
    yk
    03-16 9270
    本文介绍了wsl2安装和使用，并在其下安装的Ubuntu系统中安装和使用docker的教程
    wsl中怎么安装docker
    07-10
    在 Windows Subsystem for Linux (WSL) 中安装 Docker 需要一些特定的步骤，以确保 Docker 能够正确运行。以下是在 WSL 中安装 Docker 的详细指南： ### 1. 启用 WSL 和 安装 Linux 发行版 首先，确保你已经启用了 WSL 并安装了一个 Linux 发行版（如 Ubuntu）。 ```powershell # 启用 WSL 功能 wsl --install # 检查 WSL 版本 wsl --list --verbose ``` 如果你使用的是 Windows 10 或 Windows 11，并且尚未启用 WSL，可以通过上述命令启用它。安装完成后，你可以选择默认的 Linux 发行版，或者通过 Microsoft Store 安装你喜欢的发行版（如 Ubuntu、Debian 等）。 ### 2. 更新系统并安装依赖项 进入你的 WSL 环境后，首先更新系统并安装必要的依赖项： ```bash sudo apt update && sudo apt upgrade -y sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-core ``` ### 3. 添加 Docker 官方 GPG 密钥 接下来，添加 Docker 的官方 GPG 密钥以验证软件包的完整性： ```bash curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg ``` ### 4. 添加 Docker APT 仓库 根据你的 Ubuntu 版本，将 Docker 的 APT 仓库添加到系统的源列表中。假设你使用的是较新的 Ubuntu 版本（如 Focal 或 Jammy），可以使用以下命令： ```bash echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ``` ### 5. 安装 Docker 引擎 现在可以更新 APT 缓存并安装 Docker 引擎： ```bash sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io ``` 如果遇到 `E: Unable to locate package docker-ce` 错误，请确保你正确地添加了 Docker 的 APT 仓库，并且使用的 Ubuntu 版本与仓库中的版本匹配[^1]。 ### 6. 验证 Docker 安装 安装完成后，可以通过以下命令验证 Docker 是否成功安装并运行： ```bash sudo systemctl start docker sudo systemctl enable docker docker --version sudo docker run hello-world ``` 如果一切正常，你应该会看到一条欢迎信息，表明 Docker 已经成功安装并在 WSL 中运行。 ### 7. 可选：配置非 root 用户使用 Docker 为了避免每次使用 Docker 时都需要输入 `sudo`，可以将当前用户添加到 `docker` 组： ```bash sudo usermod -aG docker $USER ``` 然后退出并重新登录，以便使组更改生效。 ### 数据卷位置 Docker 在 WSL 中创建的数据卷通常位于以下路径中，具体取决于 Docker 的版本： - 对于 Docker Engine v20.10 及以上版本： ``` \\wsl$\docker-desktop-data\data\docker\volumes ``` - 对于 Docker Engine v19.03 及以下版本： ``` \\wsl$\docker-desktop-data\version-pack-data\community\docker\volumes\ ``` 这些路径可以直接在 Windows 文件资源管理器中访问，格式为 `\\wsl$`，表示 WSL 文件系统的根目录[^2]。 ### 常见问题排查 #### Docker Desktop 启动失败 如果你使用的是 Docker Desktop 并且在启动时遇到类似 `Failed to set version to docker-desktop exit code -1` 的错误，可能是因为 WSL2 内核版本不兼容或 Hyper-V 未正确安装。解决方法包括： - 确保 WSL2 已启用并且是默认版本。 - 检查是否已正确安装 Docker Desktop 的 WSL2 支持组件。 - 如果使用的是 Windows 10 Home Edition，确保已手动安装 Hyper-V 支持[^3]。 ---
    评论
    成就一亿技术人!
    拼手气红包6.0元
    还能输入1000个字符
     
    红包 添加红包
    表情包 插入表情
    表情包 代码片
     条评论被折叠 查看
    添加红包

    请填写红包祝福语或标题

    个

    红包个数最小为10个

    元

    红包金额最低5元

    当前余额3.43元 前往充值 >
    需支付：10.00元
    成就一亿技术人!
    领取后你会自动成为博主和红包主的粉丝 规则
    hope_wisdom
    发出的红包
    实付元
    使用余额支付
    点击重新获取
    扫码支付
    钱包余额 0

    抵扣说明：

    1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
    2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

    余额充值