【ASP.NET Core】配置应用程序地址的N多种方法

下面又到了老周误人子弟的时间,今天要误大伙的话题是:找找有多少种方法可以设置 ASP.NET Core 应用的地址,即 URL。

精彩马上开始!

 

1、UseUrls 方法

这是一个扩展方法,参数是可变个数的字符串数组。所以,每传一个参数就代表一个 URlL。例如

var builder = WebApplication.CreateBuilder(args); // 在 Build 之前要改好设置 builder.WebHost.UseUrls(         "http://localhost:7979",         "http://127.0.0.1:45125",         "http://localhost:11600"     );  var app = builder.Build(); // 此处省略 270 个 Unicode 字符

就这样,咱们就轻松地设置了三个地址。程序运行后,访问任意一个地址均可。

 

2、UseSetting 方法

这也是一个扩展方法,key 是“urls”,可以通过 WebHostDefaults.ServerUrlsKey 静态字段获得,value 是URL 的值,多个 URL 用分号隔开。注意,URL 开头不能有空格。下面的写法是错误的。

var builder = WebApplication.CreateBuilder(args); // 在 Build 之前要改好设置 builder.WebHost.UseSetting(WebHostDefaults.ServerUrlsKey, "http://localhost:1188; http://localhost:57578");

第二个URL开始处多了一个空格,程序运行后会“呵呵”。

可以用 UseUrls 方法替代,它内部也是调用了 UseSetting 方法。

 

3、配置文件

项目模板默认生成了一个 appsettings.json 文件,我们可以直接用(可以添加自己定义的文件,配置原理一样)。

{   ……,   "AllowedHosts": "*",   "urls": "http://127.0.0.1:8968;http://192.168.0.107:21032" }

一样,多个 URL 要用分号分隔。这种配置方法非常好,因为它和代码分离了,修改配置文件后保存即可,不需要重新编译应用程序。

 

4、launchSettings.json 文件

这个文件是在本地调试时使用的,一般在 Visual Studio 中使用。在 dotnet 命令行中也可以通过 --launch-profile 参数来指定要加载 launchSettings.json 文件中哪个配置。这些配置都写在 profiles 节点下。

"profiles": {     "demo": {       "commandName": "Project",       "dotnetRunMessages": true,       "launchBrowser": true,       "applicationUrl": "http://localhost:5079",       "environmentVariables": {         "ASPNETCORE_ENVIRONMENT": "Development"       }     },  …… }

lanuchSettings.json 文件可以进行多环境调试,比如上面代码配置了一个名为 demo 的环境,commandName = Project 表示用内置的 Kestrel 服务器来运行,当然你可以选“IIS”等。

其中,applicationUrl 字段用来设置应用程序的地址。

在 VS 中,直接从调试项目的下拉列表中选择哪个环境执行即可。如果使用 dotnet 命令行,可以这样:

dotnet run --launch-profile demo

 

5、app.Urls 属性

调用 builder.Build 方法后,创建 WebApplication 实例(变量 app),它有个 Urls 属性,集合类型,可以向其中添加 URL。

var builder = WebApplication.CreateBuilder(args);  var app = builder.Build(); app.Urls.Add("http://localhost:3377"); app.Urls.Add("http://localhost:16852");  app.MapGet("/", () => "Hello World!");  app.Run();

 

6、使用 ServerAddressesFeature 对象

 IServerAddressesFeature 接口公开属性 Addresses。

public System.Collections.Generic.ICollection<string> Addresses { get; }

此属性表示一个字符串集合,用于设置程序的 URL,上面提到的 app.Urls 属性实际上就是公开 Addresses 属性。也就是说,app.Urls 属性封装了 Addresses 属性。

IServerAddressesFeature 接口的默认实现类是 ServerAddressesFeature。但是,从依赖注入的服务容器中不能直接获取到,因为它不是直接放进容器中的,而是作为了 IServer 的 Features 属性中一个元素来引用的。

ASP.NET Core 应用程序启动时默认会向服务容器添加一个实现了 IServer 的对象,嗯,说白了就是 Kestrel 服务器。

下面是例子:

var app = builder.Build();  // Server 对象 var server = app.Services.GetRequiredService<IServer>(); // 获取 IServerAddressesFeature var addrfeature = server.Features.Get<IServerAddressesFeature>(); // 添加 URL addrfeature?.Addresses.Add("http://localhost:8715");

 

7、通过 app.Run 方法

WebApplication 类的 Run 或者 RunAsync 方法有接收 url 参数的重载。这种方法只能指定一个 URL,不能用分号来分隔多个 URL。

var builder = WebApplication.CreateBuilder(args);  var app = builder.Build();  app.MapGet("/", () => "Hello World!");  app.Run("http://localhost:12345");

这个地方只能配置一个 URL,而且会把其他方式配置的 URL 删除。比如,你用 UseUrls 配置了URL,用环境变量配置了URL,但到了 Run 方法处,一旦你传递了 URL,就会把前面所配置的 URL 清空,最终只剩下传递给 Run 方法的 URL。

 

8、命令行参数和环境变量

命令行的传递方法有以下几种:

dotnet abc.dll --urls http://localhost:8888 dotnet abc.dll --urls=http://abc.org dotnet abc.dll /urls http://192.168.1.125:49035 dotnet abc.dll /urls=http://localhost:17156

环境变量也是叫“urls”,不过一般用大写,而且注意带上前缀 ASPNETCORE_,这是默认前缀,如果你修改过,就用自定义的前缀。

例如,在 Windows 上。

set ASPNETCORE_URLS=http://killer.com dotnet abc.dll

在 XXnix 上

export ASPNETCORE_URLS=http://ddW.host.net dotnet abc.dll

 

9、通过 Kestrel 服务器来配置

通过修改 Kestrel 服务器的配置也可以设置地址,但该配置是面向 Socket 层面的,以 IP + 端口的方式配置。

举例:

var builder = WebApplication.CreateBuilder(args); builder.WebHost.ConfigureKestrel(kop => {     kop.ListenAnyIP(5999);     kop.ListenLocalhost(39824); });  var app = builder.Build();  app.MapGet("/", () => "Hello World!");  app.Run();

KestrelServerOptions 类有以下几种 ListenXXX 方法可选择:

(1)Listen 方法:指定 IP 和端口。

(2)ListenLocalhost 方法:只监听本机 IP,只需指定端口即可。

(3)ListenAnyIP 方法:监听当前计算机上所有网卡的 IP,只需指定端口即可。

使用此法配置 URL 后,当运行应用程序时,会出现个覆盖 URL 的提示。如图

【ASP.NET Core】配置应用程序地址的N多种方法

 

 至于原因,老周稍后会解释。

 

10、通过 HTTP.sys 配置

 Kestrel 是跨平台的 Web 服务器,而 HTTP.sys 只能用在 Windows 上。HTTP.sys 也是 ASP.NET Core 应用内置的服务器。

var builder = WebApplication.CreateBuilder(args); builder.WebHost.UseHttpSys(option => {     option.UrlPrefixes.Add("http://localhost:30775"); });  var app = builder.Build(); // 此处丢失 105 个字符

 使用了 HTTP.sys 配置的 URL,运行后同样输出 URL 覆盖提示。下面马上说明原因。

 

收尾:PreferHostingUrls 方法

前面大伙们都看到了,当通过 Kestrel 或 HTTP.sys 配置 URL 后,运行程序就会有 URL 覆盖提示。即通过 IServer 配置的 URL 替代了 WebHostBuilder 扩展方法所设置的 URL。

例如,下面程序同时使用 UseUrls 方法和 Kestrel 来配置 URL,运行后,UseUrls 所配置的 URL 会被 Kestrel 所配置的 URL 替换。

var builder = WebApplication.CreateBuilder(args); builder.WebHost.UseUrls("http://localhost:6780"); builder.WebHost.ConfigureKestrel(opt => {     opt.ListenLocalhost(29800); });  var app = builder.Build();

最终应用程序会选择在 http://localhost:29800 上监听。

如果你想忽略掉 Kestrel 的配置,仍然使用 UseUrls 的配置,就要调用 PreferHostingUrls 方法,并且传递 true 给 preferHostingUrls 参数。比如,把上面的代码改一下。

var builder = WebApplication.CreateBuilder(args); builder.WebHost.UseUrls("http://localhost:6780"); builder.WebHost.ConfigureKestrel(opt => {     opt.ListenLocalhost(29800); });  builder.WebHost.PreferHostingUrls(true);  var app = builder.Build();

这时候应用程序就会优先选择 http://localhost:6780 地址。如下图所示。

【ASP.NET Core】配置应用程序地址的N多种方法

 

发表评论

相关文章