Docker端口连接失败解决方案

当遇到Docker容器端口连接失败的问题时，可以按照以下步骤进行排查和解决：

1. 检查容器运行状态

docker ps -a

确认容器是否正在运行（STATUS为"Up"），如果容器未运行，先启动它：

docker start <容器名或ID>

2. 验证端口映射

docker port <容器名或ID>

或查看详细信息：

docker inspect <容器名或ID> | grep -i port

确认端口映射是否正确，格式应为 0.0.0.0:主机端口->容器端口。

3. 检查防火墙设置

• Linux:

  sudo ufw status
  sudo ufw allow <端口号>
  

• Windows: 检查Windows Defender防火墙设置

• Mac: 检查系统偏好设置中的防火墙

4. 测试容器内部服务

进入容器内部测试服务是否正常运行：

docker exec -it <容器名或ID> /bin/bash
# 然后在容器内测试服务
curl localhost:<容器端口>

5. 检查主机网络配置

• 确保没有其他服务占用相同的主机端口
• 尝试使用 127.0.0.1 而不是 localhost 进行连接
• 如果是远程连接，确保使用正确的IP地址

6. 重新创建容器

如果以上步骤无效，尝试重新创建容器：

docker stop <容器名或ID>
docker rm <容器名或ID>
docker run -p <主机端口>:<容器端口> [其他选项] <镜像名>

7. 检查Docker网络模式

如果是自定义网络，确保网络配置正确：

docker network ls
docker network inspect <网络名>

8. 查看容器日志

docker logs <容器名或ID>

检查是否有错误信息表明服务启动失败。

9. 特殊环境检查

• Windows/Mac Docker Desktop: 确保Docker Desktop正在运行
• WSL2环境: 检查WSL2网络配置
• 云服务器: 检查安全组规则是否开放相应端口

10. 高级调试

如果问题仍然存在，可以尝试：

# 在主机上检查端口监听
netstat -tuln | grep <端口号>  # Linux
lsof -i :<端口号>             # Mac

# 检查Docker守护进程日志
journalctl -u docker.service  # systemd系统

通过以上步骤应该能够定位并解决大多数Docker端口连接问题。