ASP.NET Core 6部署Azure Linux App Service端口不匹配问题求助

一、端口参数的传递方式 #

Azure App Service Linux 会通过**PORT环境变量**将容器需要监听的端口传递给应用，WEBSITES_PORT仅用于告知App Service反向代理容器的监听端口——如果应用没读取PORT变量，仅设置WEBSITES_PORT不会生效。

二、Program.cs/Startup.cs 中捕获端口配置的代码 #

针对ASP.NET Core 6（顶级语句格式） #

在Program.cs里修改Kestrel配置，优先读取环境变量PORT， fallback到5000：

var builder = WebApplication.CreateBuilder(args);

// 配置Kestrel监听端口
builder.WebHost.ConfigureKestrel(serverOptions =>
{
    var port = Environment.GetEnvironmentVariable("PORT");
    if (!string.IsNullOrEmpty(port) && int.TryParse(port, out var portNumber))
    {
        serverOptions.ListenAnyIP(portNumber); // 必须监听所有IP，容器外部才能访问
    }
    else
    {
        serverOptions.ListenAnyIP(5000); // 默认端口
    }
});

// 其他中间件配置...
var app = builder.Build();
// ...
app.Run();

针对传统Startup.cs格式（兼容ASP.NET Core 1.x迁移代码） #

如果项目仍保留Startup.cs和Program.cs分离结构，在Program.cs中修改：

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.ConfigureKestrel(serverOptions =>
                {
                    var port = Environment.GetEnvironmentVariable("PORT");
                    if (!string.IsNullOrEmpty(port) && int.TryParse(port, out var portNumber))
                    {
                        serverOptions.ListenAnyIP(portNumber);
                    }
                    else
                    {
                        serverOptions.ListenAnyIP(5000);
                    }
                });
                webBuilder.UseStartup<Startup>();
            });
    }
}

三、强制App Service绑定5000端口的方法 #

方法1：代码硬编码固定端口 #

如果不需要动态适配端口，直接在Kestrel配置里固定监听5000：

// 在Program.cs的ConfigureKestrel中
serverOptions.ListenAnyIP(5000);

然后去Azure App Service的配置→应用程序设置里添加：

• 名称：WEBSITES_PORT，值：5000
  这个设置会让App Service反向代理把流量转发到容器的5000端口，同时解决启动探测失败的问题。

方法2：通过Dockerfile指定端口 #

如果用自定义Docker镜像部署，在Dockerfile里添加EXPOSE 5000，并指定启动命令：

EXPOSE 5000
ENTRYPOINT ["dotnet", "YourApp.dll", "--urls=http://0.0.0.0:5000"]

同样要在App Service应用设置中添加WEBSITES_PORT=5000，确保反向代理指向正确端口。

四、关键注意点 #

• 绝对不能只监听localhost，必须监听0.0.0.0或AnyIP，否则容器外部的探测和反向代理无法访问应用。
• 检查应用设置里有没有ASPNETCORE_URLS变量，这个变量会覆盖Kestrel的配置，要么删除，要么改成http://0.0.0.0:5000或者能读取PORT变量的格式。

内容的提问来源于stack exchange，提问作者Mathias Rönnlund