Windows下Docker与WSL2配置全攻略-代码聚汇网

Windows下Docker与WSL2配置全攻略

抹茶柚子冰

1. Windows下运行Docker的完整指南

作为一名长期在Windows环境下使用Docker的开发者，我深知在这个过程中会遇到的各种"坑"。今天我就来详细分享一下我的实战经验，从BIOS设置到最终挂载网络硬盘，手把手带你走通整个流程。

1.1 为什么要在Windows下使用Docker？

虽然Docker原生是为Linux设计的，但在Windows下使用它也有很多实际需求。比如开发环境统一、快速部署测试环境，或者某些只能在Linux下运行的服务的开发调试。通过WSL2（Windows Subsystem for Linux 2），我们现在可以在Windows上获得接近原生的Docker体验。

提示：WSL2是微软推出的Linux子系统第二代，相比第一代，它使用了真正的Linux内核，性能大幅提升，特别适合运行Docker这类容器技术。

2. 环境准备与基础配置

2.1 BIOS虚拟化设置

首先，我们需要确保CPU的虚拟化支持已经开启。这个设置在BIOS中，不同主板的进入方式可能不同（通常是开机时按Del、F2或F12）。

进入BIOS后，找到类似以下选项并启用：

Intel CPU：Intel Virtualization Technology (VT-x)
AMD CPU：AMD-V

常见问题：如果你在任务管理器的"性能"标签页中看不到"虚拟化：已启用"的提示，说明BIOS设置可能有问题，需要重新检查。

2.2 Windows功能启用

在Windows中，我们需要启用几个关键功能：

打开"控制面板"→"程序"→"启用或关闭Windows功能"
勾选以下选项：
- Hyper-V
- 适用于Linux的Windows子系统
- 虚拟机平台

完成后需要重启电脑。重启后，可以通过任务管理器确认虚拟化是否已启用。

3. WSL2与Ubuntu安装

3.1 安装WSL2内核更新

微软提供了一个专门的更新包来支持WSL2。我们需要下载并安装：

下载地址：微软官网搜索"WSL2 Linux内核更新包"
运行下载的.msi文件完成安装

3.2 安装Ubuntu发行版

打开Microsoft Store，搜索"Ubuntu"
选择最新的LTS版本（如Ubuntu 20.04 LTS）安装
安装完成后首次启动，会提示设置用户名和密码
设置完成后关闭窗口

3.3 转换为WSL2模式

打开PowerShell（管理员身份），执行以下命令：

bash复制wsl --set-version Ubuntu 2

这个命令会将我们刚安装的Ubuntu从WSL1升级到WSL2。转换完成后，可以通过以下命令验证：

bash复制wsl -l -v

应该能看到Ubuntu后面显示版本为2。

4. Docker安装与配置

4.1 在Ubuntu中安装Docker

现在我们可以开始在Ubuntu中安装Docker了：

首先更新软件包列表：

bash复制sudo apt update

安装必要的依赖：

bash复制sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

添加Docker官方GPG密钥：

bash复制curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

添加Docker仓库：

bash复制sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

再次更新并安装Docker：

bash复制sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

验证安装：

bash复制sudo docker run hello-world

如果看到欢迎信息，说明Docker已经成功安装并运行。

4.2 配置非root用户使用Docker

默认情况下，运行Docker命令需要sudo权限。为了方便使用，我们可以将当前用户加入docker组：

bash复制sudo usermod -aG docker $USER

然后需要重新登录WSL会话使更改生效。

5. 网络存储挂载实战

5.1 两种挂载方式比较

在Windows下使用Docker时，我们经常需要访问网络存储。主要有两种方式：

直接在Ubuntu中通过SMB挂载：
- 优点：性能较好
- 缺点：配置复杂，权限管理麻烦
通过Windows挂载再映射到WSL：
- 优点：配置简单，权限继承Windows设置
- 缺点：性能略低

根据我的经验，第二种方法更适合大多数场景，下面详细介绍这种方法。

5.2 Windows端网络驱动器映射

在Windows文件资源管理器中，右键"此电脑"→"映射网络驱动器"
选择一个盘符（如Y:）
输入网络路径（如\server\share）
勾选"重新连接时重新连接"
输入凭据（如果需要）

5.3 WSL中挂载Windows驱动器

在Ubuntu终端中执行：

bash复制sudo mkdir -p /home/yourusername/vol1
sudo mount -t drvfs Y: /home/yourusername/vol1

这样就将Windows下的Y:驱动器挂载到了WSL中的指定目录。

5.4 设置自动挂载

为了避免每次重启都要手动挂载，我们可以编辑/etc/fstab文件：

bash复制sudo nano /etc/fstab

添加以下行（根据你的实际情况修改）：

code复制Y: /home/yourusername/vol1 drvfs defaults 0 0

保存后，下次启动时会自动挂载。

注意事项：WSL2的自动挂载有时会有延迟，如果Docker启动时挂载点还没准备好，可能会导致容器启动失败。解决方法是在Docker启动后再挂载，或者使用脚本确保顺序。

6. Docker使用技巧与优化

6.1 配置Docker守护进程

为了提高性能，我们可以调整Docker的配置。创建或编辑/etc/docker/daemon.json：

json复制{
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://registry.docker-cn.com"
  ]
}

然后重启Docker服务：

bash复制sudo service docker restart

6.2 数据卷的最佳实践

在WSL2中使用Docker时，数据管理有几个建议：

重要数据不要放在WSL2文件系统中，因为它的磁盘映像可能会损坏
使用Windows挂载的目录作为数据卷更安全
对于数据库等IO密集型应用，考虑直接使用Windows路径

例如，运行MySQL容器时可以这样：

bash复制docker run -d \
  --name mysql \
  -v /home/yourusername/vol1/mysql:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=yourpassword \
  mysql:latest

6.3 网络配置技巧

WSL2使用自己的虚拟网络，有时会导致网络访问问题。几个有用的命令：

查看WSL2的IP地址：

bash复制ip addr show eth0

从Windows访问WSL2中的服务：

bash复制# 在Windows PowerShell中
wsl hostname -I

然后就可以用这个IP访问WSL2中运行的服务了。

7. 常见问题与解决方案

7.1 WSL2启动失败

问题现象：启动WSL时提示"参考的对象类型不支持尝试的操作"

解决方案：

下载NoLsp工具：https://github.com/dyingsu/nolsp
以管理员身份运行CMD
执行：nolsp.exe C:\windows\system32\wsl.exe
重启电脑

7.2 Docker命令速度慢

问题原因：WSL2的DNS解析有时会有问题

解决方案：
创建或编辑/etc/wsl.conf：

ini复制[network]
generateResolvConf = false

然后在/etc/resolv.conf中添加：

code复制nameserver 8.8.8.8
nameserver 8.8.4.4

7.3 磁盘空间不足

问题原因：WSL2的虚拟硬盘会不断增长但不会自动收缩