Win11 安装Docker Desktop报错：Update the WSL kernel by running “wsl --update“ or follow instructions

最新推荐文章于 2025-05-14 14:03:47 发布
最新推荐文章于 2025-05-14 14:03:47 发布
阅读量4.4k 收藏 8
点赞数 3
CC 4.0 BY-SA版权
分类专栏： 安装 & ERROR 文章标签： docker
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/wangws_sb/article/details/130411952
安装DockerDesktop后遇到启动问题，通过开启Windows功能中的Hyper-V和VirtualMachinePlatform，以及手动更新WSL，如使用wsl_update_x64.msi，可解决错误提示。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

这个问题解决了一整个下午，看了无数的解决方案，最后找到了最有效的解决方案，总结如下：

安装Docker Desktop之后，打开出现这样的问题：

根据提示在powershell通过 `wsl --update` 命令 出现 error

那么可以试试下面这种解决方法

打开windows功能，勾选Hyper-V，Virtual Machine Platform，Windows Subsystem for Linux

 

 可能还是会出现文章开始的那个错误，可能自己手动更新一下wsl，根据提示去微软官网下载最新版的wsl安装后即可正常打开。https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

windows10安装docker报错【已解决】
JavaPub
04-02 2652
文章目录报错信息解决方案成功 报错信息 Docker Desktop - Install WSL 2 kernel update WSL 2 installation is incomplete. The WSL 2 Linux kernel is now installed using a separate MSI update package. Please click the link and follow the instructions to install the kernel updat
WSL 2 installation is incomplete.【BUG解决】【Docker之云原生基石】
一键难忘的博客
06-14 3万+
本文解决俩个Docker报错：分别是： 1.WSL 2 installation is incomplete. 2.System.InvalidOperationException: Failed to set version to docker-desktop: exit code: -1
更改Docker的默认安装路径和常见错误Docker Desktop - WSL update failed
huahaiyu的博客
05-27 2270
下载最新的 msixbundle 版本(按照自己系统来) 并执行手动安装,包含“x64”（更常见）或“ARM64”的文件。Docker Desktop Installer.exe 安装文件所在目录Powershell 输入以下指令。注: D:\devtools\Docker\DockerDesktop"换成自己想安装目录。先看自己的终端是CMD（Command Prompt）还是Powershell。
Win11安装Docker报错Update the WSL kernel by running “wsl --update“ or follow instructions at https://doc
chenthe1的专栏
03-11 2万+
从Win10升级到Win11后，当计算机第一次启动时（以及之后的每次），Docker Desktop 将无法启动。当然，如果你觉得文章有什么让你觉得不合理、或者有更简单的实现方法又或者有理解不来的地方，希望你在看到之后能够在评论里指出来，我会在看到之后尽快的回复你。由此可见，在win11正式版发布之前，很多开发者借助win11测试版进行了大量开发和适配工作，升级软件到最新版是解决问题的首选方案。关闭正在运行的所有wsl2终端，以管理员身份运行PowerShell或者命令行工具。更新内核，然后再执行。
Docker启动时提示Docker Desktop - WSL update failed的解决办法
最新发布
weixin_45017726的博客
05-14 812
在 Windows 系统上安装或启动 Docker Desktop 时，可能会遇到“WSL update failed”的错误提示。这通常是由于 Windows 子系统 Linux（WSL）组件未正确更新或配置异常所致。解决此问题的方法很简单：只需以管理员身份打开 PowerShell，并输入命令 wsl --update 即可手动更新 WSL。通过这一步骤，用户可以顺利解决 Docker Desktop 的启动问题，确保其正常运行。更多详细步骤和解决方案可参考相关链接。
Update the WSL kernel by running “wsl --update“ or……【老电脑装Docker】
春花秋月冬雪风，留得残荷听雨声。
07-05 1091
打开Docker一直报这个界面，然后就退出。根据上面的意思，试着更新了下。等待更新完成后成功进入。
windows11运行Docker Desktop，报错Docker Desktop -WSL update failed
qq_64574122的博客
04-02 4万+
重新安装Docker Desktop，但是依然报错。
win10安装Docker desktop报错：Update the WSL kernel by running “wsl --update“ or follow instructions...
m0_73808788的博客
07-14 483
根据更新提示，进入网站，
Windows使用wsl2安装docker教程
Peter Cheung的博客
01-19 1万+
本文安装docker，将使用WSL2，而不是vmeare和Hyper-V，也不需要你另外安装Linux系统（如Ubuntu）。查阅资料均来自官网文档（微软官网和docker官网）。下面让我们开始吧！
Win11安装Docker
chenthe1的专栏
03-11 2万+
根据官网提示，Windows环境下下载Docker必须满足：Docker for Windows requires 64bit Windows 11 Pro and Microsoft Hyper-V（即需要64位Windows 11 Pro(专业版和企业版都可以)和Microsoft Hyper-V），Hyper-V是微软的虚拟机，在win11上是自带的，我们只需要启动就可以了。点击确定后，系统会自行更新，更新完成后提示是否重启电脑，要选择。到此就可以愉快的再windows上玩Docker了。
Win11安装Docker并本地化部署SupersetBI
m0_63112723的博客
08-23 619
在终端中执行命令，更新wsl内核；系统：window11专业版。
【docker】Windows10安装Docker Desktop - WSL update failed
一个写了10年bug的程序员日常笔记。
04-30 4万+
确保您的 Windows 10 版本支持 WSL 2。WSL 2 需要 Windows 10 版本 2004 或更高版本。您可以在 Windows 设置中检查您的 Windows 10 版本。在更新 WSL 2 内核后，您需要重新启动 Docker Desktop。在 Windows 10 上启用 WSL 2 需要运行一些命令。更新 WSL 2 内核。如果 WSL 2 内核更新失败，您可以尝试手动更新。如果您的系统中没有安装 WSL 2 内核，则会自动下载并安装。这将下载并安装最新的 WSL 2 内核。
docker windows 下载安装 Update the WSL kernel by running “wsl --update“ or follow instructions at xxx
weixin_51689532的博客
07-19 654
运行弹框提示 Update the WSL kernel by running "wsl --update" or follow instructions at https://docs.microsoft.com/windows/wsl/wsl2-kernel.
【Docker】Docker Desktop - WSL update failed
weixin_47610533的博客
07-19 4103
Windows上安装完成docker desktop之后，第一次启动失败，提示：WSL update failed。
docker Desktop安装WSL --update报错问题
热门推荐
coder_copy的博客
08-22 7万+
WSL -update wsl --install -d Ubuntu-22.04。“启用或关闭windows功能”、“BIOS/UEFI设置中启用了虚拟化技术” 正在进行此分发的安装、卸载或转换
Docker Desktop - WSL update failed问题
weixin_69813830的博客
04-16 343
有一个帖子评论说的，系统重装过盗版系统，然后系统有问题，需要先安装wsl并update后 在安装docker。尝试后问题依然存在。尝试一：手动wsl --update。
【docker】Windows10启动Docker Desktop - WSL update failed
欢迎来到我的博客空间！
03-12 811
几日前在win10家庭版利用Docker+RAG,本地部署deepseek,由于电脑自身原因重装了系统，系统为win10教育版。然后一直启动不起来,在网上查询了大量的资料，发现问题都差不多，但都无法解决此问题，接近崩溃。
Windows11安装Docker Desktop - WSL update failed
m0_46348578的博客
05-03 348
安装docker的时候，出现Docker Desktop - WSL update failed。】把勾给去掉之后重启，重启完之后cmd输入。然后打开docker还是出现上面的错误。打开，然后双击docker就成功了。更新正常后，再把 适用于Linux的。，然后找到【适用于Linux的。
Windows10安装Docker Desktop - WSL update failed
weixin_40101756的博客
05-23 5299
按照提示更新wsl后，仍然会报错，github上没有找到解决方法。版本28、29、30都会报这个错。经过尝试，将docker内的设置中，采用wsl禁掉即可。
The operation completed successfully. PS C:\WINDOWS\system32> wsl --shutdown PS C:\WINDOWS\system32> wsl --unregister docker-desktop Unregistering. There is no distribution with the supplied name. Error code: Wsl/Service/WSL_E_DISTRO_NOT_FOUND PS C:\WINDOWS\system32> wsl --unregister docker-desktop-data Unregistering. There is no distribution with the supplied name. Error code: Wsl/Service/WSL_E_DISTRO_NOT_FOUND PS C:\WINDOWS\system32> PS C:\WINDOWS\system32> wsl --shutdown PS C:\WINDOWS\system32> wsl -l -v Windows Subsystem for Linux has no installed distributions. You can resolve this by installing a distribution with the instructions
03-31
<think>好的，我现在需要帮助用户解决在WSL中找不到docker-desktop和docker-desktop-data发行版，以及处理WSL_E_DISTRO_NOT_FOUND错误的问题。首先，我得仔细分析用户提供的引用内容，找出可能的原因和解决方法。 根据引用[1]，用户提到安装Docker Desktop后，docker-desktop-data处于stopped状态，导致镜像丢失。这说明这两个发行版是Docker Desktop正常运作的关键，尤其是docker-desktop-data负责存储镜像。如果这两个发行版未被正确识别，可能是因为WSL配置问题或者Docker安装不完整。 引用[2]指出，Docker Desktop依赖的WSL发行版意外终止，通常是因为外部操作如运行wsl --shutdown导致的。这时候可能需要重新启动相关服务或重新注册发行版。 引用[3]中的用户遇到WSL_E_DISTRO_NOT_FOUND错误，通过调整发行版名称解决了问题。比如，原本使用Ubuntu-20.04报错，改用Ubuntu后成功。这说明发行版名称的格式或版本后缀可能影响WSL的识别，用户需要确认正确的名称。 接下来，我需要整合这些信息，形成步骤化的解决方案。可能的步骤包括： 1. 检查已安装的WSL发行版列表，确认docker-desktop和docker-desktop-data是否存在。如果不存在，可能需要重新安装Docker Desktop或手动注册。 2. 如果发行版存在但状态异常，尝试重启Docker服务或WSL服务，或者重置相关配置。 3. 确认用户输入的发行版名称是否正确，特别是是否有版本后缀的问题，如引用[3]中的情况。 4. 如果以上步骤无效，可能需要手动导出和导入发行版，或者完全重新安装Docker Desktop和WSL。 同时，需要注意用户可能遇到的权限问题，例如是否以管理员身份运行命令，以及系统版本是否符合要求（如WSL 2需要特定Windows版本）。 在生成解决方案时，需要分步骤详细说明，并参考用户提供的引用内容中的解决方法。例如，引用[1]中提到手动创建或恢复发行版的方法，可能需要用户使用wsl命令重新注册。引用[3]中的名称调整问题，提示用户检查名称是否正确。 最后，确保回答结构清晰，逐步引导用户排查问题，并给出相关的命令示例，如wsl --list、wsl --shutdown等。同时，提醒用户备份数据，避免操作中数据丢失。 可能还需要生成相关问题，比如如何备份WSL发行版，如何升级到WSL 2，或者Docker Desktop与WSL的集成原理等，以帮助用户深入理解问题。</think>### 分步解决方案：WSL发行版未找到问题 #### 1. 确认发行版状态与名称 - **检查已安装的发行版** 以管理员身份打开PowerShell或CMD，执行： ```bash wsl --list --all -v ``` 若输出中未显示`docker-desktop`和`docker-desktop-data`，说明发行版未正确注册或已损坏。 *注意名称是否包含版本后缀（如`Ubuntu-20.04` vs `Ubuntu`），需与注册时一致[^3]。 #### 2. 尝试重启Docker与WSL服务 - **关闭Docker Desktop**，执行以下命令彻底重启WSL： ```bash wsl --shutdown # 终止所有WSL实例 net stop com.docker.service # 停止Docker服务 net start com.docker.service # 重新启动Docker服务 ``` 重启Docker Desktop后观察是否恢复[^2]。 #### 3. 手动恢复发行版（若丢失） - **从备份恢复**（需提前备份） 若曾导出过发行版，可通过以下命令重新注册： ```bash wsl --import docker-desktop-data "D:\docker-data\data" docker-desktop-data.tar --version 2 wsl --import docker-desktop "D:\docker-desktop" docker-desktop.tar --version 2 ``` *路径需根据实际备份位置调整*[^1]。 - **重新安装Docker Desktop** 卸载后重新安装Docker Desktop，安装时会自动创建所需发行版： 1. 控制面板卸载Docker Desktop 2. 删除残留文件：`%AppData%\Docker` 和 `%LocalAppData%\Docker` 3. 重新下载安装包并运行安装程序 #### 4. 修复WSL配置 - **更新WSL内核** 确保系统满足WSL 2要求（Windows 10 1903+或Windows 11），下载最新内核包： [WSL 2 Linux内核更新](https://aka.ms/wsl2kernel) - **重置WSL默认版本** ```bash wsl --set-default-version 2 # 确保默认使用WSL 2 ``` #### 5. 验证与数据迁移 - **检查发行版状态** 执行`wsl --list --all -v`确认两个发行版状态为`Running`。 - **迁移镜像存储路径（可选）** 若需调整存储位置，可通过修改Docker Desktop设置中的`Disk image location`，或使用符号链接实现。 --- ### 相关问题 1. **如何备份/迁移WSL发行版的数据？** 2. **Docker Desktop与WSL 2的依赖关系是什么？** 3. **如何排查WSL 2与Docker的兼容性问题？** [^1]: 用户需手动注册或恢复发行版时，路径和名称需严格匹配。 : WSL服务意外终止可能导致依赖的发行版状态异常。 [^3]: 发行版名称格式错误是常见报错原因。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值