Windows系统Docker安装与WSL2配置指南

1. Windows环境下Docker安装全攻略

作为一名在Windows平台使用Docker近五年的开发者，我深知在Windows上配置Docker环境的痛点。不同于Linux原生支持Docker，Windows需要通过虚拟化技术搭建Linux环境才能运行Docker。本文将详细解析Windows安装Docker的完整流程，包括WSL2配置、系统要求检查、常见问题排查等关键环节，并提供多个实测有效的优化技巧。

2. 环境准备与系统检查

2.1 操作系统版本要求

Docker Desktop for Windows要求必须是Windows 10或11的64位系统，且版本号需满足：

• Windows 10：版本2004（Build 19041）或更高
• Windows 11：所有版本均支持

检查方法：

1. 按Win+R输入"winver"查看版本号
2. 或进入"设置 > 系统 > 关于"查看系统信息

注意：家庭版Windows需要先升级到专业版或企业版才能使用Hyper-V功能。如果不想升级系统，可以仅使用WSL2后端。

2.2 硬件虚拟化支持检查

现代CPU都支持虚拟化技术（Intel VT-x或AMD-V），但可能需要在BIOS中启用：

1. 打开任务管理器（Ctrl+Shift+Esc）
2. 切换到"性能"标签页
3. 查看CPU部分是否显示"虚拟化：已启用"

如果显示禁用，需要：

1. 重启进入BIOS/UEFI设置（通常按Del/F2/F12键）
2. 找到Virtualization Technology或类似选项
3. 设置为Enabled
4. 保存退出

2.3 系统功能启用

不同于网上大多数教程建议的，实际只需要启用两个功能：

1. 适用于Linux的Windows子系统（WSL基础支持）
2. 虚拟机平台（WSL2必需组件）

操作步骤：

powershell复制# 使用管理员权限打开PowerShell执行：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启后，将WSL2设为默认版本：

powershell复制wsl --set-default-version 2

3. WSL2安装与配置

3.1 一键安装WSL2

微软提供了极简安装方式：

powershell复制wsl --install

这个命令会自动完成：

1. 启用WSL相关功能
2. 下载最新Linux内核更新包
3. 安装Ubuntu发行版
4. 设置WSL2为默认版本

3.2 手动安装（可选）

如果需要特定Linux发行版：

1. 在Microsoft Store搜索并安装喜欢的发行版（如Ubuntu、Debian）
2. 设置WSL版本：

   powershell复制wsl --set-version <发行版名称> 2
   

3.3 WSL磁盘管理技巧

默认情况下WSL虚拟磁盘存放在系统盘，可以通过以下方式管理：

1. 查看磁盘位置：

   powershell复制wsl --list -v
   

2. 导出/导入实现迁移：

   powershell复制wsl --export Ubuntu ubuntu.tar
   wsl --import UbuntuNew D:\wsl\ ubuntu.tar --version 2
   

3. 清理无用文件：

   powershell复制wsl --shutdown
   diskpart
   select vdisk file="C:\Users\<用户名>\AppData\Local\Packages\<发行版>\LocalState\ext4.vhdx"
   compact vdisk
   

4. Docker Desktop安装详解

4.1 下载与安装

1. 从官网下载稳定版安装包
2. 安装时注意：
   • 安装路径不可更改（默认在C:\Program Files\Docker）
   • 建议勾选"Add shortcut to desktop"
   • 安装完成后不要立即启动

4.2 关键配置项

首次启动前建议配置：

1. 资源限制（Settings > Resources）：

   • CPU：建议不超过逻辑核心数的75%
   • 内存：根据主机内存调整，8GB机器建议4-6GB
   • 磁盘：镜像存储位置可更改到大容量分区

2. WSL集成（Settings > Resources > WSL Integration）：

   • 启用已安装的WSL发行版
   • 建议关闭"Start Docker Desktop when you log in"

4.3 验证安装

在PowerShell中测试：

powershell复制docker run --rm hello-world

成功运行会显示欢迎信息。如果遇到错误：

1. 确认Docker Desktop已运行
2. 检查WSL状态：

   powershell复制wsl -l -v
   

3. 重启Docker服务：

   powershell复制net stop com.docker.service
   net start com.docker.service
   

5. Docker核心概念实践

5.1 镜像管理

1. 拉取镜像：

   powershell复制docker pull ubuntu:20.04
   

2. 查看镜像：

   powershell复制docker images
   

3. 清理无用镜像：

   powershell复制docker image prune -a
   

5.2 容器操作

1. 启动交互式容器：

   powershell复制docker run -it --name my_ubuntu ubuntu:20.04 bash
   

2. 查看运行中的容器：

   powershell复制docker ps
   

3. 停止和删除容器：

   powershell复制docker stop my_ubuntu
   docker rm my_ubuntu
   

5.3 数据持久化

Windows与WSL2之间的文件访问：

1. Windows访问WSL文件：\\wsl$\<发行版名称>
2. WSL访问Windows文件：/mnt/c/...

容器数据卷使用：

powershell复制docker run -v D:/data:/container/path -d nginx

6. 性能优化与问题排查

6.1 常见性能问题

1. 文件IO慢：

   • 避免在Windows和WSL2之间频繁读写
   • 将项目代码放在WSL2文件系统中（如~/project）

2. 内存占用高：

   • 调整Docker内存限制
   • 定期清理无用容器和镜像

6.2 网络问题解决

1. 端口冲突：

   powershell复制netstat -ano | findstr :端口号
   

2. 重置网络：

   powershell复制docker network prune
   

6.3 常见错误处理

1. "WSL2 installation is incomplete"：

   • 下载并手动安装WSL2内核更新包
   • 执行wsl --update

2. "Docker Desktop stopped..."：

   • 重启LxssManager服务：

     powershell复制Get-Service LxssManager | Restart-Service
     

7. 进阶配置技巧

7.1 使用非默认发行版

1. 设置默认发行版：

   powershell复制wsl --set-default <发行版名称>
   

2. Docker Desktop会自动检测已启用的发行版

7.2 多版本Docker管理

通过Docker CLI切换上下文：

powershell复制docker context use desktop-linux

7.3 资源监控

使用内置监控工具：

powershell复制docker stats

或使用第三方工具如cAdvisor：

powershell复制docker run -d --name=cadvisor -p 8080:8080 --volume=/:/rootfs:ro --volume=/var/run:/var/run:ro --volume=/sys:/sys:ro --volume=/var/lib/docker/:/var/lib/docker:ro --volume=/dev/disk/:/dev/disk:ro gcr.io/cadvisor/cadvisor

经过以上步骤，你应该已经在Windows上成功搭建了完整的Docker开发环境。我在实际使用中发现，WSL2后端比传统Hyper-V模式性能更好，特别是在文件IO方面。对于开发者而言，这套环境已经可以满足绝大多数容器化开发需求。