Docker中运行ASP.NET Core应用遇443端口占用问题求助

遇到Failed to bind to address https://[::]:443: address already in use错误，且删除容器、重启Docker无效，可按以下步骤排查：

1. 排查宿主机443端口占用 #

• Linux/macOS：执行命令查看占用进程：

  netstat -tulpn | grep :443
  

  输出里的PID/进程名就是占用端口的程序，用kill -9 <PID>终止进程后重试。
• Windows：执行命令查看占用进程ID：

  netstat -ano | findstr ":443"
  

  打开任务管理器，找到对应PID的进程并结束。

2. 调整Docker端口映射规则 #

• 若宿主机443确实被其他服务占用，修改容器启动命令的端口映射，将宿主机端口替换为未被占用的端口，比如：

  docker run -p 8443:443 -p 8080:80 your-image-name
  

  此时通过https://localhost:8443访问应用。

3. 检查应用绑定配置 #

• 查看ASP.NET Core应用的Program.cs或appsettings.json，确认是否硬编码绑定了443端口：
  • 若代码中有UseUrls("https://*:443")，可修改为动态端口或添加其他端口；
  • 启动容器时通过环境变量覆盖绑定地址：

    docker run -e ASPNETCORE_URLS="https://*:443;http://*:80" -p 443:443 your-image-name
    

4. 排查容器内部端口占用 #

• 临时修改容器启动命令，进入容器终端排查内部进程：

  docker run -it --rm --entrypoint bash your-image-name
  

  在容器内执行netstat -tulpn | grep :443，确认是否有其他进程（如安装的wkhtmltox等工具）占用了443端口，若有则停止对应进程或调整应用端口。

5. 清理Docker网络残留 #

• 清理未使用的Docker网络，避免网络冲突：

  docker network prune
  

  之后重新创建网络并启动容器：

  docker network create app-network
  docker run --network app-network -p 443:443 your-image-name
  

6. 检查Docker守护进程配置 #

• 若使用Docker Desktop，进入设置页面，确认是否有服务（如Kubernetes、HTTPS代理等）占用了443端口，调整对应服务的端口后重启Docker。

内容的提问来源于stack exchange，提问作者Евгений