如何为Docker中运行的.Net Core 3.1 API指定端口绑定规则

问题根因 #

你的Dockerfile中硬编码了环境变量ENV ASPNETCORE_URLS http://+:5000，这意味着容器内的Kestrel服务默认只会绑定监听5000端口，当你尝试将宿主端口映射到其他容器端口（比如7110）时，容器内对应端口没有服务处理请求，自然会连接失败。
同时你存在操作误区：-p 宿主端口:容器端口是端口映射的规则，你发起请求时需要访问的是宿主机的端口，而非容器内部端口，你第一条命令映射的是8060:7110，却访问localhost:7110，本身就是错误的操作。

解决方案 #

方案1：运行时动态指定监听端口（无需修改现有镜像） #

启动容器时通过-e参数覆盖ASPNETCORE_URLS环境变量，同步调整端口映射规则即可。比如你要让容器内部监听7110端口，宿主机用8060访问，命令如下：

docker run -d -p 8060:7110 -e ASPNETCORE_URLS=http://+:7110 golide/payapi:0.1.0

配置完成后访问http://localhost:8060/weatherforecast即可正常拿到响应。

方案2：修改Dockerfile默认监听多端口 #

如果希望镜像默认就支持多个端口监听，可以修改Dockerfile中的ASPNETCORE_URLS配置，示例如下：

# 替换原有ENV ASPNETCORE_URLS行，可同时配置多个监听端口
ENV ASPNETCORE_URLS http://+:5000;http://+:7110

重新构建镜像后，可自由选择映射任意一个已配置的容器端口：

# 映射到容器5000端口，宿主机用5000访问
docker run -d -p 5000:5000 golide/payapi:0.1.0
# 映射到容器7110端口，宿主机用8060访问
docker run -d -p 8060:7110 golide/payapi:0.1.0

方案3：完全自定义端口配置 #

如果不想在镜像中硬编码任何监听端口，直接删除Dockerfile中的ENV ASPNETCORE_URLS http://+:5000行即可，Kestrel默认会监听80端口，你也可以在启动容器时通过-e参数自由指定需要的监听端口。

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