Windows下Docker Desktop启动WSL集成超时问题及无Desktop运行Docker咨询

报错核心是WSL与Ubuntu发行版的集成超时，可按以下步骤排查修复：

• 重启WSL服务与Ubuntu
  打开管理员命令提示符，执行：

  wsl --shutdown
  

  等待命令执行完成后，手动启动Ubuntu发行版，再重新打开Docker Desktop。
• 确认WSL版本并更新
  检查当前WSL发行版版本：

  wsl -l -v
  

  若Ubuntu为WSL1版本，将其转换为WSL2：

  wsl --set-version Ubuntu 2
  

  同时设置WSL2为默认版本：

  wsl --set-default-version 2
  

• 重置Docker Desktop的WSL集成配置
  打开Docker Desktop的设置界面，进入Resources > WSL Integration，先关闭Ubuntu的集成开关，点击Apply & Restart；重启完成后再次打开Ubuntu的集成开关，再次点击Apply & Restart。
• 重新注册Ubuntu发行版
  若上述方法无效，可注销并重新安装Ubuntu：

  wsl --unregister Ubuntu
  

  之后从微软商店重新下载安装Ubuntu，再重新配置Docker Desktop的WSL集成。
• 更新Windows与WSL
  打开Windows更新中心，安装所有可用的系统更新；更新完成后，在命令提示符执行：

  wsl --update
  

完全可以脱离Docker Desktop运行Docker，主要有两种方式：

方式一：在WSL2中直接安装Docker Engine #

这是当前推荐的方案，步骤如下：

1. 启用WSL2与虚拟机平台（未开启时执行）：

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   

   执行完成后重启电脑。
2. 设置WSL2为默认版本并安装Ubuntu发行版：

   wsl --set-default-version 2
   

   从微软商店下载安装Ubuntu。
3. 在Ubuntu环境中安装Docker Engine：
   • 更新apt包索引：

     sudo apt update
     

   • 安装依赖包：

     sudo apt install ca-certificates curl gnupg
     

   • 添加Docker官方GPG密钥：

     sudo install -m 0755 -d /etc/apt/keyrings
     curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
     sudo chmod a+r /etc/apt/keyrings/docker.gpg
     

   • 添加Docker软件源：

     echo \
       "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
       $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
       sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
     

   • 安装Docker Engine：

     sudo apt update
     sudo apt install docker-ce docker-ce-cli containerd.io
     

   • 配置用户权限（避免每次用sudo）：

     sudo usermod -aG docker $USER
     

   退出Ubuntu并重新登录后，即可直接使用docker命令。

方式二：使用Docker Toolbox（旧方案） #

适用于Windows 10家庭版或不支持WSL2的旧系统：

• 下载Docker Toolbox安装包并完成安装
• 启动Docker Quickstart Terminal，工具会自动创建VirtualBox虚拟机并启动Docker服务
• 后续可通过该终端或配置环境变量后在本地命令行使用Docker命令

内容的提问来源于stack exchange，提问作者Joe Konlan