客户端连接 docker 守护进程超时，本质是 cli 在 docker_client_timeout 限制内未能完成与 docker.sock 或 tcp 端口的建立，需检查守护进程状态、socket 权限、docker_host 配置及网络可达性。
客户端连接 docker 守护进程超时，通常发生在执行 docker 命令时卡住几秒后报错，例如：
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? 或更明确的提示如 connection timeout。这类超时不是镜像拉取超时，而是客户端尝试连接守护进程 socket（或 TCP 端口）失败导致的——关键在于客户端自身的等待时限。
客户端连接超时由环境变量控制
Docker CLI 默认使用 Unix socket（/var/run/docker.sock），连接过程本身不设硬性超时，但底层 HTTP 客户端库会受系统级网络超时影响。真正可配置的客户端连接等待上限，依赖两个环境变量：
-
DOCKER_HOST：指定连接地址（如
tcp://192.168.1.100:2375），若指向远程主机且网络延迟高，连接建立时间易触发系统默认超时； - DOCKER_CLIENT_TIMEOUT：显式设定客户端发起请求后的最大等待秒数（单位：秒），适用于所有操作，包括连接守护进程、发送命令、等待响应等。
例如，在 shell 中设置：
export DOCKER_CLIENT_TIMEOUT=120
这样，当客户端尝试连接守护进程或等待其响应时，最长等待 120 秒才放弃。
守护进程监听方式影响连接可靠性
客户端能否快速连上，还取决于守护进程是否按预期方式监听：
- 默认只监听
unix:///var/run/docker.sock，本地连接快且稳定； - 若配置为
-H tcp://0.0.0.0:2375远程访问，需确保防火墙放行该端口，且网络路径无丢包或中间设备干扰； - 若同时启用
unix和tcp，但DOCKER_HOST指向 TCP 地址而网络不通，客户端就会在DOCKER_CLIENT_TIMEOUT后报错。
验证与调试建议
遇到连接超时，可按顺序排查：
- 运行
sudo systemctl status docker确认守护进程处于active (running)； - 检查 socket 文件是否存在且权限正确：
ls -l /var/run/docker.sock，应属root:docker，当前用户需在docker组； - 临时设置超时并测试：
DOCKER_CLIENT_TIMEOUT=300 docker info，观察是否仍超时； - 若用 TCP 连接，用
nc -zv host port或telnet host port验证端口可达性。
