Windows 10已安装WSL2但Docker Desktop无法启动如何解决?
Windows WSL2环境下Docker Desktop连接守护进程报错排查修复步骤
该报错本质为Docker客户端无法与正常运行的Docker守护进程建立通信,可按以下顺序排查修复:
- 第一步:检查Docker Desktop运行状态
打开Windows任务管理器,确认Docker Desktop后台进程正常运行,若已崩溃退出先尝试手动启动,启动时出现弹窗报错可先查看Docker Desktop内置日志面板定位启动失败原因。 - 第二步:验证WSL2集成配置是否开启
打开Docker Desktop设置面板,依次进入「资源」-「WSL集成」页面,确认你正在使用的WSL发行版(如Ubuntu、Debian)对应的开关处于开启状态,修改配置后需重启Docker Desktop生效。 - 第三步:确认WSL发行版版本为WSL2
打开Windows PowerShell执行命令:
查看目标发行版的wsl -l -vVERSION列是否为2,若为WSL1需执行转换命令:
转换完成后执行wsl --set-version <你的发行版名称> 2wsl --shutdown重启WSL服务再重新进入发行版。 - 第四步:检查WSL内部docker套接字文件状态
进入对应WSL发行版执行命令:
若文件不存在,可手动创建软连接:ls -l /var/run/docker.sock
若权限不足可执行授权:sudo ln -sf /mnt/wsl/docker-desktop/shared-sockets/var/run/docker.sock /var/run/docker.socksudo chmod 666 /var/run/docker.sock - 第五步:校验Docker上下文配置
在WSL终端执行命令查看当前上下文:
确认当前激活的上下文端点为docker context lsunix:///var/run/docker.sock,若配置异常可执行切换:
也可直接添加环境变量永久生效,将docker context use defaultexport DOCKER_HOST=unix:///var/run/docker.sock写入~/.bashrc或~/.zshrc配置文件后执行source加载。 - 第六步:确认Windows虚拟化相关功能已开启
打开Windows「启用或关闭Windows功能」面板,确认「Hyper-V」、「适用于Linux的Windows子系统」、「虚拟机平台」三个选项均已勾选,未勾选的开启后重启电脑再尝试启动Docker。 - 第七步:重置Docker Desktop配置
以上步骤都无效的情况下,打开Docker Desktop设置面板,进入「疑难解答」页面选择「重置到出厂默认设置」,重置完成后重新配置WSL集成即可。
内容的提问来源于stack exchange,提问作者Thymeleaf
相关产品推荐
相关产品推荐

