前言
上次,我们讨论了如何通过配置或代码方式修改启动地址:《 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":"--urlshttp://localhost:5300",}}
4. UseUrls 方法
.NET 5 版本
修改 ConfigureWebHostDefaults 方法:
publicstaticIHostBuilderCreateHostBuilder(string[]args)=>Host.CreateDefaultBuilder(args).ConfigureWebHostDefaults(webBuilder=>{webBuilder.UseStartup<Startup>();webBuilder.UseUrls("http://localhost:5400");});
.NET 6 版本
对应的方法为 WebApplicationBuilder.WebHost.UseUrls:
varbuilder=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 中修复:/dotnet/aspnetcore/issues/38185
5. UseKestrel 方法
.NET 5 版本
修改ConfigureWebHostDefaults方法:
publicstaticIHostBuilderCreateHostBuilder(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:
varbuilder=WebApplication.CreateBuilder(args);builder.WebHost.ConfigureKestrel(options=>options.ListenLocalhost(5500,opts=>opts.Protocols=HttpProtocols.Http1));
6. WebApplication.Urls.Add 方法
.NET 6 版本
这是 .NET 6 下增加的新方法:
varapp=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 方法
命令行参数 --urls
环境变量 ASPNETCORE_URLS
applicationUrl 属性
默认值
结论
如果在同一台机器上运行多个 Core 实例,使用默认值肯定不合适。
由于 WebApplicationBuilder.WebHost.ConfigureKestrel/WebApplication.Urls.Add 方法不能被覆盖,而环境变量 ASPNETCORE_URLS 容易造成全局影响。
建议:始终使用 appsettings.json 文件配置启动地址。
如果你觉得这篇文章对你有所启发,请关注我的个人公众号”My IO“