WSL2、Docker Desktop安装配置最新版保姆级教程(附详细图文)
<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li><a href="#_label0">前言</a></li><li><a href="#_label1">安装环境要求：</a></li><li><a href="#_label2">安装WSL2</a></li><ul class="second_class_ul"><li><a href="#_lab2_2_0">方式一： 命令行方式安装WSL2</a></li><ul class="third_class_ul"><li><a href="#_label3_2_0_0"> 将WSL 1上的Ubuntu转换为WSL 2（视情况而定）</a></li></ul><li><a href="#_lab2_2_1">安装方式二：GUI界面手动安装</a></li><ul class="third_class_ul"></ul></ul><li><a href="#_label3">安装 Docker Desktop</a></li><ul class="second_class_ul"></ul><li><a href="#_label4">镜像配置</a></li><ul class="second_class_ul"><li><a href="#_lab2_4_2">获取阿里云镜像（如果不想配置，可以跳过使用其他镜像源）</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_3">配置Docker Desktop镜像</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_4">其他镜像源</a></li><ul class="third_class_ul"></ul></ul><li><a href="#_label5">总结</a></li><ul class="second_class_ul"></ul></ul></div><p class="maodian"><a name="_label0"></a></p><h2>前言</h2><p>Docker 是一个开源的应用容器引擎，基于 Go 语言开发，并遵循 Apache 2.0 协议。它可以让开发者将应用及其依赖打包到一个可移植的容器中，然后在任何支持 Docker 的环境中运行这个容器，实现“一次构建，处处运行”的目标。无论是本地开发、测试，还是大规模的云端部署，Docker 都能显著降低环境配置的复杂性，减少依赖冲突问题。</p>
<p>本教程将详细介绍在 Windows （11）上 Docker Desktop 的安装和配置方法，Docker Desktop 是 Docker 官方提供的面向开发者的一款桌面应用程序，适用于 Windows 和 macOS 操作系统，它简化了在本地开发环境中使用 Docker 的过程。</p>
<p class="maodian"><a name="_label1"></a></p><h2>安装环境要求：</h2>
<ul><li>操作系统版本必须为 Windows 10 2004及以上（64位）</li><li>必须启用Hyper-V或WSL 2后端（家庭版需安装WSL 2）</li></ul>
<p>WSL2（Windows Subsystem for Linux Version 2）是微软在 Windows 10 和 Windows 11 中提供的一个兼容层，它允许用户在 Windows 上运行原生的 Linux 内核和应用程序。与传统的虚拟机不同，WSL2 提供了一个轻量级的虚拟化环境，使得 Linux 应用可以无缝地与 Windows 桌面和文件系统交互，同时保持高性能和良好的兼容性。 Docker Desktop 依赖 WSL 2 作为后端运行环境。因此，在安装 Docker Desktop 之前，需要先 安装 WSL 2 并配置至少一个 Linux 发行版（Ubuntu、Debian、CentOS等等）</p>
<p class="maodian"><a name="_label2"></a></p><h2>安装WSL2</h2>
<p class="maodian"><a name="_lab2_2_0"></a></p><h3>方式一： 命令行方式安装WSL2</h3>
<p> 以管理员身份打开 PowerShell，运行这条命令， 启用 Windows 子系统（WSL）功能</p>
<div class="jb51code"><pre class="brush:ps;">dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart</pre></div>
<p>WSL2 依赖 Windows 虚拟机功能，启用虚拟机平台功能</p>
<div class="jb51code"><pre class="brush:ps;">dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart</pre></div>
<p>需要执行以下命令进行修改将WSL2设置为默认版本，注意，这里只是将版本默认设置为WSL2！</p>
<div class="jb51code"><pre class="brush:ps;">wsl --set-default-version 2</pre></div>
<p>在应用商店搜索下载发行版本（其他地方也可以下载），虽然提供了多种不同的发行版，包括OpenSUSE，Pengwin，Fedora Remix和Alpine Linux。但是还是建议Ubuntu 20.04 LTS版本（尽管也有18.04 LTS）</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564118.png" /></p>
<p>下载安装完成之后，如果有需要，也可以试试安装 Windows Terminal，这个工具能够很大程度上增加WSL的使用体验，当然这个看个人的使用习惯。</p>
<p class="maodian"><a name="_label3_2_0_0"></a></p><h4> 将WSL 1上的Ubuntu转换为WSL 2（视情况而定）</h4>
<p>查看 WSL 版本和发布版本</p>
<div class="jb51code"><pre class="brush:ps;">wsl -l -v
或
wsl --list --verbose
</pre></div>
<p>执行命令</p>
<div class="jb51code"><pre class="brush:ps;">wsl.exe –set-version Ubuntu 2</pre></div>
<p>如图 ，我这里的版本已经是WSL2，各位需要根据自己的情况来定</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564184.png" /></p>
<p>我这里是自己安装测试的Debian版本，所以各位小伙伴们不要疑惑为什么不是<strong>Ubuntu，</strong>都是一样的方式，不用过于纠结。 </p>
<p>最后，完成以上操作后重启电脑，确保更改生效。</p>
<p class="maodian"><a name="_lab2_2_1"></a></p><h3>安装方式二：GUI界面手动安装</h3>
<p> 开启<strong>Hyper-v</strong>和<strong>适用于Linux的Windows子系统</strong>，打开<strong>控制面板</strong>-><strong>程序</strong>-><strong>启用或关闭Windows功能</strong></p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564156.png" /></p>
<p>然后重启电脑，为了确保更改后功能启用正常，需要重新启动系统</p>
<p>对于 windows10 版本2004（内部版本19041或更高）及更新版本或者 windows11，可以直接用 dos命令，任务栏搜索“<strong>命令提示符</strong>”->以<strong>管理员身份打开</strong>，然后执行：</p>
<div class="jb51code"><pre class="brush:ps;">wsl --install</pre></div>
<p>如图 </p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564113.png" /></p>
<p>下次需要使用，就直接在DOS命令窗口或者PowerShell中输入wsl即可</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564195.png" /></p>
<p>以上就是完整安装WSL2的所有完整步骤，因为操作和机型配置的差异，也许会有安装成功的或者失败的朋友，失败的朋友不要着急，可以多参考其他大牛们的教程，因为大致操作都是相同的。</p>
<p class="maodian"><a name="_label3"></a></p><h2>安装 Docker Desktop</h2>
<p>访问 Docker 官网：<a href="https://www.docker.com/" rel="external nofollow" target="_blank" title="Docker: Accelerated Container Application Development">Docker: Accelerated Container Application Development</a>。</p>
<ul><li>点击页面上的“Download for Windows - AMD64”按钮，以下载适用于 Windows 系统的 Docker Desktop 安装文件。</li></ul>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564193.png" /></p>
<h6>版本选择,AMD64和ARM64架构分不清楚？</h6>
<p>正常来说，我们无脑选x86_64、x64、AMD64就行了，但是这并不适合所有情况， 使用<strong>Win + R</strong> ->打开 “<strong>运行</strong>” 对话框->输入 <strong>msinfo32</strong> ，回车->打开 “系统信息” 窗口。</p>
<p>在 “系统摘要” 部分,查看 “系统类型” 一项,它会显示你的架构信息。</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564181.png" /></p>
<p> 可以看到，系统类型为基于x64,所以我选择<strong>Download for Windows - AMD64</strong>，下载完成后按照提示下一步正常安装即可，不再赘述。</p>
<p>安装完成后在桌面显示图标双击打开界面（如果提示需要登录或者信息收集直接选择跳过即可）</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564180.png" /></p>
<p>打开后再左下角有三个点，点击后可以看到当前DockerDesktop的状态为‘<strong>running</strong>’，我们此时打开DOS窗口输入docker version命令后，会输出一些关于版本的日志信息，表示安装成功。</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564113.png" /></p>
<p> 在DOS窗口中输入命令拉取镜像，或者也可以用helloWorld来测试</p>
<div class="jb51code"><pre class="brush:ps;">docker pull mysql:5.7
或
docker pull hello-world</pre></div>
<p>如果是在没有配置镜像前，因为网络无法连接或超时拉取镜像失败 </p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564120.png" /></p>
<p>那么接下来就需要我们自己去配置镜像了 </p>
<p class="maodian"><a name="_label4"></a></p><h2>镜像配置</h2>
<p class="maodian"><a name="_lab2_4_2"></a></p><h3>获取阿里云镜像（如果不想配置，可以跳过使用其他镜像源）</h3>
<p>1.搜索阿里云->登录->登录之后搜索‘容器服务镜像’->免费试用->立即试用</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564152.png" /></p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564287.png" /></p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564129.png" /></p>
<p style="text-align:center"> 然后选择找到自己的加速地址</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564123.png" /></p>
<p class="maodian"><a name="_lab2_4_3"></a></p><h3>配置Docker Desktop镜像</h3>
<p>方式一：在Docker Desktop中，点击设置图标->找到Docker Engine中进行配置</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564138.png" /></p>
<p>将阿里云的镜像加速地址配置到Docker Desktop中，在<strong>registry-mirrors</strong>中可以配置多个镜像源地址，只要有一个能用就行，配置完成之后点击“<strong>Apply & restart</strong>”</p>
<p>方式二：或者也可以找到C:\Users\你的用户名\.docker这个目录下的daemon.json文件，在这个文件中配置即可</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564118.png" /></p>
<blockquote><p>注意:以上方式二选一即可，配置时需要注意正确的JSON格式，否则可能导致无法正常启动，我这里除了阿里的镜像之外，还配置了一个轩辕的镜像，一样都是亲测可用，如果不想配置阿里的镜像可以直接使用以下列举的其他镜像源。</p></blockquote>
<p class="maodian"><a name="_lab2_4_4"></a></p><h3>其他镜像源</h3>
<p>目前很多镜像源地址其实已经不可用了，这里都是目前还算可靠的镜像源（有些博主还没有用过，自测吧）</p>
<table><thead><tr><th><p>镜像源名称</p></th><th><p>地址（推荐优先级）</p></th><th><p>特点</p></th></tr></thead><tbody><tr><td><p>轩辕镜像</p></td><td><p>https://docker.xuanyuan.me</p></td><td><p>国内专线，稳定高速</p></td></tr><tr><td><p>阿里云镜像</p></td><td><p>https://<你的ID>.mirror.aliyuncs.com</p></td><td><p>需阿里云账号</p></td></tr><tr><td><p>网易云镜像</p></td><td><p>http://hub-mirror.c.163.com</p></td><td><p>多节点覆盖</p></td></tr><tr><td><p>Docker中国官方镜</p></td><td><p>https://registry.docker-cn.com</p></td><td><p>官方认证，适合企业环境</p></td></tr><tr><td>腾讯云镜像</td><td>https://mirror.ccs.tencentyun.com</td><td>需要自测</td></tr><tr><td>中科大镜像</td><td>https://mirrors.ustc.edu.cn/docker-ce/linux/centos/docker-ce.repo<br /> </td><td>需要自测</td></tr></tbody></table>
<p>在完成了以上所有操作之后，我们可以试一下是否能正常使用,在DOS窗口中执行以下命令：</p>
<div class="jb51code"><pre class="brush:ps;">docker pull mysql:5.7</pre></div>
<p>在配置了镜像之后</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564148.png" /></p>
<p>显然已经拉取镜像成功了， 我们再次回到Docker Desktop中查看</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202512/2025120510564297.png" /></p>
<p class="maodian"><a name="_label5"></a></p><h2>总结</h2>
<p>到此这篇关于WSL2、Docker Desktop安装配置最新版保姆级教程的文章就介绍到这了,更多相关WSL2、Docker Desktop安装配置内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！</p>
頁:
[1]