Docker Desktop 允许用户开发、管理和共享 Docker 化应用程序,但少数应用程序在启动应用程序时收到意外的 WSL 错误。
它可能在 Windows 和 Mac 上遇到,尽管我们在前者上看到了更多实例。最近遇到错误消息“Docker Desktop – 意外的 WSL 错误”的大多数用户都在运行 Windows 11。
Docker Desktop 中的 WSL2 错误是什么?
Docker Desktop 的 WSL2 错误表明权限配置错误或缺少关键组件,尤其是虚拟机平台(Windows 中的一项可选功能)。
此外,如果未安装 WSL 本身,则不会执行任何 WSL 命令。许多人认为网络问题也是根本原因。
如何修复 Docker Desktop 上的意外 WSL 错误?
在我们深入研究稍微复杂的解决方案之前,请尝试以下快速解决方案:
- 验证您的设备是否满足Docker Desktop 的最低要求。
- 重新启动电脑。如果每次都必须重新启动才能运行 Docker Desktop,请尝试其他解决方案。
- 检查可用更新并从官方网站安装最新版本的 Docker Desktop 。另外,更新操作系统。它帮助了许多遇到意外错误发生的人。重新启动 Docker Desktop 消息。
- 确保 Docker Desktop以管理权限运行,以消除任何访问权限问题。当Docker Desktop 需要很长时间才能启动时,这也很有帮助。
- 禁用 PC 上的任何第三方防病毒软件。
如果都不起作用,请前往下面列出的修复程序。
1.安装WSL
- 按Windows +S 打开搜索,在搜索栏中键入命令提示符,然后单击以管理员身份运行。
- 在 UAC 提示中单击“是” 。
- 现在,粘贴以下命令并点击Enter 安装 WSL:
wsl --install
- 完成后,重新启动电脑并检查是否有改进。
如果未安装适用于 Linux 的 Windows 子系统,您将收到 Docker Desktop – 意外的 WSL 错误。完成此操作后,还要在设备上启用 Hyper-V 。这对于 Docker Desktop 的运行至关重要。
2.更新WSL
- 按Windows+R打开“运行”,输入cmd,然后点击Ctrl+ Shift+ Enter。
- 在出现的提示中单击“是” 。
- 粘贴以下命令并点击Enter 以更新 WSL:
wsl --update
- 如果安装了任何更新,请重新启动电脑。
3.修改settings.json文件
- 按Windows +E 打开文件资源管理器,将以下路径粘贴到地址栏中,然后点击Enter:
%Appdata%\Docker
- 双击settings.json文件。
- 现在,确保它显示以下内容:
"integratedWslDistros": [ ]"enableIntegrationWithDefaultWslDistro": false
- 如果需要,进行必要的编辑并保存更改。
- 完成后,重新启动项目,它不应该再抛出 Docker Desktop failed to start WSL2 错误。
4. 更改命令提示符设置
- 按Windows+S打开搜索,键入命令提示符,右键单击相关结果,然后选择以管理员身份运行。
- 在出现的 UAC 提示中单击“是” 。
- 现在,右键单击顶部栏,然后从上下文菜单中选择“属性” 。
- 转到“选项”选项卡,勾选“使用旧版控制台”复选框,然后单击“确定”保存更改。
5.重置winsock
- 按Windows+R打开“运行”,键入cmd,按住Ctrl+Shift键,然后单击“确定”。
- 在提示中单击“是” 。
- 现在,单独粘贴以下两个命令并Enter 在每个命令后单击以重置损坏或配置错误的网络设置:
netsh int ip reset
netsh winsock reset
- 重新启动 PC 并检查 Docker Desktop 启动失败错误是否消失。
6. 在 BIOS 中启用硬件虚拟化
- 关闭计算机,然后打开电源,显示屏出现后,按住 、F2、 F10或 键以访问 BIOS(具体取决于系统制造商)F12。 EscDel
- 现在,使用箭头键转到“高级”或“系统配置”选项卡,然后选择“虚拟化技术”。
- 最后,选择Enable,然后保存更改并退出 BIOS。
在 PC 上启用虚拟化支持对于 Docker Desktop 的正常工作至关重要。如果没有这个,您可能会收到 Docker Desktop – Unexpected WSL 错误。
7. 重新安装 WSL
- 按Windows +I 打开“设置”,从导航窗格转到“应用程序”,然后单击右侧的“已安装的应用程序” 。
- 现在,找到Windows Subsystem for Linux,单击旁边的省略号,然后选择卸载。
- 再次单击确认提示中的“卸载” 。
- 同样,删除已安装应用程序下的以下条目(如果存在):
- Linux
- 乌班图
- 现在,返回“应用程序”选项卡,然后选择“可选功能”。
- 单击底部的“更多 Windows 功能” 。
- 取消选中虚拟机平台和适用于 Linux 的 Windows 子系统的复选框,然后单击“确定”保存更改。
- 重新启动计算机以使更改生效。
- 完成后,重新安装 WSL(适用于 Linux 的 Windows 子系统)。
如果其他方法都不起作用,您可以随时重新安装 WSL 并摆脱 Docker Desktop – Unexpected WSL 错误。首先卸载 WSL,然后重新下载所有组件。
Windows WSL 中 Docker Desktop 的替代方案是什么?
Docker Desktop 有多种替代方案,考虑到该项目许可条款的最新变化,许多用户已经转向这些方案。以下是流行的选项:
- Rancher 桌面
- 迷你库贝
- 波德曼
切换到其他软件时,请确保验证与您的操作系统的兼容性、功能集、性能、易用性、支持团队的效率以及发布更新的频率。
到目前为止,您一定已经摆脱了 Docker Desktop – Unexpected WSL 错误。如果情况并非如此,要么等待更新,要么改用可靠的替代方案。你知道所有的选择!
此外,还有其他影响用户的安装错误。例如,许多人在安装 Docker Desktop 时遇到了Hyper-V 和容器 Windows 功能必须启用错误,但这很容易修复!
如有任何疑问或分享对您有用的方法,请在下面发表评论。
发表回复