Do you kown Asp.Net Core -- 配置Kestrel埠

来源:http://www.cnblogs.com/inday/archive/2017/11/16/asp-net-core-kestrel-urls-configs.html
-Advertisement-
Play Games

在[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

  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),最近群里不是很活躍,大家進來多發言發言哈~


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 這個代碼會報異常,出現PNSE 經查找各種文檔發現一下使用辦法是Ok的,有沒有其它的辦法呢? ...
  • aspx 頁面出現 [HttpRequestValidationException (0x80004005):從客戶端(TextBox1=" 2.修改web.config文件: 3.要設置web.config中httpRuntime配置節中的 requestValidationMode特性設置為 r... ...
  • VS2013: MSB8027: Two or more files with the name of ***.cpp will produce outputs to the same location. ...
  • webservice 可以用於分散式應用程式之間的交互,和不同程式之間的交互。 概念性的東西就不說太多,下麵開始創建一個簡單的webservice的例子。這裡我用的是Visual Studio 2015開發工具。 首先創建一個空的Web應用程式。 然後滑鼠右鍵點擊項目,選擇 添加>新建項。 選擇We ...
  • .NET缺乏動態功能,這也妨礙了.NET作為教學或原型開發工具在一些環境中的使用。一些像Xamarin Workbooks或簡單的腳本的工具,不能使用.NET語言,不得不求助於平臺上的其它解決方案。 ...
  • 目前微信的企業號已經切換到企業微信裡面,這個是一個APP程式,提供了很豐富的企業應用,其中包括了業務審批處理,審批業務包括請假、報銷、費用、出差等很多個審批場景,在Winform開發框架中工作流模塊這些模塊也是可以很好的實現,本篇隨筆介紹如何參照企業微信審批業務,結合框架中的工作流模塊,實現多種表單... ...
  • 引言 MVC概念最早出現在二十世紀八十年代的施樂帕克實驗室中 MVC的定義 MVC是一種使用MVC(Model View Controller 模型--視圖--控制器)設計創建Web應用程式的設計模式。 Model 是應用程式中用於處理應用程式數據邏輯部分 • 通常模型對象負責在資料庫中存取數據 V ...
  • 1 /// <summary> 2 /// 數據表轉換類 3 /// </summary> 4 /// <typeparam name="T"></typeparam> 5 public class DbTableConvertor<T> where T : new() 6 { 7 /// <sum ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...