在Docker上使用HTTPS运行Asp.net core网站时出现错误如何解决？

1. 排查端口占用问题 #

你配置了network_mode: "host"，容器会直接复用宿主机的网络栈，首先确认宿主机443端口未被其他服务占用：

# 查看443端口占用
sudo lsof -i :443
# 或者用netstat
netstat -tulpn | grep 443

如果存在占用，停止对应服务，或修改ASPNETCORE_URLS中的HTTPS端口为未占用端口。

2. 修复证书文件权限 #

ASP.NET Core官方镜像默认使用UID为1654的app用户运行服务，宿主机挂载的证书目录/文件需要给该用户开放读取权限：

# 给证书目录授权
sudo chown -R 1654:1654 /home/user/.aspnet/https
# 给证书文件设置最小可用权限
chmod 600 /home/user/.aspnet/https/aspnetapp.pfx

注意确认证书生成时设置的密码和ASPNETCORE_Kestrel__Certificates__Default__Password参数完全一致。

3. 排查代码硬编码冲突 #

检查项目的Program.cs/Startup.cs文件，确认没有硬编码Kestrel的监听地址、证书配置，硬编码配置优先级高于环境变量，会导致传入的环境变量失效。

4. 确认防火墙规则 #

使用host网络模式时，需要放行宿主机443端口的入站规则：

# ufw防火墙
sudo ufw allow 443/tcp
# firewalld防火墙
sudo firewall-cmd --add-port=443/tcp --permanent
sudo firewall-cmd --reload

5. 开启Debug日志定位根因 #

如果上述排查后仍报错，在docker-compose的环境变量中新增以下参数，输出详细Debug日志定位具体故障点：

- ASPNETCORE_LOGGING__CONSOLE__LOGLEVEL__DEFAULT=Debug

启动容器后查看日志，可明确区分是端口绑定失败、证书加载失败还是其他业务逻辑报错。

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