如何修改 .NET Core Kestrel 下的端口

今天在尝试 Consul 的时候需要动态改变 .NET Core Kestrel 下的端口以方便测试，故而查了查，发现原来除了最常使用的 UseUrls 之外，还有许多其他方法，故而总结一下。

实现方法

ASPNETCORE_URLS 环境变量

使用环境变量可以配置 Kestrel 使用的端口
CODE

set ASPNETCORE_URLS=http://127.0.0.1:5008;http://0.0.0.0:5009

RESULT

–urls 命令行参数

使用 –urls 命令行参数可以配置 Kestrel 使用的端口
CODE

set dotnet EndpointConfigurationTest2.0.dll --urls http://0.0.0.0:5698;https://127.0.0.1:6936

RESULT

UseUrls

使用 IWebHostBuilder 的扩展方法 UseUrls () 可以为 Kestrel 绑定一个或者多个 url ，支持 http 与 https，支持多个 string 参数或者单个 string 中使用分号分割。
CODE

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseUrls("http://localhost:4411","https://localhost:4412","http://0.0.0.0:4413;https://localhost:4414")
        .UseStartup<Startup>();

RESULT

配置文件

在配置文件中增加 Kestrel 节点来配置 Kestrel 使用的端口
CODE

{
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*",
  "Kestrel": {
    "EndPoints": {
      "Http": {
        "Url": "http://localhost:5000"
      },
      "Https": {
        "Url": "https://localhost:5006"
      }
    }
  }
}

RESULT

UseKestrel 或者 ConfigureKestrel

使用 IWebHostBuilder 的扩展方法 UseKestrel () 可以更精确的设置 Kestrel 的更多配置信息 ，在 .NET Core 2.1 版本以上也可以为 ConfigureKestrel ()。
CODE

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseUrls("http://localhost:4411","https://localhost:4412","http://0.0.0.0:4413;https://localhost:4414")
        .UseStartup<Startup>()
        .UseKestrel((context, options) =>
        {
            options.Listen(IPAddress.Any, 5620);
            options.Listen(IPAddress.Loopback, 5588, listenOptions =>
            {
                listenOptions.UseHttps();
            });
        });

RESULT

总结
以上几种方法就是我根据官方文档整理的修改 Kestrel 端口的方法，实测优先级由上到下依次增高，使用优先级更高的方式可以覆盖掉优先级低的方式。
　　综上，需要测试 Consul 服务治理时，更合适的方式是使用命令行 –urls 方式.

转 https://wayneshao.com/posts/15088.html