首页/云/Docker 容器速查/Cannot connect to the Docker daemon 排查
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条Compose 编排55 条资源与安全50 条
容器排障52 条

Cannot connect to the Docker daemon 排查

报错指向守护进程不可达:按顺序查服务状态、套接字文件、context 指向与 DOCKER_HOST 环境变量,四步内可定位。

Docker 容器速查云更新于 2026-10-12
报错全文Cannot connect ... Is the docker daemon running?
与权限的区别permission denied 是另一类(见 socket 权限条目)
环境检查context / DOCKER_HOST / rootless 套接字路径

示例

示例
systemctl status docker --no-pager | head -20
docker context ls
ls -l /var/run/docker.sock 2>/dev/null || ls -l /run/user/$(id -u)/docker.sock 2>/dev/null
echo "DOCKER_HOST=$DOCKER_HOST"
Windows/macOS 上 Docker Desktop 未启动时同样报此错,先看托盘状态是否 Running。

易错点

  • 改了 DOCKER_HOST 却忘了自己改过,是远程排障脚本里高频自坑
  • rootless 实例的套接字在 /run/user/<uid>/docker.sock,用系统路径排查会找不到

数据来源与参考

  • Docker 官方文档:Troubleshoot the Docker daemon(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌