前言
找找有多少种方法可以设置 ASP.NET Core 应用的地址,即 URL。
精彩马上开始!
1、UseUrls 方法
这是一个扩展方法,参数是可变个数的字符串数组。所以,每传一个参数就代表一个 URlL。例如
“`auto
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 开头不能有空格。下面的写法是错误的。
“`auto
var builder = WebApplication.CreateBuilder(args);// 在 Build 之前要改好设置 builder.WebHost.UseSetting(WebHostDefaults.ServerUrlsKey, “http://localhost:1188; http://localhost:57578”);
“`
第二个 URL 开始处多了一个空格,程序运行后会“呵呵”。
可以用 UseUrls 方法替代,它内部也是调用了 UseSetting 方法。
3、配置文件
项目模板默认生成了一个 appsettings.json 文件,我们可以直接用(可以添加自己定义的文件,配置原理一样)。
“`auto
{
……,
“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 节点下。
“`auto
“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 命令行,可以这样:
“`auto
dotnet run –launch-profile demo
“`
## 5、app.Urls 属性
调用 builder.Build 方法后,创建 WebApplication 实例(变量 app),它有个 Urls 属性,集合类型,可以向其中添加 URL。
“`auto
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。
“`auto
public System.Collections.Generic.ICollection Addresses { get; }
“`
此属性表示一个字符串集合,用于设置程序的 URL,上面提到的 app.Urls 属性实际上就是公开 Addresses 属性。也就是说,app.Urls 属性封装了 Addresses 属性。
IServerAddressesFeature 接口的默认实现类是 ServerAddressesFeature。但是,从依赖注入的服务容器中不能直接获取到,因为它不是直接放进容器中的,而是作为了 IServer 的 Features 属性中一个元素来引用的。
ASP.NET Core 应用程序启动时默认会向服务容器添加一个实现了 IServer 的对象,嗯,说白了就是 Kestrel 服务器。
下面是例子:
“`auto
var app = builder.Build();
// Server 对象
var server = app.Services.GetRequiredService();
// 获取 IServerAddressesFeature
var addrfeature = server.Features.Get();
// 添加 URL
addrfeature?.Addresses.Add(“http://localhost:8715”);
“`
## 7、通过 app.Run 方法
WebApplication 类的 Run 或者 RunAsync 方法有接收 url 参数的重载。这种方法只能指定一个 URL,不能用分号来分隔多个 URL。
“`auto
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、命令行参数和环境变量
命令行的传递方法有以下几种:
“`auto
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 上。
“`auto
set ASPNETCORE_URLS=http://killer.com
dotnet abc.dll
“`
在 XXnix 上
“`auto
export ASPNETCORE_URLS=http://ddW.host.net
dotnet abc.dll
“`
## 9、通过 Kestrel 服务器来配置
通过修改 Kestrel 服务器的配置也可以设置地址,但该配置是面向 Socket 层面的,以 IP + 端口的方式配置。
举例:
“`auto
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 的提示。如图
![图片](https://mmbiz.qpic.cn/sz_mmbiz_png/7fxWIIIo4QvOYeL30kY1rvNNyG3VvHE6kib0mehkl5H5wIneiaDwicSQrut4ete2c70fFkAxIfArb0sJ4LgDHxGGQ/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1)
至于原因,老周稍后会解释。
10、通过 HTTP.sys 配置
Kestrel 是跨平台的 Web 服务器,而 HTTP.sys 只能用在 Windows 上。HTTP.sys 也是 ASP.NET Core 应用内置的服务器。
“`auto
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 替换。
“`auto
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 参数。比如,把上面的代码改一下。
“`auto
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 地址。
转自:cnblogs.com/tcjiaan/p/16347491.html