安装 WSL 并启用必要功能

确保系统为 Windows 10 2004 及以上版本或 Windows 11。以管理员身份打开 PowerShell,运行以下命令启用 WSL 和虚拟机平台功能:

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

重启计算机后,将 WSL 2 设为默认版本:

wsl --set-default-version 2

安装 Linux 发行版

从 Microsoft Store 安装 Ubuntu 22.04 LTS。安装完成后启动 Ubuntu,按提示创建用户名和密码。更新系统软件包:

sudo apt update && sudo apt upgrade -y

安装 Docker 引擎

在 WSL 终端中执行以下命令安装 Docker:

sudo apt install -y docker.io
sudo service docker start

将当前用户加入 docker 组避免频繁使用 sudo:

sudo usermod -aG docker $USER
newgrp docker

验证 Docker 安装

运行测试容器验证环境:

docker run hello-world

确认输出包含 "Hello from Docker!" 字样。检查版本信息:

docker --version
docker-compose --version

配置 Docker 服务自启动

由于 WSL 不支持 systemd,需手动配置。创建或编辑 ~/.bashrc 文件:

echo "sudo service docker start" >> ~/.bashrc

关闭并重新打开终端使配置生效。

常见问题处理

若遇到网络问题,可配置 Docker 镜像加速器。创建 /etc/docker/daemon.json 文件:

{
  "registry-mirrors": ["https://registry.docker-cn.com"]
}

重启 Docker 服务:

sudo service docker restart

更多推荐