基于 .NET 6 的ASP.NET Core启动地址配置方法及优先级顺序

目录

前言：一、设置方法​1.applicationUrl属性​​2.环境变量​​3.命令行参数​​4.UseUrls方法​.NET5版本.NET6版本​5.UseKestrel方法​​6.WebApplication.Urls.Add方法​​7.appsettings.json文件​二、优先级三、结论

前言：

上次，我们讨论了如何通过配置或代码方式修改启动地址：《​ ​ASP.NET Core启动地址配置方法及优先级顺序​​》。不过是基于 .NET 5 版本的。

由于 .NET 6 使用了最小 WEB API, 配置方式已经部分发生了变化。

一、设置方法

​1. applicationUrl 属性​

.NET 6 的 BUG​​ （Builder.WebHost.UseUrls does not seem to override default url），并将在 6.0.3 中修复：https://github.com/dotnet/aspnetcore/issues/38185

​5. UseKestrel 方法​

.NET 5 版本:

修改ConfigureWebHostDefaults方法：

publ易采站长站ic static IHostBuilder CreateHostBuilder(string[] args) =>  Host.CreateDefaultBuilder(args)    .ConfigureWebHostDefaults(webBuilder =>    {      webBuilder.UseStartup<Startup>();      webBuilder.UseKestrel(options=> options.ListenLocalhost(5500, opts => opts.Protocols = HttpProtocols.Http1));    });

.NET 6 版本:

对应的方法为 ​WebApplicationBuilder​.WebHost.ConfigureKestrel：

var builder = WebApplication.CreateBuilder(args);builder.WebHost.ConfigureKestrel(options => options.ListenLocalhost(5500, opts => opts.Protocols = HttpProtocols.Http1));

​6. WebApplication.Urls.Add 方法​

.NET 6 版本

这是 .NET 6 下增加的新方法：

var app = builder.Build();app.Urls.Add("http://localhost:5600");

​7. appsettings.json 文件​

可以在 appsettings.json 文件中设置 Kestrel 端口：

{ "Kestrel": {  "Endpoints": {   "Https": {    "Url": "https://*:5701"   },   "Http": {    "Url": "http://*:5700"   }  } }}

二、优先级

通过将上述设置方式进行组合，发现优先级顺序如下：

WebApplicationBuilder.WebHost.ConfigureKestrel 方法 / appsettings.json 文件 (​2者可同时起作用)WebApplication.Urls.Add 方www.easck.com法命令行参数 --urls环境变量 ASPNETCORE_URLSapplicationUrl 属性默认值

三、结论

如果在同一台机器上运行多个 ASP.NET Core 实例，使用默认值肯定不合适。

由于​WebApplicationBuilder​.WebHost.ConfigureKestrel/WebApplication.Urls.Add 方法不能被覆盖，而环境变量 ASPNETCORE_URLS 容易造成全局影响。

​​建议：始终使用appsettings.json 文件配置启动地址。