Kubuntu系统安装配置Docker后ddev无法识别Docker的问题排查求助

权限与状态排查 #

• 确认Docker服务正常运行：执行systemctl status docker，查看Active状态是否为active (running)，如果未运行执行sudo systemctl enable --now docker设置开机自启并立即启动
• 验证当前用户Docker权限：执行docker run hello-world，如果需要加sudo才能运行，说明当前用户未加入docker用户组，执行sudo usermod -aG docker $USER，执行后需完全注销当前系统会话再重新登录，或直接重启系统生效
• 检查Docker套接字权限：执行ls -l /var/run/docker.sock，正常权限应为所属组为docker、组权限可读写，若权限异常执行sudo chgrp docker /var/run/docker.sock && sudo chmod 660 /var/run/docker.sock修复

兼容与配置排查 #

• 更新DDEV到最新版本：执行curl -L https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh | bash重新安装，旧版DDEV可能存在与Docker 20.10.8版本的兼容问题
• 检查Docker daemon配置：查看/etc/docker/daemon.json文件，如果该文件存在且配置了自定义hosts参数，确认未修改默认unix套接字路径，DDEV默认读取/var/run/docker.sock路径通信
• 若你修改过Docker套接字默认路径，可在shell配置文件（.bashrc/.zshrc）中添加export DOCKER_HOST=unix://<你的自定义套接字路径>，保存后执行source ~/.bashrc（zsh用户替换为对应配置文件路径）生效

临时验证方案 #

如果以上步骤完成后仍无法启动，可执行sudo ddev start临时用管理员权限启动测试，若可正常启动则说明用户权限配置未生效，需重新检查用户组配置和会话登录状态

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