Docker容器启动正常但无法curl访问，求排查思路

• 确认容器运行状态
  执行docker ps查看容器是否处于Up状态。如果容器是Exited或Restarting状态，先通过docker logs <容器ID>排查启动失败原因。

• 检查端口映射配置
  启动容器时必须通过-p参数做端口映射，比如docker run -p 8080:8080 myImage:1.0.0，将主机8080端口映射到容器内的8080端口。无端口映射的话，主机无法直接访问容器内端口。

• 修正容器IP的查询方式
  你当前查询的是镜像（myImage:1.0.0），镜像本身没有IP地址。需要查询运行中的容器的IP：

  docker inspect <容器ID或容器名> | grep "IPAddress"
  # 更简洁的方式
  docker inspect <容器ID> -f '{{.NetworkSettings.IPAddress}}'
  

  拿到容器IP后，尝试在主机上执行curl -X POST http://<容器IP>:8080/，验证容器内服务是否可正常响应。

• 在容器内部验证服务可用性
  进入容器内部直接访问服务，确认服务本身是否正常：

  docker exec -it <容器ID> curl -X POST http://0.0.0.0:8080/
  

  如果内部访问也失败，说明服务启动存在问题，需排查应用代码或依赖配置。

• 检查服务监听地址
  进入容器，用工具确认服务实际监听的地址：

  # 容器内无netstat时先安装
  apt update && apt install -y net-tools
  netstat -tulpn | grep 8080
  # 或用ss命令
  ss -tulpn | grep 8080
  

  确保输出中的监听地址是0.0.0.0:8080，而非127.0.0.1:8080（后者仅容器内部可访问）。

• 排查主机防火墙/安全组
  如果主机启用了防火墙（如ufw、iptables），或是云服务器，需确认8080端口已开放：

  • ufw：ufw allow 8080
  • iptables：iptables -A INPUT -p tcp --dport 8080 -j ACCEPT
  • 云服务器安全组：添加入站规则，允许TCP 8080端口访问。

• 检查容器网络模式
  如果使用--network host模式，容器会共享主机网络栈，此时无需端口映射，直接用主机IP:8080访问即可。如果是自定义网络，需确认网络配置正常，容器可正常接入网络。

内容的提问来源于stack exchange，提问作者jereczq22