WSL2安装DDEV时遇Docker连接失败问题求助

一、修复WSL2内Docker Daemon运行问题 #

• 检查Docker服务状态
  在WSL终端执行：

  sudo systemctl status docker
  

  若显示未运行，启动服务：

  sudo systemctl start docker
  

  设置开机自启，避免每次重启WSL手动启动：

  sudo systemctl enable docker
  

• 验证Docker Daemon可用性
  执行测试命令确认正常运行：

  docker run --rm hello-world
  

  若成功输出hello-world内容则Daemon正常；若报错，检查WSL2内核版本（需5.10+），执行uname -r查看，版本过低则通过Windows更新升级WSL内核。

二、让DDEV正确关联WSL2内的Docker #

• 将当前用户加入docker组
  默认仅root可运行docker，普通用户需加入组：

  sudo usermod -aG docker $USER
  

  退出并重新打开WSL终端，执行docker ps，无需sudo即可运行则配置成功。

• 重置DDEV的Docker上下文
  在WSL终端执行：

  ddev poweroff
  ddev config global --wsl2 --docker-context=default
  

  之后尝试启动项目：

  ddev start
  

三、Windows终端操作说明 #

你在Windows终端执行docker -v报错，是因为未在Windows系统安装Docker客户端。由于你选择的是WSL内置Docker方案，所有DDEV操作都应在WSL终端内完成，Windows端的ddev快捷方式依赖Windows版Docker客户端，并非该方案的必要组件。

若非要在Windows终端使用，需额外安装Windows版Docker客户端并配置连接到WSL2的Docker daemon，但这不属于官方推荐的无Docker Desktop方案，建议优先使用WSL终端操作。

四、其他排查方向 #

• 确认WSL2为默认版本：在Windows终端执行wsl --set-default-version 2，并通过wsl -l -v检查发行版类型为WSL2
• 暂时关闭其他虚拟化软件（如VirtualBox），避免与WSL2的Hyper-V依赖冲突
• 重新安装WSL内的Docker：

  sudo apt remove docker docker-engine docker.io containerd runc
  sudo apt update && sudo apt install docker.io docker-compose-v2
  

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