Docker中运行.NET API启用HTTPS安全连接失败如何解决

1 核心问题定位 #

• 你的Dockerfile仅暴露了80端口，未配置HTTPS所需的443端口暴露；启动命令中-p 8082:443将宿主机8082端口映射到容器443端口，但容器内的ASP.NET Core服务默认没有启用443端口监听，也没有绑定SSL证书，直接访问必然触发ERR_SSL_PROTOCOL_ERROR错误。
• Ubuntu本地运行显示不安全，是因为.NET自带的开发证书仅用于本地测试，没有被系统根证书信任，属于测试环境正常现象，生产环境需要替换为正规CA颁发的证书。
• 仅添加app.UseHttpsRedirection()中间件只能实现HTTP请求到HTTPS的重定向，前提是服务本身已经完成HTTPS监听配置，否则该中间件无法生效。

2 具体解决操作 #

步骤1：准备SSL证书 #

测试环境可以生成自签名证书，生产环境请使用正规CA签发的对应域名证书，将证书保存为pfx格式，放到服务器指定目录例如/home/ssl/cert.pfx，记录好证书的访问密码。

步骤2：修改Dockerfile配置 #

在Dockerfile的final阶段新增443端口暴露，修改后对应部分如下：

FROM base AS final
WORKDIR /app
EXPOSE 80
EXPOSE 443 # 新增HTTPS端口暴露
COPY --from=publish /app/publish .
ENV ASPNETCORE_ENVIRONMENT="Development"
ENTRYPOINT ["dotnet", "MetuljmaniaDatabase.dll"]

修改完成后重新构建Docker镜像。

步骤3：调整Docker启动命令 #

添加证书挂载、HTTPS相关环境变量，修正端口映射配置，修改后的启动命令如下：

docker run --name backend \
--mount type=bind,source=/home/mjancic/Documents/Data,target=/Data \
--mount type=bind,source=/home/ssl/cert.pfx,target=/app/ssl/cert.pfx \
-e ASPNETCORE_Kestrel__Certificates__Default__Password="你的证书密码" \
-e ASPNETCORE_Kestrel__Endpoints__Https__Url="https://0.0.0.0:443" \
-e ASPNETCORE_Kestrel__Endpoints__Http__Url="http://0.0.0.0:80" \
-p 8081:80 -p 8082:443 \
metuljmania/dockerapi

步骤4：验证配置 #

容器启动后，先在服务器本地执行curl -v https://localhost:8082/swagger确认可以正常返回内容，再通过外部设备访问对应域名+8082端口验证HTTPS有效性。如果使用自签名证书，外部访问仍会提示不安全，替换为正规CA签发的域名证书即可消除该提示。

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