You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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 -v
    
    查看目标发行版的VERSION列是否为2,若为WSL1需执行转换命令:
    wsl --set-version <你的发行版名称> 2
    
    转换完成后执行wsl --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.sock
    
    若权限不足可执行授权:
    sudo chmod 666 /var/run/docker.sock
    
  • 第五步:校验Docker上下文配置
    在WSL终端执行命令查看当前上下文:
    docker context ls
    
    确认当前激活的上下文端点为unix:///var/run/docker.sock,若配置异常可执行切换:
    docker context use default
    
    也可直接添加环境变量永久生效,将export 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.02 02:36:04