Azure Web Service自定义Windows容器端口配置故障排查

问题背景 #

将.NET Core应用部署至Azure Web Service自定义Windows容器时出现端口暴露异常：

• 应用在无容器的Azure Web Service中运行正常
• 应用内部监听5000端口，但无法对外暴露443端口
• 已尝试两种配置均失败：
  • 未设置WEBSITES_PORT/PORT：应用启动，日志显示Now listening on: http://localhost:5000，浏览器访问提示「未暴露端口的容器将在后台模式运行」
  • 设置PORT=5000或WEBSITES_PORT=5000：应用启动，但Azure Web Service无法识别容器就绪，持续提示无法访问容器的5000端口HTTP端点

部署中心日志详情 #

2024年1月21日 18:40:09.953 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 启动容器成功。
2024年1月21日 18:40:18.848 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 容器已启动。
2024年1月21日 18:40:18.875 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 正在自定义容器
2024年1月21日 18:40:20.938 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 容器自定义已成功完成
2024年1月21日 18:40:20.946 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 容器已启动。
2024年1月21日 18:40:20.946 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 正在启用远程管理...
2024年1月21日 18:40:21.111 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 远程管理已成功启用！
2024年1月21日 18:40:21.689 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 容器入口点已启动
2024年1月21日 18:40:42.733 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 等待容器就绪。容器ID：814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312
2024年1月21日 18:41:03.795 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 等待容器就绪。容器ID：814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312

... [重复多次]

2024年1月21日 18:55:05.470 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 等待容器就绪。容器ID：814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312
2024年1月21日 18:55:26.514 警告 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 容器未及时就绪
2024年1月21日 18:55:26.515 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 容器启动和配置已成功完成
2024年1月21日 18:56:47.554 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 无法访问容器的HTTP端点。请检查应用是否健康并暴露至端口：5000。已失败1次检查。连续失败超过3次将标记容器为不可访问。
2024年1月21日 18:58:08.601 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 无法访问容器的HTTP端点。请检查应用是否健康并暴露至端口：5000。已失败2次检查。连续失败超过3次将标记容器为不可访问。
2024年1月21日 18:59:29.655 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 无法访问容器的HTTP端点。请检查应用是否健康并暴露至端口：5000。已失败3次检查。连续失败超过3次将标记容器为不可访问。
2024年1月21日 18:59:29.655 错误 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 无法访问容器的HTTP端点。请检查应用是否健康并暴露至端口：5000
2024年1月21日 18:59:29.655 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 应用设置CONTAINER_AVAILABILITY_CHECK_MODE设为ReportOnly。容器不会被回收。若要在容器不可访问时自动回收，请设置为Repair
2024年1月21日 19:00:50.704 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 无法访问容器的HTTP端点。请检查应用是否健康并暴露至端口：5000。已失败1次检查。连续失败超过3次将标记容器为不可访问。
2024年1月21日 19:02:11.744 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 无法访问容器的HTTP端点。请检查应用是否健康并暴露至端口：5000。已失败2次检查。连续失败超过3次将标记容器为不可访问。
2024年1月21日 19:03:32.765 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 无法访问容器的HTTP端点。请检查应用是否健康并暴露至端口：5000。已失败3次检查。连续失败超过3次将标记容器为不可访问。
2024年1月21日 19:03:32.765 错误 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 无法访问容器的HTTP端点。请检查应用是否健康并暴露至端口：5000
2024年1月21日 19:03:32.765 信息 - 站点：[应用服务名称] - [814589c27f3f405bfd3cb9ac6c51b1110d95265f8bdeb069ce611f361b6b5312] - 应用设置CONTAINER_AVAILABILITY_CHECK_MODE设为ReportOnly。容器不会被回收。若要在容器不可访问时自动回收，请设置为Repair

解决方案 #

1. 修正应用监听地址 #

.NET Core默认仅监听localhost，容器内必须监听0.0.0.0才能让Azure宿主访问：

• 代码配置：在Program.cs中添加监听地址：

  var builder = WebApplication.CreateBuilder(args);
  // 全局设置监听地址
  builder.WebHost.UseUrls("http://0.0.0.0:5000");
  var app = builder.Build();
  // ...其他中间件配置
  app.Run();
  

• 环境变量配置：在Dockerfile或Azure应用配置中设置ASPNETCORE_URLS=http://0.0.0.0:5000

2. 完善Dockerfile配置 #

确保Dockerfile中添加端口暴露指令：

# 基于官方.NET Core镜像构建
FROM mcr.microsoft.com/dotnet/aspnet:7.0-windowsservercore-ltsc2022
WORKDIR /app
COPY . .
# 暴露应用监听端口
EXPOSE 5000
# 启动应用
ENTRYPOINT ["dotnet", "YourApp.dll"]

3. 优化Azure应用服务配置 #

• 同时设置WEBSITES_PORT=5000和ASPNETCORE_URLS=http://0.0.0.0:5000（Windows容器优先识别WEBSITES_PORT）
• 若需要容器不可访问时自动重启，将CONTAINER_AVAILABILITY_CHECK_MODE设为Repair

4. 验证容器内部可用性 #

通过Azure门户的「容器SSH」功能进入容器，执行以下命令确认应用正常响应：

Invoke-WebRequest http://localhost:5000 -UseBasicParsing

若返回HTTP 200则说明应用内部正常，问题出在端口映射或监听地址。

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