Docker 启动但无法连接的解决方案

当 Docker 服务已启动但无法连接时，可以按照以下步骤排查和解决问题：

1. 检查 Docker 服务状态

# 对于 Linux/Unix 系统
sudo systemctl status docker

# 对于 macOS (Docker Desktop)
open -a Docker

确保 Docker 服务显示为 "active (running)" 状态。

2. 检查 Docker 守护进程是否监听

# 检查 Docker 是否在监听 Unix socket
ls -l /var/run/docker.sock

# 检查 Docker 是否在监听 TCP 端口 (默认是 2375/2376)
netstat -tulnp | grep dockerd

3. 常见问题及解决方案

问题 1: 权限不足

症状: 执行 docker ps 时出现 "Got permission denied" 错误

解决方案:

sudo usermod -aG docker $USER
newgrp docker  # 或者重新登录

问题 2: Docker 守护进程未正确启动

解决方案:

# 重启 Docker 服务
sudo systemctl restart docker

# 或者对于 Docker Desktop
# 通过 GUI 重启 Docker

问题 3: 端口冲突

解决方案:

# 检查端口冲突
sudo netstat -tulnp | grep <端口号>

# 修改 Docker 配置使用不同端口

问题 4: 防火墙/安全组限制

解决方案:

# 检查防火墙规则
sudo ufw status  # Ubuntu
sudo firewall-cmd --list-all  # CentOS

# 添加允许规则
sudo ufw allow 2375/tcp

4. 检查 Docker 日志

# 查看 Docker 服务日志
journalctl -u docker.service -n 50 --no-pager

# 对于 Docker Desktop
# 查看应用程序日志

5. 重置 Docker 环境 (极端情况)

# 停止 Docker
sudo systemctl stop docker

# 清理 Docker 环境
sudo rm -rf /var/lib/docker/*

# 重新启动
sudo systemctl start docker

6. 针对 Docker Desktop 的特殊问题

• 确保已启用 "Expose daemon on tcp://localhost:2375 without TLS" (设置 > 常规)
• 检查虚拟机是否正常运行 (特别是 macOS 和 Windows 上的 Hyper-V/WSL2)

如果以上方法都不能解决问题，请提供具体的错误信息以便进一步诊断。