在[Asp.Net Core](https://www.asp.net)中,我們的web application 其實是運行在Kestrel服務上,它是一個基於libuv開源的跨平臺可運行 Asp.Net Core 的web伺服器。 ...
Kestrel介紹
在Asp.Net Core中,我們的web application 其實是運行在Kestrel服務上,它是一個基於libuv開源的跨平臺可運行 Asp.Net Core 的web伺服器。
在開發階段,我們可以直接使用Kestrel伺服器用來測試,也可以使用IISExpress。在使用IISExpress其實也需要啟動一個Kestrel伺服器,通過IISExpress反向代理請求到Kestrel,很多時候我更喜歡使用Kestrel,因為可以實時看到log。
配置埠
在Socket開發中,伺服器都會綁定到某個ip某個埠進行監聽,等待客戶端的連接,然後交換數據,Kestrel同樣需要對某個埠進行監聽,客戶端會請求這個埠然後建立連接進行數據交換。我們說的配置url或者配置埠,其實本質上都是建立對某個埠的監聽。
配置規則
我們知道在Kestrel通過綁定Urls參數實現綁定ip和埠,.Net Core允許我們使用多種方式來實現綁定url,我們先瞭解下綁定的規則:
[http|https]://[ip|localhost|hostname]:port
- localhost 或127.0.0.1 代表本機ip,僅允許本機訪問
- 區域網ip,允許區域網內客戶端訪問
- 埠0代表隨機綁定可用埠
- '*' 代表0.0.0.0,允許本機、區域網、公網訪問
'*'不是特殊字元,任何不能識別成ip的字元都將會綁定到0.0.0.0,so,你看到的hostname:ip 其實並沒有真正的綁定到hostname,Kestrel不會識別hostname,所以不允許像iis那樣,多個application通過hostname綁定到同一個ip的同一個埠上,所以你需要通過反向代理伺服器來實現
通過上述的綁定字元串,Kestrel會解析成相應的ip和埠,然後進行綁定監聽。
配置方式
.Net Core提供了多種對Kestrel埠的配置方式,我們可以通過編碼、配置文件、命令行參數進行配置,非常便利,接下來我們來看下各種配置方式。
無論那種方式,我們都必須在Kestrel啟動之前進行,一般情況我們都在Program.cs中進行。
編碼方式
編碼方式有2種方式:
1、通過UseKestrel(Action
var host = WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>()
.UseKestrel(o =>
{
o.Listen(IPAddress.Loopback, 5001);
})
.Build();
host.Run();
o.Listen(IPAddress.Loopback, 5004) 就是進行綁定,其中第一個參數是IPAddress類型。這種方式不是很便利,閱讀性也不好,推薦使用第二種
2、通過UseUrls方式:
var host = WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>()
.UseUrls("http://localhost:5002;http://localhost:5003")
.Build();
host.Run();
這種方式相對簡單,而且不容易出錯,但靈活性不強。
通過配置文件
我們可以通過Json文件對Kestrel進行配置,包括我們的url。
1、首先我們需要創建一個json文件,這裡以host.json為例:
{
"urls": "http://*:5004;"
}
2、我們需要在build host的時候告訴Kestrel讀取config文件,代碼如下:
public static void Main(string[] args)
{
var config = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("host.json", optional: true)
.Build();
var host = WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>()
.UseConfiguration(config)
.Build();
host.Run();
}
這種方式相比編碼來說較便利,但如果在web運行在容器內的話,修改還是有點麻煩,下麵來看下命令行格式。
命令行方式
我們知道.net core我們可以使用dotnet 命令方式去運行 .net core 應用,這種方式使我們的web不再依賴於iis,實現了跨平臺。
我們先瞭解下命令:
> dotnet run [options] [[--] arguments]
dotnet run 命令會把我們的項目編譯後直接運行,在開發的時候使用,如果是編譯好的項目,則使用:
> dotnet yourproject.dll [[--] arguments]
如果我們需要配置Urls的話,則只要使用參數--urls="http://*:5005"
,例如:
> dotnet run --urls="http://*:5005"
如果這時候你如此運行,你會發現你的項目並未監聽5005埠,因為你還沒有對Kestrel進行配置,告訴其讀取命令行參數,我們需要在Build host的時候進行如下配置:
public static void Main(string[] args)
{
var config = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddCommandLine(args) //添加對命令參數的支持
.Build();
var host = WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>()
.Build();
host.Run();
}
ok,這時候再運行dotnet run
命令吧!
關於url配置的問題
Q:url配置支持多功能變數名稱嗎?
A:上面說過,kestrel是不支持主機名解析的,你進行的配置都會綁定到0.0.0.0
Q:url配置支持多個ip嗎?
A:支持,但必須是本機所屬ip,否則運行則出錯
Q:多個Kestrel能監聽一個埠嗎?
A:不能
Q:我能通過多種方式進行url配置嗎?
A:可以,但最終生效的只有一種,也就是最後配置的方式,沒有優先順序
Q:Kestrel支持https嗎?
A:支持
Q:為什麼其他教程中是使用servers.urls呢?
A:我看了下,可能是擴展類的不同吧,目前來說已經改成urls了,而且不需要再額外引用其他類庫了
代更。。。。。。
寫在最後
最近在看微服務和asp.net core的東西,也希望把一些小知識分享給大家。
最後推薦我的.Net Core QQ學習群:376248054
(通關密碼:cnblogs),最近群里不是很活躍,大家進來多發言發言哈~