【保姆级教程】windows 安装 docker 全流程
<h3 id="一背景">一、背景</h3><p>许多小伙伴在安装 Dify 或是 RagFlow 这些工具的时候，往往会遇到一个难题，那就是 Docker 的安装。</p>
<p>首先，我们的PC安装的绝大部分是 Windows，但众所周知的原因，Windows 对 Docker 的支持并不是特别好，这方面的历史原因有很多，实际上 Docker 是 Linux 流派的技术，它主要得益于 Linux Namespace 和 CGroups 这些内核隔离技术，然而 Docker 大火之际，Windows 并没有提供类似的技术，这也导致了 Windows 在容器领域一直处于滞后的地位。</p>
<p>后来的演进过程中，Windows 为了跟进这项技术，也做了一些演进。目前市场上流行的 个人PC 操作系统，主要还是以 Windows 10 和 Windows 11为主。而这两个版本对 Docker 的支持是略有不同的，这也导致了许多小伙伴在安装 Docker 时会出现不少问题。</p>
<p>在通过 Windows 安装 Docker 之前，我们有必要花点时间了解下 WSL 和 HyperV 这两项技术。</p>
<h4 id="hyperv">HyperV</h4>
<p>HyperV 是微软最早提供的虚拟化技术，得益于现代 CPU 硬件层虚拟化的发展，如Intel的 VT - x 和 AMD 的AMD - V，操作系统可以通过硬件层扩展接口来完成虚拟化。HyperV 主要通过对CPU、内存、网络、硬件外设等模块进行技术抽象来完成虚拟化管理和调度，并提供了 VMM 来支持虚拟机的生命周期管理。</p>
<p>需要注意的是 HyperV 是2008年发布的技术（对标的是 VMware ESX、开源的XEN/KVM等虚拟化技术），而 Docker 是 2013 年开始出现的，也就是说 HyperV 是后来支持的 Docker，最早在 Windows 10 版本上出现了支持 容器的 HyperV 组件，然而也仅限于专业版/企业版/教育版，如果是 Windows 10 个人家庭版本，需要单独安装 HyperV。</p>
<h4 id="wsl">WSL</h4>
<p>WSL 是 windows subsystem for linux 的简称，意思是Windows 上用于运行 Linux 的子系统。然而 WSL 历史上存在两个版本，这点同样也造成了大家的困扰。</p>
<ol>
<li>WSL1 发布于 2016 年 8 月，随 Windows 10-1607 版本发布，它是一种基于 Windows NT 内核实现的组件，支持在用户模式下运行 Linux 二进制文件，原理是将 Linux 系统调用转换为 Windows 系统调用。简单说，由于 WSL1 仅仅是做了一层系统调用的转换，它并没有真正的 Linux 内核，所以对 Docker 的支持不是太好。</li>
<li>WSL2 于 2019 年 5 月，随 Windows 10-1903（高阶版本）发布。WSL2 相比 WSL1 带来了一个革命性的变化，那就是 WSL2 利用了 HyperV 的虚拟化功能来提供完整的 Linux 内核支持，而 WSL2 相比 HyperV 提供了更简单、简洁的操作接口。</li>
</ol>
<p>不难发现，想要在 Windows 上完美运行 Docker，我们需要 WSL2 + HyperV 这两个底层技术，并至少确保操作系统在 Windows 10-1903 版本或以上。</p>
<h3 id="二环境准备">二、环境准备</h3>
<p>首先，我们需要明确 Windows 安装 Docker 的一些先决条件：</p>
<ol>
<li>确保 Window 版本在 10/11 以上</li>
<li>确保系统启用了 虚拟化支持</li>
<li>确保系统支持 HyperV 组件</li>
<li>确保系统安装了 WSL2 最新版本</li>
<li>确保虚拟化所需的 Windows 功能服务已经开启</li>
</ol>
<h4 id="1-查询-windows-版本">1. 查询 Windows 版本</h4>
<p>打开 设置 -> 系统 -> 系统信息 -> Windows 规格</p>
<p>查看 Window 版本，如下：<br>
<img src="https://img2024.cnblogs.com/blog/242916/202504/242916-20250406001732469-2046261001.png" width="50%"></p>
<h4 id="2-检查虚拟化支持">2. 检查虚拟化支持</h4>
<p>打开 任务管理器 -> 性能 -> CPU，查看虚拟化是否开启：</p>
<img src="https://img2024.cnblogs.com/blog/242916/202504/242916-20250406001742375-1773136713.png" width="50%">
<p>如果虚拟化未开启支持，需要重启电脑，打开BIOS/UEFI 设置，启用硬件虚拟化技术。</p>
<h4 id="3-hyperv-组件支持">3. HyperV 组件支持</h4>
<p>在程序中搜索 Hyper-V 管理器或控制台，检查是否已经安装了 HyperV组件。</p>
<p>此外还可以通过命令行进行检查：</p>
<pre><code>systeminfo | findstr /C:"Hyper-V"
Hyper-V 要求: 已检测到虚拟机监控程序。将不显示 Hyper-V 所需的功能。
</code></pre>
<p>一般的 Windows 个人家庭版默认不带 HyperV，如果发现 HyperV组件未安装，可通过脚本进行安装。</p>
<pre><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
</code></pre>
<p>将以上脚本保存为 hyperv.cmd 文件，双击运行可完成安装。</p>
<p>脚本执行完成后，重新检查以确认 HyperV 安装完成。</p>
<h4 id="4-安装-wsl2-最新版本">4. 安装 WSL2 最新版本</h4>
<p>访问如下地址获取安装包进行安装：</p>
<p>https://github.com/microsoft/WSL/releases</p>
<p>另一种办法，也可以通过 Microsoft Store进行下载安装。</p>
<p>安装完成之后，设置版本并检查状态：</p>
<pre><code>> wsl --set-default-version 2
> wsl -v
WSL 版本: 2.5.4.0
内核版本: 6.6.75.1-1
WSLg 版本: 1.0.66
MSRDC 版本: 1.2.6074
Direct3D 版本: 1.611.1-81528511
DXCore 版本: 10.0.26100.1-240331-1435.ge-release
Windows: 10.0.22631.5039
</code></pre>
<h5 id="41-配置-wsl2">4.1. 配置 WSL2</h5>
<p>编辑 %USER_HOME%/.wslconfig文件：</p>
<p>对于 Windows 10 版本，采用如下配置：</p>
<pre><code>
networkingMode=nat
autoMemoryReclaim=dropcache
</code></pre>
<p>对于 Windows 11 版本，采用如下配置</p>
<pre><code>
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=true
autoMemoryReclaim=dropcache
useWindowsDnsCache=true
bestEffortDnsParsing=true
hostAddressLoopback=true
</code></pre>
<p>保存 .wslconfig 文件，重启wsl服务：</p>
<pre><code> wsl --shutdown
wsl
</code></pre>
<h5 id="42-参数差异">4.2. 参数差异</h5>
<p>在 Windows 11 版本中，WSL 可支持镜像网络模式，并带来了一系列的性能提升配置。</p>
<p>具体的参数差异如下表所示：</p>
<table>
<thead>
<tr>
<th></th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>参数示例</td>
<td>说明</td>
<td>版本要求</td>
</tr>
<tr>
<td>networkingMode=mirrored</td>
<td>网络模式，mirrored为镜像模式，nat 为代理模式。<br><br>mirrored 模式下 WSL实例与主机系统共享网络接口，nat 则无法共享。</td>
<td>镜像模式要求 windows 11</td>
</tr>
<tr>
<td>dnsTunneling=true</td>
<td>是否启用启用DNS隧道功能，以便WSL实例通过主机操作系统的网络接口解析DNS请求</td>
<td>windows 11</td>
</tr>
<tr>
<td>autoProxy=true</td>
<td>启用自动代理功能，WSL实例能够自动同步主机的网络代理设置</td>
<td>windows 11</td>
</tr>
<tr>
<td>firewall=true</td>
<td>启用WSL的防火墙支持，允许HyperV对WSL网络流量进行控制</td>
<td>windows 11</td>
</tr>
<tr>
<td>autoMemoryReclaim=dropcache</td>
<td>开启内存自动回收功能，当内存紧张时，WSL实例会释放缓存</td>
<td>windows 10/11</td>
</tr>
<tr>
<td>useWindowsDnsCache=true</td>
<td>允许WSL使用主机Windows系统的DNS缓存</td>
<td>windows 10/11</td>
</tr>
<tr>
<td>bestEffortDnsParsing=true</td>
<td>启用“尽力而为”DNS解析功能，当DNS请求失败时，系统会尝试通过其他方法解析以提供更稳定的网络体验。</td>
<td>windows 11</td>
</tr>
<tr>
<td>hostAddressLoopback=true</td>
<td>除了环回地址之外，允许 WSL 2 子系统使用分配给主机的IP 与主机进行互访（通常使用不同网口）</td>
<td>镜像模式要求windows 11</td>
</tr>
</tbody>
</table>
<h4 id="5-开启虚拟化服务功能">5. 开启虚拟化服务功能</h4>
<p>打开控制面板 -> 程序 -> 启用或关闭系统功能，</p>
<p>将如下系统功能打开：</p>
<ul>
<li>虚拟机平台</li>
<li>HyperV</li>
<li>适用于WIndows的Linux子系统</li>
</ul>
<img src="https://img2024.cnblogs.com/blog/242916/202504/242916-20250406001812848-1098667966.png" width="50%">
<p>启用后根据提示重启系统后生效。</p>
<h3 id="三安装-linux-发行版">三、安装 Linux 发行版</h3>
<p>WSL 2 利用了 Hyper - V 的虚拟化功能来提供更高效的 Linux 环境。</p>
<p>而为了让 Docker 在 WSL 2 上运行，需要安装一个支持 Docker 的Linux 发行版，如Ubuntu或Debian等，使得Docker 能找到所需的Linux 的内核功能和服务。</p>
<h4 id="方式一命令行安装方式">方式一：命令行安装方式</h4>
<p>查看可用系统版本：</p>
<pre><code>wsl --list --online
</code></pre>
<pre><code>NAME FRIENDLY NAME
Ubuntu Ubuntu
Debian Debian GNU/Linux
kali-linux Kali Linux Rolling
Ubuntu-18.04 Ubuntu 18.04 LTS
Ubuntu-20.04 Ubuntu 20.04 LTS
Ubuntu-22.04 Ubuntu 22.04 LTS
Ubuntu-24.04 Ubuntu 24.04 LTS
OracleLinux_7_9 Oracle Linux 7.9
OracleLinux_8_7 Oracle Linux 8.7
OracleLinux_9_1 Oracle Linux 9.1
openSUSE-Leap-15.6 openSUSE Leap 15.6
SUSE-Linux-Enterprise-15-SP5 SUSE Linux Enterprise 15 SP5
SUSE-Linux-Enterprise-15-SP6 SUSE Linux Enterprise 15 SP6
openSUSE-Tumbleweed openSUSE Tumbleweed
</code></pre>
<p>安装 ubuntu</p>
<pre><code>wsl --install ubuntu
</code></pre>
<h4 id="方式二应用市场安装">方式二：应用市场安装</h4>
<p>打开 MicroSoft Store，搜索 Ubuntu，点击进行安装：</p>
<img src="https://img2024.cnblogs.com/blog/242916/202504/242916-20250406001834837-26824780.png" width="50%">
<h4 id="方式三离线安装">方式三：离线安装</h4>
<p>如果在线安装失败，可进行离线安装，参考文档：</p>
<p>https://learn.microsoft.com/en-us/windows/wsl/install-manual</p>
<p>通过以上链接下载对应的 Linux 发行版，如 Ubuntu2204-221101。</p>
<p>下载完毕后，打开PowerShell进入离线包所在目录，执行命令：</p>
<pre><code>Add-AppxPackage .\Ubuntu2204-221101.AppxBundle
</code></pre>
<p>随后会生成 xxx.AppxBundle文件，双击该文件进行安装。</p>
<h4 id="配置软件镜像">配置软件镜像</h4>
<p>执行如下命令进入 Ubuntu 系统：</p>
<pre><code>wsl -d Ubuntu
</code></pre>
<p>基于当前的网络配置方式，可根据需要配置网络代理</p>
<p>编辑 ~/.bashrc 命令，添加如下内容：</p>
<pre><code>export http_proxy=http://xxx
export https_proxy=http://xxx
</code></pre>
<p>编辑 /etc/apt/sources.list ，添加国内镜像站，如阿里云镜像：</p>
<p>https://developer.aliyun.com/mirror/</p>
<p>更新镜像站：</p>
<pre><code>sudo apt update
</code></pre>
<h3 id="三安装-docker">三、安装 Docker</h3>
<p>Windows 上安装 DockerDesktop 来实现 Docker 的安装和管理。</p>
<h4 id="1-安装dockerdesktop">1. 安装DockerDesktop</h4>
<p>访问 Docker 官网，下载 Docker-Desktop：</p>
<p>https://docs.docker.com/desktop/setup/install/windows-install/</p>
<p>双机运行，直接安装，注意勾选 Use WSL Instead Of HyperV。</p>
<h4 id="2-配置docker镜像源">2. 配置Docker镜像源</h4>
<p>安装完成之后，启动 DockerDesktop。</p>
<p>如果启动成功，可以看到启动界面。</p>
<p>选择 设定 -> Docker Engine：</p>
<img src="https://img2024.cnblogs.com/blog/242916/202504/242916-20250406001858344-658992568.png" width="50%">
<p>编辑 yaml ，在其中添加镜像源地址，添加如下内容</p>
<pre><code>{
...
"registry-mirrors": [
"https://xxx.com"
]
}
</code></pre>
<p>其中将地址替换为可用源，以如华为云镜像为例：</p>
<p>访问华为云容器镜像服务：https://console.huaweicloud.com/swr/，可获得自有镜像源地址。</p>
<h3 id="四安装容器">四、安装容器</h3>
<p>以 Neo4j 为例，进行容器的安装测试。</p>
<p>输入如下命令，拉取 Neo4j 镜像：</p>
<pre><code>docker pull neo4j
</code></pre>
<p>打开 Docker Desktop 界面，找到 Neo4j 镜像，点击Run，配置参数：</p>
<img src="https://img2024.cnblogs.com/blog/242916/202504/242916-20250406001913164-1979942101.png" width="50%">
<p>设置端口，挂载目录，设置 NEO4J_AUTH=neo4j/password 环境变量。</p>
<p>执行 Run 动作后，可以看到 Neo4j 已经启动。</p>
<p>访问 http://localhost:7474 ，可以访问 Neo4j 的界面：</p>
<img src="https://img2024.cnblogs.com/blog/242916/202504/242916-20250406001923360-1336745422.png" width="50%">
<h3 id="五网络访问">五、网络访问</h3>
<h4 id="nat-网络模式">NAT 网络模式</h4>
<p>在 NAT 网络模式，WSL 2 借助 Hyper - V 虚拟交换机创建一个虚拟网络环境，它有自己独立的虚拟网卡（在 Windows 主机上显示为 vEthernet (WSL)，在 WSL 2 内部通常为 eth0），通过该桥接网络，WSL2 子系统可访问外部网络，同时 Windows 主机也可以访问 WSL 2 实例暴露的端口，但该端口对外部主机不可见（需单独配置转发）</p>
<p>可以执行 ipconfig 命令，查看 WSL 实例的网络接口：</p>
<pre><code>ipconfig
以太网适配器 vEthernet (WSL):
连接特定的 DNS 后缀 . . . . . . . :
IPv4 地址 . . . . . . . . . . . . : xxx
子网掩码. . . . . . . . . . . . : 255.255.240.0
默认网关. . . . . . . . . . . . . :
</code></pre>
<ol>
<li>容器可以通过 host.docker.internal 特殊域名访问宿主机</li>
<li>宿主机可以通过 环回地址 访问容器端口</li>
<li>容器可以通过 WSL 的 IP 地址访问宿主机</li>
</ol>
<h4 id="mirrored-网络模式">Mirrored 网络模式</h4>
<p>在镜像网络模式中，WSL2 子系统与主机共享网络接口，此时不需要 独立的 WSL 网卡。</p>
<ol>
<li>容器可以通过 host.docker.internal 特殊域名访问宿主机</li>
<li>宿主机可以通过 环回地址 访问容器端口</li>
<li>容器和宿主机可以通过主机的 IP 地址进行互访（需检测分别WSL和主机分别绑定的IP）</li>
</ol>
<p>关于网络访问更多信息，可参考官网说明：<br>
https://learn.microsoft.com/zh-cn/windows/wsl/networking</p>
<h3 id="六常见问题">六、常见问题</h3>
<h4 id="端口绑定失败">端口绑定失败</h4>
<p>对于windows 10来说，wsl2 尽管配置了镜像模式，也会自动降级为 NAT 模式。</p>
<p>如果发现端口没有被主机占用，但启动提示没有绑定端口权限，需要注意端口是否在 HyperV 的保留端口范围之内。</p>
<p>由于 HyperV 的保留端口是动态生成的，需通过如下命令检查 HyperV 保留范围内：</p>
<pre><code>netsh interface ipv4 show excludedportrange protocol=tcp
开始端口 结束端口
---------- --------
80 80
2698 2797
2929 3028
8985 9084
9085 9184
9185 9284
9285 9384
9385 9484
9485 9584
9585 9684
</code></pre>
<p>如果存在冲突，最简单的做法是重启 NAT，让它的保留端口发生变化避免冲突</p>
<pre><code>net stop winnat
docker start xxx
net start winnat
</code></pre>
<p>另一种彻底的做法是，直接添加动态端口范围，如下：</p>
<pre><code>netsh int ipv4 set dynamic tcp start=49152 num=16384
</code></pre>
<h3 id="七参考文档">七、参考文档</h3>
<p>使用 WSL 访问网络应用程序<br>
https://learn.microsoft.com/zh-cn/windows/wsl/networking</p>
<p>WSL 高级配置<br>
https://learn.microsoft.com/zh-cn/windows/wsl/wsl-config</p>
</div>
<div id="MySignature" role="contentinfo">
<div style="background-color: #7c7f7c1c; font-size: small; padding: 5px">
<div style="float: left; padding-right: 15px">
<img src="https://images.cnblogs.com/cnblogs_com/littleatp/1241412/o_qrcode_for_gh_b2cf486409a0_258.jpg" style="width: 120px; height: 120px">
</div>
<div style="padding-top: 15px">
<p>
作者：
美码师(zale)
</p>
<p>
出处：
http://www.cnblogs.com/littleatp/, 如果喜欢我的文章，请<b style="font-size: medium">关注我的公众号</b>
</p>
<p>
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出
原文链接
如有问题， 可留言咨询.
</p>
</div>
<div style="clear: both"></div>
</div><br><br>
来源：https://www.cnblogs.com/littleatp/p/18810739
頁:
[1]