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

Posted 2022-03-12 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 属性
默认值