调试 Docker 守护进程需开启 debug 模式：通过 daemon.json 设置 "debug": true 并重启，或手动前台运行 sudo dockerd -D；配合 SIGUSR1 堆栈输出、strace 系统调用跟踪及 socket 连通性验证定位问题。
要调试 docker 守护进程（dockerd），核心是开启其调试模式并获取足够详细的运行日志，同时配合系统级工具定位卡死、崩溃或响应异常等问题。客户端（docker cli）本身不参与守护进程的调试逻辑，它只是向 dockerd 发送请求；真正需要调试的是守护进程自身的行为和内部状态。
启用守护进程调试模式
最常用且推荐的方式是通过配置文件开启全局调试输出：
- 编辑 /etc/docker/daemon.json（Linux）或 Docker Desktop 的“Preferences → Daemon → Advanced”（macOS/Windows）
- 添加
"debug": true字段，例如：
{
"debug": true,
"log-level": "debug"
}
- 保存后重启守护进程：
sudo systemctl restart docker（systemd 系统）或sudo kill -SIGHUP $(pidof dockerd) - 此时
dockerd会输出大量内部事件、网络连接、容器生命周期、驱动调用等信息，日志默认写入journald或/var/log/daemon.log，可用journalctl -u docker -f实时查看
手动前台启动调试守护进程
适用于快速验证配置、排查启动失败或隔离环境问题：
- 先停掉系统托管的
dockerd：sudo systemctl stop docker - 手动前台运行并启用调试：
sudo dockerd -D（-D等价于--debug） - 日志直接输出到终端，便于观察启动过程每一步是否卡住；Ctrl+C 可终止
- 可叠加其他调试参数，如
--log-level=debug、--debug-pprof（启用 pprof 性能分析端口）
捕获守护进程运行时状态
当 dockerd 假死、无响应但未退出时，可通过信号触发诊断输出：
-
sudo kill -SIGUSR1 $(pidof dockerd)：打印当前 goroutine 堆栈（类似 Go 程序的 panic 堆栈），帮助识别死锁或阻塞点 -
sudo dmesg | grep dockerd：检查内核是否因 OOM、权限或 cgroup 限制杀掉了 dockerd 或其子进程 -
sudo strace -p $(pidof dockerd) -s 256 -e trace=network,process,file：动态跟踪系统调用（需临时安装 strace），适合深挖挂起原因
检查客户端与守护进程通信链路
有时“调试失败”实际是客户端连不上守护进程，而非 dockerd 本身异常：
- 确认套接字路径是否可达：
ls -l /var/run/docker.sock，检查权限是否允许当前用户访问（通常属组docker） - 若使用 TCP 远程监听（如
-H tcp://0.0.0.0:2375），需确认DOCKER_HOST环境变量设置正确，且防火墙放行端口 - 用
curl --unix-socket /var/run/docker.sock http://localhost/version直接测试 Unix socket 通路
