本篇文章給大家分享的是有關(guān)如何在ASP.NET Core項(xiàng)目中對(duì)URLs進(jìn)行監(jiān)聽，小編覺得挺實(shí)用的，因此分享給大家學(xué)習(xí)，希望大家閱讀完這篇文章后可以有所收獲，話不多說，跟著小編一起來看看吧。
創(chuàng)新互聯(lián)建站服務(wù)項(xiàng)目包括夾江網(wǎng)站建設(shè)、夾江網(wǎng)站制作、夾江網(wǎng)頁制作以及夾江網(wǎng)絡(luò)營(yíng)銷策劃等。多年來，我們專注于互聯(lián)網(wǎng)行業(yè)，利用自身積累的技術(shù)優(yōu)勢(shì)、行業(yè)經(jīng)驗(yàn)、深度合作伙伴關(guān)系等，向廣大中小型企業(yè)、政府機(jī)構(gòu)等提供互聯(lián)網(wǎng)行業(yè)的解決方案，夾江網(wǎng)站推廣取得了明顯的社會(huì)效益與經(jīng)濟(jì)效益。目前，我們服務(wù)的客戶以成都為中心已經(jīng)輻射到夾江省份的部分城市，未來相信會(huì)繼續(xù)擴(kuò)大服務(wù)區(qū)域并繼續(xù)獲得客戶的支持與信任！ASP.NET 是開源，跨平臺(tái)，高性能，輕量級(jí)的 Web 應(yīng)用構(gòu)建框架，常用于通過 HTML、CSS、JavaScript 以及服務(wù)器腳本來構(gòu)建網(wǎng)頁和網(wǎng)站。
默認(rèn)情況下，ASP. NET Core應(yīng)用會(huì)監(jiān)聽一下2個(gè)Url:
http://localhost:5000
https://localhost:5001
在本篇博文中，我將展示如何使用五種不同的方式改變應(yīng)用監(jiān)聽的URLs。
在ASP.NET Core項(xiàng)目啟動(dòng)時(shí)，有多種配置監(jiān)聽Url的方式，在我之前的一篇博客中，已經(jīng)展示了在ASP.NET Core 1.0中如何應(yīng)用不同的方式配置，在ASP.NET Core 3.x中，大部分方式還是一樣的。
UseUrls() - 在Program.cs配置程序監(jiān)聽的URLs
環(huán)境變量 - 使用DOTNET_URLS或者ASPNETCORE_URLS配置URLs
命令行參數(shù) - 當(dāng)使用命令行啟動(dòng)應(yīng)用時(shí)，使用--urls參數(shù)指定URLs
使用launchSettings.json - 使用applicationUrl屬性來配置URLs
KestrelServerOptions.Listen() - 使用Listen()方法手動(dòng)配置Kestral服務(wù)器監(jiān)聽的地址
下面我來詳細(xì)說明一下每個(gè)一種方式。
哪些Url可以使用？
在本篇我描述是你可以綁定的"URLs", 但是你不能使用所有的URLs. 這里有三種你可以綁定的URLs
IPV4和IPV6的主機(jī)名(例如http://localhost:5000). 這種URL的格式是{scheme}://{loopbackAddress}:{port}
在你機(jī)器上可用的指定IP地址(例如http://192.168.8.31:5005), 這種URL的格式是{scheme}://{IPAddress}:{port}針對(duì)給定端口，使用"任何"IP地址（例如http://*:6264）, 這種URL的格式是{scheme}://*:{port}
在以上說明的幾種格式中，端口號(hào)也可以是選填的， 如果你忽略它，系統(tǒng)會(huì)使用默認(rèn)端口(http使用80端口，https使用443端口)。
使用哪一種格式的URLs取決于你的部署方式。例如，如果你你將多個(gè)應(yīng)用托管在同一臺(tái)“裸機(jī)”中，你可能需要顯示指定IP地址。但是如果你使用了容器托管，那么你可以使用localhost作為地址。
注意，針對(duì)"任何"IP地址的格式 - 你不一定必須使用*，你可以使用任何字符，只要不是IP地址或者localhost, 這意味著你可以使用http://*,http://+,http://mydomain,http://example.org. 以上所有字符串都具有相同的行為，可以監(jiān)聽任何IP地址。如果你想僅處理來自單一主機(jī)名的請(qǐng)求，你需要額外配置主機(jī)過濾。
現(xiàn)在你已經(jīng)了解了你需要監(jiān)聽的URLs類型，接下來你就需要告訴你的應(yīng)用如何使用它們。我這里我將展示五種可能使用到方式。
UseUrls()
首先，最簡(jiǎn)單的方式，當(dāng)配置IWebHostBuilder時(shí)，你可以使用UseUrls()方法硬編碼綁定的URLs。
重慶分公司
重慶分公司
public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup();
webBuilder.UseUrls("http://localhost:5003", "https://localhost:5004");
});
} 硬編碼一個(gè)URLs從來都不是一個(gè)干凈可擴(kuò)展解決方案的選擇，所以這種方式通常只會(huì)用來做Demo.
幸運(yùn)的是，你也可以從外部配置文件、環(huán)境變量或者命令行參數(shù)中加載URLs配置。
環(huán)境變量
.NET Core中允許使用兩種配置方式
應(yīng)用程序級(jí)配置是你通常在應(yīng)用程序中使用的配置，它是用appSettings.json配置文件和環(huán)境變量中加載的。
主機(jī)配置用于配置應(yīng)用程序的基礎(chǔ)配置，例如主機(jī)環(huán)境和主機(jī)URLs
當(dāng)我們?cè)诳紤]如何配置應(yīng)用URLs時(shí)，主機(jī)配置是讓我們感興趣的一種。默認(rèn)主機(jī)配置的值來自三個(gè)不同的地方。
以DOTNET_開頭的環(huán)境變量。
命令行參數(shù)
以ASPNETCORE_開頭的環(huán)境變量。這種方式僅限ASP.NET Core應(yīng)用，基于通用主機(jī)的worker service是不適用的。
如果你沒有手動(dòng)復(fù)寫過UseUrls()方法，ASP.NET Core會(huì)使用系統(tǒng)配置的中URLS鍵的值。基于描述，你可以使用一下兩種方式配置URLs
DOTNET_URLS
ASPNETCORE_URLS
如果你同時(shí)使用2種環(huán)境變量，系統(tǒng)會(huì)優(yōu)先使用ASPNETCORE_URLS中定義的參數(shù)
你可以根據(jù)你的開發(fā)環(huán)境使用一些通用方式配置環(huán)境變量。例如，使用命令行
setx ASPNETCORE_URLS http://localhost:5001
使用powershell
$Env: ASPNETCORE_URLS = http://localhost:5001
或者使用bash命令
export ASPNETCORE_URLS=http://localhost:5001;https://localhost:5002
從以上例子中不難發(fā)現(xiàn)，如果想要配置多個(gè)地址，只需要用分號(hào)間隔即可。
命令行參數(shù)
另外一種設(shè)置主機(jī)配置的方式是使用命令行參數(shù)。如果同時(shí)配置了環(huán)境變量和命令行參數(shù)，命令行參數(shù)的值會(huì)覆蓋環(huán)境變量配置的值。這里我們可以使用--urls參數(shù)來配置URLS
dotnet run --urls http://localhost:5100
和之前的例子一樣，這里你可以使用分號(hào)間隔配置多個(gè)URLs
dotnet run --urls http://localhost:5100;https://localhost:5101
在生產(chǎn)環(huán)境中，配置URLS的最常用方式是使用環(huán)境變量或者命令行參數(shù)，但是在本地開發(fā)環(huán)境中，可能就有點(diǎn)笨重了，這時(shí)候使用launchSetting.json來配置URLS可能更簡(jiǎn)單一點(diǎn)。
launchSettings.json
大部分.NET Core項(xiàng)目模板中都包含了一個(gè)名為launchSetting.json的文件, 這個(gè)文件通常放在Properties文件夾中。這個(gè)文件中包含了啟動(dòng)ASP.NET Core項(xiàng)目的各種配置。一個(gè)典型的launchSetting.json文件中包含了兩部分定義，一部分是命令行啟動(dòng)項(xiàng)目時(shí)的配置，一部分是使用IIS Express啟動(dòng)項(xiàng)目時(shí)的配置。具體使用哪一部分是由Visual Studio中的"Debug"下拉列表控制的：
在launchSettings.json文件中，我們使用applicationUrl屬性就可以配置應(yīng)用綁定的URLs - 在如下的例子中，你可以看到在iisSettings節(jié)點(diǎn)下有一個(gè)配置，在TestApp節(jié)點(diǎn)下有一個(gè)配置。
{
"iisSettings": {
"windowsAuthentication": false,
"anonymousAuthentication": true,
"iisExpress": {
"applicationUrl": "http://localhost:38327",
"sslPort": 44310
}
},
"profiles": {
"IIS Express": {
"commandName": "IISExpress",
"launchBrowser": true,
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
},
"TestApp": {
"commandName": "Project",
"launchBrowser": true,
"applicationUrl": "https://localhost:5001;http://localhost:5000",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
}
}
}你不需要特別指定使用這個(gè)文件 -dotnet run命令會(huì)自動(dòng)加載它。
launchSettings.json文件中也提供了額外的環(huán)境變量配置參數(shù)environmentVariables，在上面的例子中你就可以發(fā)現(xiàn)它們。
當(dāng)你從命令行使用dotnet run命令啟動(dòng)你的應(yīng)用時(shí)，你的應(yīng)用會(huì)從"Project"命令下的applicationUrl參數(shù)中加載配置https://localhost:5001;http://localhost:5000，當(dāng)你使用IISExpress命令啟動(dòng)項(xiàng)目的時(shí)候，你的應(yīng)用會(huì)從iisSettings.iisExpress節(jié)點(diǎn)的applicationUrl參數(shù)中加載配置http://localhost:38327
當(dāng)你做本地開發(fā)的時(shí)候，這個(gè)文件是配置環(huán)境最簡(jiǎn)單的方式。事實(shí)上，如果你不想使用launchSettings.json文件，你需要特別配置。
dotnet run --no-launch-profile
以上命令會(huì)跳過launchSettings.json文件的加載，并使用主機(jī)環(huán)境變量配置來決定綁定的URLs。
到目前為止，所有的實(shí)現(xiàn)方案都是間接為Kestrel服務(wù)器配置URLs, 但是實(shí)際上你還可以直接配置。
KestrelServerOptions.Listen()
幾乎所有的ASP.NET Core應(yīng)用默認(rèn)都會(huì)使用Kestrel服務(wù)器。如果你想的話，你可以手動(dòng)配置Kestrel服務(wù)器節(jié)點(diǎn)，或者使用IConfiguration配置KestrelServerOptions。
我從來沒有這樣做過，這里有非常多的配置項(xiàng)，因此在大多數(shù)情況下，我建議參考文檔。例如，你可以使用Listen()函數(shù)顯式配置KestrelServerOptions
public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup();
webBuilder.UseKestrel(opts =>
{
// Bind directly to a socket handle or Unix socket
// opts.ListenHandle(123554);
// opts.ListenUnixSocket("/tmp/kestrel-test.sock");
opts.Listen(IPAddress.Loopback, port: 5002);
opts.ListenAnyIP(5003);
opts.ListenLocalhost(5004, opts => opts.UseHttps());
opts.ListenLocalhost(5005, opts => opts.UseHttps());
});
});
} 以上配置為Kestrel服務(wù)器設(shè)置了多個(gè)監(jiān)聽地址。在上面的例子中，使用了硬編碼，但是實(shí)際上可以改用IConfiguration綁定。當(dāng)你使用以上方式為Kestrel服務(wù)器配置URLs時(shí)，如果你還是用了其他方式對(duì)URLs進(jìn)行了配置，那么它覆蓋其他方式的配置。如果發(fā)生這種情況，你會(huì)在程序日志中看到如下警告：
warn: Microsoft.AspNetCore.Server.Kestrel[0]
Overriding address(es) 'http://localhost:5007'. Binding to endpoints defined in UseKestrel() instead.
info: Microsoft.Hosting.Lifetime[0]
Now listening on: http://127.0.0.1:5002
info: Microsoft.Hosting.Lifetime[0]
Now listening on: http://[::]:5003
對(duì)我個(gè)人而言，我沒有遇到過使用這方式為Kestrel服務(wù)器配置URLs的場(chǎng)景, 但是當(dāng)你需要的時(shí)候，你就可以完全控制Kestrel服務(wù)器配置。
以上就是如何在ASP.NET Core項(xiàng)目中對(duì)URLs進(jìn)行監(jiān)聽，小編相信有部分知識(shí)點(diǎn)可能是我們?nèi)粘９ぷ鲿?huì)見到或用到的。希望你能通過這篇文章學(xué)到更多知識(shí)。更多詳情敬請(qǐng)關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。
