错误本质是客户端无法通过 Unix socket 与守护进程通信，主因仅为守护进程未运行或当前用户无访问权限；执行 systemctl status docker（Linux）或查看 Docker Desktop 图标（Windows/macOS）可快速排除 60% 问题。
docker ps 报 “Cannot connect to the Docker daemon” 怎么快速定位
这不是客户端坏了，而是客户端根本没连上守护进程。错误本身不区分原因，但实际只有两类主因：服务压根没起来，或者你没权限连上去。先跑 systemctl status docker（Linux）或看 Docker Desktop 右下角图标状态（Windows/macOS），一眼就能排除 60% 的问题。
常见错误现象：
- 命令卡住几秒后报错，不是立刻失败 → 很可能是守护进程在启动中（
START_PENDING）或 WSL2 未就绪 -
docker version能显示客户端版本但报 daemon 连接失败 → 守护进程层断开，不是 CLI 问题 - 同一台机器上
sudo docker ps成功，普通用户失败 → 权限组或 socket 权限问题
Windows 上 Docker Desktop 卡在 “Starting…” 或报 0x80070570
这个错误码本质是文件系统损坏，90% 指向 WSL2 发行版或虚拟磁盘出问题。Docker Desktop 在 Windows 上依赖 WSL2 启动 Linux 内核环境，一旦底层磁盘映像损坏，整个引擎就起不来。
实操建议：
- 先运行
wsl -l -v看 WSL 发行版状态，如果显示Stopped但手动wsl -d docker-desktop启动失败，基本确认发行版损坏 - 不要重装 Docker Desktop，直接重置 WSL：执行
wsl --unregister docker-desktop，再重启 Docker Desktop，它会自动重建发行版 - 若仍报 0x80070570，检查磁盘是否启用 BitLocker 或第三方加密软件 —— 它们会干扰 WSL2 虚拟磁盘读写
- 避免在非 NTFS 分区（如 exFAT 移动硬盘）上存放 WSL 数据，Docker Desktop 不支持
/var/run/docker.sock 权限为 srw-rw---- 但还是连不上
权限数字对、属组是 docker，不代表一定能用。关键要看当前 shell 会话是否“感知”到组变更。Linux 用户组变更不会热生效，必须重载会话上下文。
容易踩的坑：
-
usermod -aG docker $USER执行完立刻开新终端 ≠ 生效：要关掉所有已有终端窗口（包括 tmux/screen 会话），再全新打开 - 用
newgrp docker可临时切换组，但会启新 shell，退出后失效，不适合脚本或 CI 环境 - 某些桌面环境（如 GNOME Wayland）可能缓存旧组信息，需完全注销用户再登录
- 检查
id -gn输出是否为docker，不是则说明组未加载；再查ls -l /var/run/docker.sock，确认属组确实是docker，不是root或其他
daemon.json 配置错误导致服务启动失败但无明显提示
Docker 守护进程加载 /etc/docker/daemon.json 时，只要 JSON 格式错一个逗号、值类型不匹配、或用了不支持的字段，就会静默失败 —— systemctl start docker 返回 success，但实际没起来，journalctl -u docker 里才有真实报错。
排查要点：
- 用
jq . /etc/docker/daemon.json验证语法，报错就说明 JSON 不合法 - 注释掉整个文件内容，改为空 JSON
{}，然后sudo systemctl restart docker，能启就是配置问题 - 常见雷区：
"storage-driver": "overlay"（应为overlay2）、"insecure-registries"里写了不可达地址、"bip"子网与宿主机冲突 - 修改后务必用
sudo systemctl daemon-reload，否则 systemd 不会重新读取服务定义
最常被忽略的是：WSL2 环境下 Docker Desktop 的日志藏在 \wsl$docker-desktop-datalog，而不是 Linux 传统路径；而 daemon.json 错误在 Windows 上不会触发弹窗，只停在启动动画里 —— 必须去日志里翻才能看到真实原因。
