Linux环境Docker Compose部署ASP.NET Core端口无法修改问题求助

直接解决方案 #

你当前的核心问题是：启动容器使用的docker-compose.yml中未配置ASPNETCORE_URLS环境变量，仅debug版本的compose配置了该参数，导致ASP.NET Core默认使用5000端口监听。按以下步骤修改即可：

1. 修改docker-compose.yml的environment配置块，添加监听端口指定：

environment:
  - DBHOST=database
  - ASPNETCORE_ENVIRONMENT=Production
  - ASPNETCORE_URLS=http://+:80  # 新增这行，指定容器内服务监听80端口

2. 若你需要修改容器内服务的监听端口（比如改为8080），同步修改以下三处配置即可：
   • Dockerfile中EXPOSE 80/tcp改为EXPOSE 8080/tcp
   • 上述ASPNETCORE_URLS值改为http://+:8080
   • docker-compose.yml的端口映射改为"宿主机端口:8080"，比如要宿主机用8888访问就写"8888:8080"
3. 配置修改后执行带重新构建的启动命令，避免旧镜像缓存导致配置不生效：
   docker-compose -f docker-compose.yml up --build -d

后续排查调试思路 #

• 查看服务启动日志确认监听端口：执行docker logs <容器名/容器ID>，ASP.NET Core启动时会打印Now listening on: http://[::]:端口的日志，可直接确认服务实际监听的端口
• 验证容器内环境变量是否生效：执行docker exec <容器名/容器ID> printenv | grep ASPNETCORE，检查ASPNETCORE_URLS参数是否存在、值是否正确
• 确认容器端口映射关系：执行docker port <容器名/容器ID>，检查宿主机端口和容器端口的映射是否符合预期
• 检查容器内进程实际监听端口：执行docker exec <容器名/容器ID> ss -tlnp，查看dotnet进程对应的监听端口是否正确
• 排除代码硬编码问题：如果以上配置都正确但服务仍监听5000，检查项目的Program.cs/Startup.cs中是否存在UseUrls("http://*:5000")这类硬编码端口的逻辑，代码配置优先级高于环境变量，硬编码的情况下修改配置文件无效

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