WSL2运行Docker详细教程

本文详细介绍了如何在 Windows 系统中通过 WSL2 原生运行 Docker，既可手动部署 Docker Engine 并配置 Windows CLI 远程连接（绕过 Docker Desktop 和 Hyper-V 依赖），也可选择更便捷的 Docker Desktop WSL2 集成模式；涵盖从启用 WSL2、安装 Ubuntu 22.04+、配置 systemd 持久化 dockerd，到设置 DOCKER_HOST 环境变量和验证容器运行的完整实战路径，为开发者提供轻量、高效、贴近 Linux 原生体验的本地容器开发环境搭建指南。

如果您希望在 Windows 系统中利用 WSL2 作为后端运行 Docker 容器开发环境，则需绕过 Windows Desktop 的 Hyper-V 依赖，改用 WSL2 原生集成的轻量级虚拟化能力。以下是实现该目标的具体操作路径：

一、启用 WSL2 并安装指定发行版

WSL2 需要先在系统中启用并完成内核更新，再安装支持 systemd 的 Linux 发行版（如 Ubuntu 22.04+），以满足 Docker daemon 的运行依赖。

1、以管理员身份打开 PowerShell，执行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

2、再次执行：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

3、下载并安装 WSL2 Linux kernel update package（从 Microsoft 官方文档页获取最新 .msi 文件）

4、重启计算机后，在 PowerShell 中运行：wsl --set-default-version 2

5、通过 Microsoft Store 安装 Ubuntu 22.04 LTS，启动后完成初始用户配置

二、在 WSL2 发行版中部署 Docker Engine

Docker Engine 不支持直接在 WSL2 默认用户空间中以 service 形式长期运行，需手动启动 dockerd，并确保其监听在 WSL2 内部套接字路径上，供 Windows 端 CLI 调用。

1、进入 Ubuntu 终端，运行：sudo apt update && sudo apt install -y curl gnupg2 software-properties-common

2、添加 Docker 官方 GPG 密钥：curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

3、添加稳定版仓库源：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

4、安装 Docker Engine：sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io

5、创建 dockerd 启动脚本：echo '#!/bin/sh\nsudo dockerd --host=unix:///var/run/docker.sock --host=tcp://127.0.0.1:2375 --iptables=false' | sudo tee /usr/local/bin/start-docker.sh

6、赋予执行权限：sudo chmod +x /usr/local/bin/start-docker.sh

三、配置 Windows 端 Docker CLI 连接 WSL2 后端

Windows 上的 docker.exe 命令行工具可直接复用，只需将其通信目标重定向至 WSL2 中运行的 dockerd 实例，无需安装 Docker Desktop。

1、在 Windows PowerShell 中设置环境变量：$env:DOCKER_HOST="tcp://127.0.0.1:2375"

2、将该变量写入用户环境配置（如 PowerShell 的 $PROFILE），确保每次启动自动生效

3、验证连接有效性：docker version --format '{{.Server.Version}}' 应返回 WSL2 中 Docker Engine 的版本号

4、运行测试容器：docker run --rm hello-world，输出成功日志即表示链路通达

四、启用 systemd 支持以持久化 dockerd 进程

WSL2 默认不加载 systemd，导致无法使用 systemctl 管理 dockerd；但可通过修改 WSL2 配置文件强制启用，使 dockerd 在发行版启动时自动就绪。

1、在 Windows 中创建或编辑文件：%USERPROFILE%\AppData\Local\Packages\\wsl.conf（UbuntuPackageID 可通过 wsl -l -v 查得）

2、在 wsl.conf 中添加两行：[boot]\nsystemd=true

3、关闭所有 WSL 实例：wsl --shutdown

4、重启 Ubuntu，执行：ps -e | grep systemd，确认进程存在

5、启用 Docker 服务：sudo systemctl enable docker && sudo systemctl start docker

五、替代方案：使用 Docker Desktop 的 WSL2 后端模式

若接受图形界面依赖，Docker Desktop 提供原生 WSL2 集成模式，自动配置 socket 转发与资源隔离，无需手动部署 dockerd。

1、卸载任何已存在的独立 Docker Engine 安装，避免端口冲突

2、下载 Docker Desktop for Windows（v4.18+），安装时勾选 Use the WSL2 based engine

3、在 Docker Desktop 设置中进入 Resources → WSL Integration，启用对应发行版（如 Ubuntu-22.04）

4、在 WSL2 终端中执行：docker context ls，确认 desktop-linux 上下文处于 active 状态

5、运行：docker run -it --rm alpine sh -c "echo 'Running in WSL2 via Docker Desktop'"

终于介绍完啦！小伙伴们，这篇关于《WSL2运行Docker详细教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！