win10家庭版wsl安装使用Docker踩坑

错误的原因

WSL作为微软自家支持的Linux子系统，在开发中已经被广泛应用，但依旧有不少坑，如果你打算在WSL中安装Docker，特别是在家庭中文版中安装，我强烈建议你看下去。

关于WSL1的安装与基本配置不再做详细叙述，百度都有详细的教程。

如果你是Win 10专业版用户，在Linux子系统中像常规的Linux安装Docker一样安装和使用Docker，参照官网设置（Ubuntu）：https://docs.docker.com/engine/install/ubuntu/

但如果是Win 10家庭版用户，即使在Linux子系统中按照官网常规引导安装之后，也无法正常启动和使用，因为无法启动daemon守护进程，就算一步一步到最后没有任何报错，也无法启动docker。

解决方案

在查阅了许多博客之后，终于找到了解决办法，就是Docker for Windows目前是默认支持WSL2的，也就是说，只需要将WSL升级为WSL2再安装Docker for Windows，WSL2的子系统中不需要进行任何的操作就可以共享Windows 10的Docker。

然后你十分激动地想要把WSL1升级到WSL2，发现需要除了启动WSL外，还需要在服务中启动一个叫Hyper-V的功能

image

你使用Win + R快捷键打开程序与功能

image

在启动和关闭Windows功能中找了一圈，

image

你发现怎么找也找不到Hyper-V这个功能和选项，这是因为在Win 10家庭版中是默认不安装这个功能的。

因此，你需要手动进行安装，新建一个名为Hyper-V.cmd的脚本。

image

通过VS code打开，并且添加以下内容并保存：

pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL

image

右击脚本以管理员身份运行：

image

等待脚本运行安装完毕后（忘了截图）会提示是否重启计算机，输入Y后重启计算机。

重启后再打开启动和关闭Windows功能，发现Hyper-V选项安装并且勾选了。

、

把WSL升级为WSL2

具体的详细内容可以看微软官方文档：https://docs.microsoft.com/zh-cn/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package

由于我们之前已经下载安装了WSL1并且安装开启了Hyper-V的服务，因此只需要执行以下的升级步骤

1.下载并且安装WSL2内核内核升级包
附链接：适合x64计算机的WSL2 Linux内核升级包：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
2.将WSL 2设置为默认版本

wsl --set-default-version 2

3.用指令查看当前子系统的版本号，并记录NAME

wsl -l -v

4.执行升级指令将指定的子系统版本从1升级到2

wsl --set-version Ubuntu 2

步骤2-4具体如下图

image

到此，WSL1成功升级为WSL2

安装Docker for Windows

去到官网下载：https://www.docker.com/products/docker-desktop

800

我当前下载的版本为：3.10版本

安装：

image

安装时两个选项都要勾选，如果系统不存在WSL2，似乎是无法正常使用的，建议安装了WSL2之后再安装。

在安装完毕后，打开setting->Resource->WSL Integration可以看到默认是与默认子系统共享，你也可以自定义与哪些子系统进行共享

image

测试结果

打开XShell连接子系统，并输入命令

docker ps -a

image

发现可以正常使用，我们创建一个mysql 8.0容器再进行查询：

image

可以正常连接到mysql

image

到docker的界面中停止当前容器

image

连接断开

image

至此为止，就可以使用Win 10家庭版愉快开发了。

有些可能但是没有注意到的坑：
1.Win 10的版本需要符合能够安装WSL 2的版本，具体版本可以查看之前微软升级WSL2的连接（由于我没有关闭升级，因此我的Win 10一直都是最新版本，如果你关闭了自动更新，可能需要查看一下版本是否满足条件）

参考博客：
win10 家庭中文版没有Hyper-V，这样安装一步搞定：https://blog.csdn.net/weixin_37695006/article/details/91589895
【WSL+Docker】新手Win10下的WSL Ubuntu18并使用Docker（两种方式）：https://zhuanlan.zhihu.com/p/61542198
总结Windows下安装WSL与升级WSL2的方法：https://blog.csdn.net/qq_35333978/article/details/113177819