Windows 下使用 WSL 快速部署 Docker 环境

为什么要使用 Docker

传统发布模式需要开发与运维合作，开发打包代码并告知环境要求，由运维配置生产环境。这种方式容易导致开发环境与生产环境不一致，影响运行效果。Docker 允许将代码及依赖环境一并打包，确保环境同步，避免差异问题。

部署 Docker

前置条件

• 系统版本：Windows 10 需升级到 2004 及以上版本（Build 19041+）；Windows 11 原生支持。
• 硬件虚拟化：需在 BIOS 中开启 Virtualization Technology（VT-x/AMD-V）。
• 权限：执行 wsl/dism 相关命令需管理员身份。

基础环境搭建

开启 WSL 2

以管理员身份打开 CMD 或 PowerShell，输入：

wsl --install

该命令会自动启用 WSL 功能、安装内核更新及默认 Linux 发行版（Ubuntu）。若仅显示用法说明，说明已启用 WSL 但未安装发行版，需手动指定。

指定发行版安装

查看可用发行版：

wsl --list --online

手动安装指定版本（如 Ubuntu 24.04）：

wsl --install -d Ubuntu-24.04

常见问题处理

1. 缺少内核更新包：参照更新 WSL 步骤操作。
2. 无法设置 WSL 2 为默认版本：

   wsl --set-default-version 2
   

3. 功能未启用：

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

   执行后重启电脑。

验证安装

查看已安装的 WSL 发行版及版本：

wsl --list --verbose

查看 WSL 版本：

wsl --version

启动 Ubuntu 后按提示设置用户名和密码。

更换国内源

备份源文件：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

替换为阿里云源（Ubuntu 24.04）：

sudo tee /etc/apt/sources.list > /dev/null <<EOF
deb http://mirrors.aliyun.com/ubuntu/ noble main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ noble-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ noble-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ noble-backports main restricted universe multiverse
EOF