Docker 客户端连不上守护进程：深度排查指南
can not connect to docker daemon 的深层原因：DOCKER_HOST 环境变量指错、socket 路径被改、WSL/Desktop 集成断开、守护进程崩溃循环。本文按客户端→socket→守护进程三层排查。
排查框架：客户端连守护进程走"环境变量 → socket 文件 → 进程"三层。依次检查：echo $DOCKER_HOST（是否被指向别处）→ ls -l /var/run/docker.sock（socket 在不在、权限对不对）→ systemctl status docker + journalctl -u docker（进程状态与崩溃原因）。
第一层：客户端连的是哪儿
echo $DOCKER_HOST
docker context ls
- DOCKER_HOST非空可能仍指本地unix socket；结合DOCKER_CONTEXT、--context/-H和docker context inspect核对最终端点，不要直接unset
- 有多个 context → 当前context可能指向远程或Desktop/rootless；只在确认目标后选择正确context，default不保证是目标
这是"昨天还好好的"最常见的元凶——装了某个工具或执行了 eval $(minikube docker-env) 之类命令改了环境。
第二层：socket 文件
ls -l /var/run/docker.sock
# 正常：srw-rw---- root docker
- 在已确认连接此socket时，缺失可能是服务未启动；也可能实际使用rootless/Desktop/自定义socket，进第三层
- 权限不对 → 传统rootful安装可考虑docker组（权限近似主机root，应授权后设置）；rootless需检查用户socket与用户服务，不应盲目加组：
sudo usermod -aG docker $USER后重登 - 自定义过 socket 路径 → 检查
/etc/docker/daemon.json的hosts配置与 systemd unit 是否冲突（两者同时配 hosts 会导致启动失败）
第三层：守护进程进程
sudo systemctl status docker
sudo journalctl -u docker -n 100 --no-pager
日志里常见死因：
| 日志关键词 | 原因 | 处理 |
|---|---|---|
daemon.json: invalid character |
配置语法错 | 修正 JSON |
no space left on device |
磁盘满 | 清理后重启 |
failed to start daemon: ... iptables |
防火墙模块问题 | 检查内核模块/重启网络 |
crash loop（反复重启） |
守护进程崩溃循环 | 核对完整错误、资源与配置原因，再决定修复或升级 |
特殊环境
Docker Desktop（Mac/Win）：检查Desktop是否就绪及context/集成/后端健康；Restart与恢复出厂设置不同，Reset可能删除本地数据，不能作为普通重启步骤。
WSL2：确认 WSL 集成开启（Desktop 设置 → Resources → WSL Integration）；混用 WSL 内自装 docker 与 Desktop 时 context 易乱。
常见问题（FAQ）
Q：sudo docker 能用，普通用户不行？
A：可能是权限，也可能sudo使用了不同环境/context；先比较实际端点再决定授权方式。
Q：systemctl 显示 active 但客户端连不上？
A：查 DOCKER_HOST 与 context——active只表示服务状态，不保证API健康；还需检查socket权限、实际监听、TLS和服务日志。
Q：重装 Docker 能解决一切吗？
A：能解决守护进程自身损坏，但解决不了环境变量/权限问题；先按三层排查，别上来就重装（镜像数据在 /var/lib/docker，重装前要备份）。
