目录
前言URL格式前提条件方法1 使用环境变量方法2 使用命令行参数方法3 使用配置文件方法4 使用UseUrls方法5 使用Kestrel优先级总结前言
在使用ASP.NET Core 3.1开发时,需要配置服务器监听的端口和协议,官方帮助文档进行简单说明,文档中提到了4种指定URL的方法
设置ASPNETCORE_URLS 环境变量; 使用dotnet --urls 命令行参数; 使用urls作为键进行配置; 使用UseUrls扩展方法;为便于讲清楚URLs设置方法,创建名为AspNetCoreUrl的ASP.NET Core Web API程序进行说明,默认情况下,启动ASP.NET Core后,监听以下URLs:
http://localhost:5000/
https://localhost:5001/
URL格式
主要有三种URL格式表达方式,可以查看官方文档(https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/servers/kestrel?view=aspnetcore-3.1)
格式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/
前提条件
在开始测试几种URLs设置方法前,需要先生成AspNetCoreUrl程序,然后在生成的根目录下打开命令行工具进行相应的测试
(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); // 配置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








