|
前言：
上次，我们讨论了如何通过配置或代码方式修改启动地址：《???ASP.NET Core启动地址配置方法及优先级顺序??》。不过是基于 .NET 5 版本的。
由于 .NET 6 使用了最小 WEB API, 配置方式已经部分发生了变化。
一、设置方法
?1. applicationUrl 属性?
launchSettings.json 文件中的 applicationUrl 属性，但是仅在本地开发计算机上使用：
| 1 2 3 4 5 6 | "profiles": {
??? "WebApplication1": {
??? ? ? ...
??? ? ? "applicationUrl": "http://localhost:5100",
??? }
}
|
?2.环境变量?
环境变量ASPNETCORE_URLS，有多个设置位置，下面演示的是使用 launchSettings.json 文件：
| 1 2 3 4 5 6 7 8 | "profiles": {
??? "WebApplication1": {
??? ? ? ...
??? ? ? "environmentVariables": {
??? ? ? ? ? "ASPNETCORE_URLS": "http://localhost:5200"
??? ? ? }
??? }
}
|
?3.命令行参数?
命令行参数 --urls，有多个设置位置，下面演示的是使用 launchSettings.json 文件：
| 1 2 3 4 5 6 | "profiles": {
??? "WebApplication1": {
??? ? ? ...
??? ? ? "commandLineArgs": "--urls http://localhost:5300",
??? }
}
|
?4. UseUrls 方法?
.NET 5 版本
修改 ConfigureWebHostDefaults 方法：
| 1 2 3 4 5 6 7 | public static IHostBuilder CreateHostBuilder(string[] args) =>
??? Host.CreateDefaultBuilder(args)
??? ? ? .ConfigureWebHostDefaults(webBuilder =>
??? ? ? {
??? ? ? ? ? webBuilder.UseStartup<Startup>();
??? ? ? ? ? webBuilder.UseUrls("http://localhost:5400");
??? ? ? });
|
.NET 6 版本
对应的方法为 ?WebApplicationBuilder?.WebHost.UseUrls：
| 1 2 3 | 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方法：
| 1 2 3 4 5 6 7 | 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：
| 1 2 | 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 下增加的新方法：
| 1 2 | var app = builder.Build();
app.Urls.Add("http://localhost:5600");
|
?7. appsettings.json 文件?
可以在 appsettings.json 文件中设置 Kestrel 端口：
| 1 2 3 4 5 6 7 8 9 10 11 12 | {
??"Kestrel": {
??? "Endpoints": {
??? ? "Https": {
??? ? ? "Url": "https://*:5701"
??? ? },
??? ? "Http": {
??? ? ? "Url": "http://*:5700"
??? ? }
??? }
??}
}
|
二、优先级
通过将上述设置方式进行组合，发现优先级顺序如下：
- 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?文件配置启动地址。
?
|