ASP.NET Core启动地址配置方法及优先级顺序 | .NET 6 版本 #yyds干货盘点#

Posted My空格IO

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了ASP.NET Core启动地址配置方法及优先级顺序 | .NET 6 版本 #yyds干货盘点#相关的知识,希望对你有一定的参考价值。

前言

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

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

设置方法

1. applicationUrl 属性

launchSettings.json 文件中的 applicationUrl 属性,但是仅在本地开发计算机上使用:

"profiles": 
"WebApplication1":
...
"applicationUrl": "http://localhost:5100",

2.环境变量

环境变量 ASPNETCORE_URLS,有多个设置位置,下面演示的是使用 launchSettings.json 文件:

"profiles": 
"WebApplication1":
...
"environmentVariables":
"ASPNETCORE_URLS": "http://localhost:5200"


3.命令行参数

命令行参数 --urls,有多个设置位置,下面演示的是使用 launchSettings.json 文件:

"profiles": 
"WebApplication1":
...
"commandLineArgs": "--urls http://localhost:5300",

4. UseUrls 方法

.NET 5 版本

修改 ConfigureWebHostDefaults 方法:

public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>

webBuilder.UseStartup<Startup>();
webBuilder.UseUrls("http://localhost:5400");
);

.NET 6 版本

对应的方法为 ​WebApplicationBuilder​.WebHost.UseUrls:

var builder = WebApplication.CreateBuilder(args);

builder.WebHost.UseUrls("http://localhost:5400");

但是,运行后不起作用。

结果发现这是 .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方法:

public 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"



优先级

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

ASP.NET

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

结论

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

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

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

如果你觉得这篇文章对你有所启发,请关注我的个人公众号”My IO“

ASP.NET

以上是关于ASP.NET Core启动地址配置方法及优先级顺序 | .NET 6 版本 #yyds干货盘点#的主要内容,如果未能解决你的问题,请参考以下文章

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

ASP.NET Core MVC 中两种路由的简单配置

细说.net core Startup

2021-05-19 ASP.NET Core笔试题 ASP.NET Core项目如何设置IP地址和端口号?

如何使用 EF Core 代码优先迁移为 ASP.NET Core MVC 配置 N 层架构

ASP.NET Core 路由(router)配置和使用方法代码