Net Core -- 配置Kestrel端口


Net Core -- 配置Kestrel端口

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

  1. localhost 或127.0.0.1 代表本機ip,僅允許本機訪問
  2. 局域網ip,允許局域網內客戶端訪問
  3. 端口0代表隨機綁定可用端口
  4. '*' 代表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),最近群里不是很活躍,大家進來多發言發言哈~


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM