前言
在使用ASP.NET Core 3.1开发时，需要配置服务器监听的端口和协议，官方帮助文档进行简单说明，文档中提到了4种指定URL的方法
- 设置
ASPNETCORE_URLS环境变量； - 使用
dotnet --urls命令行参数； - 使用
urls作为键进行配置； - 使用
UseUrls扩展方法；
为便于讲清楚URLs设置方法，创建名为 AspNetCoreUrl的ASP.NET Core Web API程序进行说明，默认情况下，启动ASP.NET Core后，监听以下URLs：
URL格式
主要有三种URL格式表达方式，可以查看官方文档(https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/servers/kestrel?view=aspnetcore-3.1#url-prefixes)
格式1： {scheme}://{loopbackAddress}:{port}，例如 http://localhost:5000/、 https://localhost:5001/
格式2： {scheme}://{IPAddress}:{port}，例如 http://127.0.0.1:5000/、 https://192.168.1.100:5001/
格式3： {scheme}://*:{port}，例如 http://*:5000/、 https://domain.com:5001/
[本文作者：GIS学习班] [本文链接：https://www.cnblogs.com/gyhgis/p/15517043.html]
前提条件
在开始测试几种URLs设置方法前，需要先生成 AspNetCoreUrl程序，然后在生成的根目录下打开命令行工具进行相应的测试
如图，我这里的程序根目录为 D:\AspNetCoreUrl\AspNetCoreUrl\bin\Debug\netcoreapp3.1，使用的终端为微软官方的Windows PowerShell
方法1 使用环境变量
在不修改 AspNetCoreUrl任何源代码的情况下（即创建项目时的程序默认状态）生成程序，定位到生成的根目录下，打开命令行终端
环境变量仅在当前命令行窗口生效
$Env:ASPNETCORE_URLS = "http://localhost:7000;https://localhost:7010"
或者使用DOTNET_URLS环境变量同样可生效
$Env:DOTNET_URLS = "http://localhost:8000;https://localhost:8010"
运行AspNetCoreUrl程序
dotnet AspNetCoreUrl.dll
如果使用Windows命令行（即cmd命令行），使用下面的方式设置
环境变量仅在当前命令行窗口生效
set ASPNETCORE_URLS=http://localhost:7000;https://localhost:7010
将ASPNETCORE_URLS变量保存到用户环境变量中
setx ASPNETCORE_URLS "http://localhost:7000;https://localhost:7010"
加/m参数，将ASPNETCORE_URLS变量保存到系统环境变量中
setx ASPNETCORE_URLS "http://localhost:7000;https://localhost:7010" /m
运行AspNetCoreUrl程序
dotnet AspNetCoreUrl.dll
注意：使用setx设置环境变量后，需要打开新的Windows命令行窗口才会使用环境变量生效
在Linux系统中使用以下命令设置环境变量
环境变量仅在当前终端生效，关闭终端后需要重新设置
export ASPNETCORE_URLS="http://localhost:7000;https://localhost:7010"
方法2 使用命令行参数
在生成程序的根目录下，使用 dotnet --urls命令，并带上urls参数
dotnet AspNetCoreUrl.dll --urls "http://localhost:7001;https://localhost:7011"
方法3 使用配置文件
在生成程序的根目录下，打开 appsettings.json文件，添加url配置项，然后双击 AspNetCoreUrl.exe运行
{
"urls":"http://localhost:7002;http://localhost:7012"
}
运行结果如下图
方法4 使用UseUrls
这种方法需要修改源代码，打开 Program.cs文件，修改 CreateHostBuilder方法内容，主要是添加UseUrls扩展方法然后生成程序。
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup();
// 使用UseUrls设置监听的端口和协议
webBuilder.UseUrls("http://localhost:7003", "https://localhost:7013");
});
注意：运行前需要将 appsettings.json文件恢复到默认状态，即没有配置urls的状态，否则配置文件中设置会覆蓋代码中的方法。
方法5 使用Kestrel
这种方法并不在官方文档中，因为该方法仅限于使用Kestrel的时候生效，在创建ASP.NET Core应用程序时，默认使用Kestrel来托管应用，使用这种方法也有相应的应用场景，这里简单介绍下该方法的使用
打开 Program.cs文件，修改 CreateHostBuilder方法内容
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup();
// 作者：GIS学习班 配置Kestrel服务
webBuilder.UseKestrel(kestrelServerOptions =>
{
kestrelServerOptions.ListenLocalhost(7004);
kestrelServerOptions.ListenLocalhost(7014, listenOptions => listenOptions.UseHttps());
});
});
优先级
前面介绍的5种方法都在独立运行，如果将这5种方法同时用上，会有什么样的效果呢，下面来测试下，为了便于测试，每种方法都使用了不同的端口进行区分，下面显示了使用全部方法的运行结果：
可以看到，生效的是使用Kestrel方法，现在将Kestrel这种注释掉，运行结果如下：
可以看到此时生效的是使用命令行参数方法，如果不使用命令行参数方法，运行结果如下：
生效的是配置文件中的设置，现在删除配置文件中urls的配置，运行结果如下：
生效的是UseUrls扩展方法，现在注释掉UseUrls方法代码，运行结果如下：
生效的是环境变量，如果不设置环境变量，则使用默认值，即 http://localhost:5000/和 https://localhost:5001/。
总结
本文介绍了ASP.NET Core几种常用的设置URLs的方法，大家可以根据项目实际情况选择其中一种或几种，如果同时使用几种URLs设置方法，则需要留意配置的优先级问题，经过测试得出
Kestrel > 命令行 > 配置文件 > UseUrls > 环境变量 > 默认值
如果你想自己试一试，代码地址：
gitee：https://gitee.com/gyhgis/AspNetCoreUrl
github：https://github.com/gyhgis/AspNetCoreUrl
Original: https://www.cnblogs.com/gyhgis/p/15517043.html
Author: GIS学习班
Title: ASP.NET Core设置URLs的几种方法
原创文章受到原创版权保护。转载请注明出处：https://www.johngo689.com/585671/
转载文章受原作者版权保护。转载请注明原作者出处！