Windows + WSL2 安装 Docker 并配置国内镜像源教程

本文教程适用于 Windows 10 / 11 系统，通过 WSL2 (Windows Subsystem for Linux 2) 安装 Ubuntu，并在其中配置 Docker 和国内镜像加速器（包括 https://docker.1ms.run 和 https://docker.xuanyuan.me）。

1️⃣ 安装 WSL2

1. 打开 管理员 PowerShell，执行：

wsl --install

• 这条命令会自动安装 WSL2，并安装默认 Ubuntu 发行版。
• 如果你的系统未启用 WSL2 或虚拟机平台功能，请先启用：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

然后重启电脑，再执行 wsl --install。

1. 设置 WSL2 为默认版本：

wsl --set-default-version 2

1. 启动 Ubuntu：

wsl

2️⃣ 更新系统并安装 Docker

进入 Ubuntu 终端后：

1. 更新软件源：

sudo apt update

1. 安装 Docker：

sudo apt install -y docker.io

1. 启动 Docker 服务：

sudo service docker start

1. 可选：将当前用户加入 Docker 用户组，避免每次都使用 sudo：

sudo usermod -aG docker $USER

退出终端重新进入使权限生效。

3️⃣ 配置国内镜像加速器

为了在中国大陆快速拉取 Docker 镜像，我们添加国内镜像源。

1. 创建 Docker 配置目录：

sudo mkdir -p /etc/docker

1. 编辑 daemon.json：

sudo nano /etc/docker/daemon.json

1. 添加如下内容：

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xuanyuan.me"
  ]
}

注意：如果 JSON 文件中已有内容，请保留原有内容，确保格式合法。

1. 保存并退出编辑器（在 nano 中按 Ctrl+O 回车保存，Ctrl+X 退出）。
2. 重启 Docker 服务，使配置生效：

sudo service docker restart

4️⃣ 检查 Docker 配置

1. 查看 Docker 信息，确认镜像加速器是否生效：

docker info

输出中应包含：

Registry Mirrors:
 https://docker.1ms.run
 https://docker.xuanyuan.me

1. 测试拉取镜像：

docker pull hello-world

• 如果成功，会显示拉取镜像及运行容器的相关信息：

Hello from Docker!
This message shows that your installation appears to be working correctly.

5️⃣ 完整命令总结

# 进入 WSL2 Ubuntu
wsl
​
# 更新系统并安装 Docker
sudo apt update
sudo apt install -y docker.io
sudo service docker start
sudo usermod -aG docker $USER
​
# 配置国内镜像加速器
sudo mkdir -p /etc/docker
sudo nano /etc/docker/daemon.json
# 内容：
# {
#   "registry-mirrors": [
#     "https://docker.1ms.run",
#     "https://docker.xuanyuan.me"
#   ]
# }
sudo service docker restart
​
# 查看 Docker 配置
docker info
​
# 测试拉取镜像
docker pull hello-world

✅ 注意事项

1. 如果 docker pull 仍然超时，可尝试：
   • 检查 WSL2 是否能访问互联网：ping www.baidu.com
     ping registry-1.docker.io
   • 必要时配置代理。
2. 确保 daemon.json JSON 格式正确，否则 Docker 启动会报错。
3. 国内镜像源可以同时配置多个，Docker 会按顺序尝试访问。

这个教程可以让你在 Windows + WSL2 环境中顺利安装 Docker，并使用国内镜像加速拉取镜像。