Umbraco 10(.NET6)Docker部署访问空响应/端口绑定问题排查

问题现象 #

• 本地Mac环境安装最新.NET SDK，通过dotnet new umbraco --name Umbraco10Test创建全新项目，本地发布、运行流程全部正常，默认5000端口可正常访问完成安装
• 在appsettings.json中添加Kestrel配置将监听端口改为4000，本地通过http://localhost:4000访问正常
• 编写Dockerfile构建镜像，执行docker run -p 4000:4000启动容器后，访问4000端口返回ERR_EMPTY_RESPONSE，curl请求返回curl: (52) Empty reply from server
• 进入运行中的容器手动执行启动脚本，报错提示Failed to bind to address http://127.0.0.1:4000: address already in use

根因分析 #

1. 配置优先级不匹配：ASP.NET Core运行时，appsettings.json中定义的Kestrel Endpoints配置优先级高于ASPNETCORE_URLS环境变量。你在appsettings.json中配置的监听地址是http://localhost:4000，该配置在容器内会被解析为绑定127.0.0.1:4000（容器内部回环地址），导致Dockerfile中设置的ASPNETCORE_URLS="http://*:4000"完全不生效。
2. 监听地址范围错误：绑定127.0.0.1的服务仅能被容器内部进程访问，Docker端口转发规则默认转发请求到容器的0.0.0.0虚拟网卡，无法触达回环地址上监听的服务，因此外部请求全部返回空响应。进入容器手动执行脚本提示端口占用，是因为容器启动时ENTRYPOINT已经拉起dotnet进程占用了127.0.0.1:4000，不存在其他未知端口占用问题，和HTTPS/SSL配置也没有关系。

修复方案 #

二选一即可：

• 方案1：修改appsettings.json中的Kestrel配置，将监听地址从localhost改为通配地址，覆盖所有网卡：

"Kestrel": {
  "Endpoints": {
    "properties": {
      "Url": "http://0.0.0.0:4000"  
    }
  } 
}

修改完成后重新构建镜像、启动容器即可正常访问。

• 方案2：直接删除appsettings.json中自定义的Kestrel配置段，让Dockerfile中设置的ASPNETCORE_URLS="http://*:4000"生效，配置中的*会默认绑定容器内所有网卡的4000端口，无需额外配置Kestrel规则。

可选优化 #

当前Dockerfile中单独生成entrypoint.sh的步骤可以简化，不需要额外创建启动脚本，直接将ENTRYPOINT配置替换为以下内容即可，减少镜像冗余层：

ENTRYPOINT ["dotnet", "Umbraco10Test.dll"]

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