ASP.NET Core设置URLs的五种方法_ASP.NET教程

前言

在使用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程序，然后在生成的根目录下打开命令行工具进行相应的测试

ASP.NET Core设置URLs的五种方法

如图，我这里的程序根目录为d:\aspnetcoreurl\aspnetcoreurl\bin\debug\netcoreapp3.1，使用的终端为微软官方的windows powershell

方法1 使用环境变量

在不修改aspnetcoreurl任何源代码的情况下（即创建项目时的程序默认状态）生成程序，定位到生成的根目录下，打开命令行终端

ASP.NET Core设置URLs的五种方法

				?

									# 环境变量仅在当前命令行窗口生效

									$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

ASP.NET Core设置URLs的五种方法

方法3 使用配置文件

在生成程序的根目录下，打开appsettings.json文件，添加url配置项，然后双击aspnetcoreurl.exe运行

				?

									{

									    "urls":"http://localhost:7002;http://localhost:7012"

									}

ASP.NET Core设置URLs的五种方法

运行结果如下图

ASP.NET Core设置URLs的五种方法

方法4 使用useurls

这种方法需要修改源代码，打开program.cs文件，修改createhostbuilder方法内容，主要是添加useurls扩展方法然后生成程序。

				?

									public static ihostbuilder createhostbuilder(string[] args) =>

									    host.createdefaultbuilder(args)

									        .configurewebhostdefaults(webbuilder =>

									        {

									            webbuilder.usestartup<startup>();

									            // 使用useurls设置监听的端口和协议

									            webbuilder.useurls("http://localhost:7003", "https://localhost:7013");

									        });

ASP.NET Core设置URLs的五种方法

注意：运行前需要将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<startup>();

									            // 配置kestrel服务

									            webbuilder.usekestrel(kestrelserveroptions =>

									            {

									                kestrelserveroptions.listenlocalhost(7004);

									                kestrelserveroptions.listenlocalhost(7014, listenoptions => listenoptions.usehttps());

									            });

									        });