Docker容器中.NET Web API公网访问配置问题排查

以下是针对你的问题的具体排查方向，按顺序逐一验证：

• 确认容器运行状态与日志
  执行docker ps查看容器是否处于Up状态，如果是Exited或Restarting，说明服务启动失败。
  查看容器日志定位错误：docker logs <容器名>，重点关注.NET API启动时的报错信息（比如端口绑定失败、依赖缺失、配置错误等）。

• 验证容器内部服务可用性
  进入容器内部：docker exec -it <容器名> bash（若为Alpine基础镜像，替换为sh），然后执行curl http://localhost:80。如果能返回API的正常响应，说明服务在容器内正常运行；若无响应，说明API本身启动失败或未正确监听80端口。

• 检查.NET API的绑定地址配置
  .NET默认会绑定localhost，这会导致容器外部无法访问服务。需要确保API绑定到0.0.0.0：

  • 代码层面：在Program.cs中添加builder.WebHost.UseUrls("http://0.0.0.0:80")
  • 环境变量：在Dockerfile中添加ENV ASPNETCORE_URLS=http://+:80，或在docker run命令中追加-e ASPNETCORE_URLS=http://+:80
  • 配置文件：检查appsettings.json中的Urls字段是否设置为http://0.0.0.0:80

• 检查服务器防火墙/安全组规则
  确认服务器本地防火墙和云服务商安全组已开放8080端口的TCP流量：

  • 若使用ufw：执行sudo ufw allow 8080/tcp，再执行sudo ufw reload
  • 若使用firewalld：执行sudo firewall-cmd --add-port=8080/tcp --permanent，再执行sudo firewall-cmd --reload
  • 云安全组：在控制台添加入站规则，允许目标IP访问8080端口

• 验证端口映射是否生效
  在服务器上执行ss -tulpn | grep 8080，查看是否有docker-proxy进程监听8080端口。如果没有相关进程，说明端口映射配置存在问题，需重新执行docker run命令并检查参数正确性。

• 测试端口连通性
  在本地机器执行telnet <服务器IP> 8080或nc -zv <服务器IP> 8080，测试端口是否能正常连通。如果无响应，说明端口未开放或映射未生效。

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