ASP.NET Core 中的 Kestrel Web 伺服器

作者：Tom Dykstra、Chris Ross 和 Stephen Halter

Kestrel 是 ASP.NET Core 的跨平台 Web 伺服器。 Kestrel 是 ASP.NET Core 的建議伺服器，預設會在 ASP.NET Core 專案範本中進行設定。

Kestrel 的功能包括：

• 跨平台：Kestrel 是一個跨平台 Web 伺服器，可在 Windows、Linux 和 macOS 上執行。
• 高效能：Kestrel 已最佳化，可以有效地處理大量並行連線。
• 輕量型：為了在資源受限的環境 (例如容器和邊緣裝置) 中執行而進行的最佳化。
• 安全性強化：Kestrel 支援 HTTPS，並針對 Web 伺服器弱點進行強化。
• 廣泛的通訊協定支援：Kestrel 支援常見的 Web 通訊協定，包括：
  • HTTP/1.1、HTTP/2 和 HTTP/3
  • WebSocket
• 與 ASP.NET Core 整合： 與其他 ASP.NET Core 元件 (例如中介軟體管道、相依性插入和組態系統) 緊密整合。
• 彈性工作負載：Kestrel 支援多種工作負載：
  • ASP.NET 應用程式架構，例如最小 API、MVC、Razor Pages、SignalR、Blazor 和 gRPC。
  • 使用 YARP 建置反向 Proxy。
• 擴充性：Kestrel 透過組態、中介軟體和自訂傳輸進行自訂。
• 效能診斷：Kestrel 提供內建的效能診斷功能，例如記錄和計量。

開始使用

在未使用 IIS 裝載時，ASP.NET Core 專案範本預設會使用 Kestrel。 在下列範本產生的 Program.cs 中，WebApplication.CreateBuilder 方法會在內部呼叫 UseKestrel：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

如需設定 WebApplication 和 WebApplicationBuilder 的詳細資訊，請參閱基本 API 快速參考。

選擇性用戶端憑證

如需必須使用憑證來保護應用程式子集的應用程式相關資訊，請參閱選擇性用戶端憑證。

附加偵錯工具的行為

將偵錯工具附加至 Kestrel 處理序時，不會強制執行下列逾時和速率限制：

• KestrelServerLimits.KeepAliveTimeout
• KestrelServerLimits.RequestHeadersTimeout
• KestrelServerLimits.MinRequestBodyDataRate
• KestrelServerLimits.MinResponseDataRate
• IConnectionTimeoutFeature
• IHttpMinRequestBodyDataRateFeature
• IHttpMinResponseDataRateFeature

其他資源

• 設定 ASP.NET Core Kestrel 網路伺服器的端點
• 對 UseKestrel 的 WebApplication.CreateBuilder 方法呼叫的來源
• 設定 ASP.NET Core Kestrel Web 伺服器的選項
• 將 HTTP/2 與 ASP.NET Core Kestrel Web 伺服器搭配使用
• 何時將反向 Proxy 與 ASP.NET Core Kestrel Web 伺服器搭配使用
• 使用 ASP.NET Core Kestrel Web 伺服器進行主機篩選
• 針對 ASP.NET Core 專案進行疑難排解和偵錯
• 在 ASP.NET Core 中強制執行 HTTPS
• 設定 ASP.NET Core 以處理 Proxy 伺服器和負載平衡器
• RFC 9110：HTTP 語意 (第 7.2 節：主機和 :authority)
• 在 Linux 上使用 UNIX 通訊端時，在應用程式關閉時不會自動刪除通訊端。 如需詳細資訊，請參閱這個 GitHub 問題。

注意

自 ASP.NET Core 5.0 起，Kestrel 的 Libuv 傳輸已淘汰。 Libuv 傳輸不會收到支援新 OS 平台 (例如 Windows ARM64) 的更新，且在未來版本中將被移除。 移除對過時 UseLibuv 方法的所有呼叫，並改用 Kestrel 的預設 Socket 傳輸。