Docker 在 WSL2（Ubuntu 22.04）上的安装指南 | 极客日志

Shell / Bash

Docker 在 WSL2（Ubuntu 22.04）上的安装指南

详细记录了在 Windows 10/11 系统的 WSL2 环境下，基于 Ubuntu 22.04 安装 Docker Engine 的完整流程。内容涵盖环境准备、旧版本卸载、依赖包安装、官方源配置、Docker 组件安装、用户权限配置及服务启动等关键步骤。同时提供了验证安装成功的方法以及针对国内环境的镜像加速方案，旨在帮助用户解决网络超时和 GPG 验证失败等常见问题，实现无订阅限制的 Docker 社区版部署。

赛博朋克发布于 2026/3/30更新于 2026/4/131 浏览

本文介绍在 Windows 10/11 系统基于 WSL2+Ubuntu 22.04 环境安装 Docker Engine 的步骤，解决网络超时及 GPG 验证问题。

一、前置准备（确保环境干净）

首先启动并进入 Ubuntu 22.04 的 WSL 终端：

在 Windows 的 PowerShell 中执行 wsl -d Ubuntu-22.04 进入 Ubuntu 终端；

先卸载可能存在的旧版 Docker（避免冲突）：

sudo apt-get remove docker docker-engine docker.io containerd runc

sudo apt-get update && sudo apt-get install -y ca-certificates curl gnupg lsb-release

# 创建密钥存储目录
sudo mkdir -p /etc/apt/trusted.gpg.d
# 下载并导入 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 将当前用户加入 docker 用户组
sudo usermod -aG docker $USER
# 刷新用户组（无需重启，立即生效）
newgrp docker

# 查看 Docker 版本
docker --version
# 运行测试容器（验证 Docker 能否正常工作）
docker run hello-world

sudo service docker start
# 设置开机自启（可选）
sudo systemctl enable docker

# 确保 Docker 配置目录存在
sudo mkdir -p /etc/docker
# 写入国内镜像源
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
EOF