ASP.NET Core 中的網頁伺服器實作
注意
這不是這篇文章的最新版本。 如需目前的版本,請參閱 本文的 .NET 9 版本。
警告
不再支援此版本的 ASP.NET Core。 如需詳細資訊,請參閱 .NET 和 .NET Core 支援原則。 如需目前版本,請參閱本文的 .NET 8 版本。
由 Tom Dykstra、Steve Smith、Stephen Halter 和 Chris Ross 提供
ASP.NET Core 應用程式執行時,需使用內含式 HTTP 伺服器實作。 伺服器實作會接聽 HTTP 要求,並以組成 HttpContext 的一組要求功能形式向應用程式呈現。
ASP.NET Core 隨附下列項目:
- Kestrel 伺服器是預設、跨平台的 HTTP 伺服器實作。 Kestrel 可提供最佳的效能和記憶體使用率,但其沒有 HTTP.sys 中的一些進階功能。 如需詳細資訊,請參閱 Windows 索引標籤中的 Kestrel 與HTTP.sys。
- IIS HTTP 伺服器是 IIS 的同處理序伺服器。
- HTTP.sys 伺服器是以 HTTP.sys 核心驅動程式與 HTTP 伺服器 API 為基礎的僅限 Windows HTTP 伺服器。
使用 IIS 或 IIS Express 時,應用程式可能會執行於:
- 位於與 IIS HTTP 伺服器的 IIS 背景工作處理序 (同處理序代管模型) 相同的處理序中。 「同處理序」是建議的設定。
- 從 IIS 背景工作處理序中分離出的處理序 (跨處理序裝載模型),並搭配 Kestrel 伺服器。
ASP.NET Core 模組是一種原生 IIS 模組,可處理 IIS 與同處理序 IIS HTTP 伺服器或 Kestrel 之間的原生 IIS 要求。 如需詳細資訊,請參閱適用於 IIS 的 ASP.NET Core 模組 (ANCM)。
Kestrel 與 HTTP.sys
Kestrel 有以下幾個勝過 HTTP.sys 的優點:
- 更好的效能和記憶體使用率。
- 跨平台
- 靈活度,其開發和修補與作業系統無關。
- 程式設計連接埠和 TLS 設定
- 擴充性,允許使用 PPv2 等通訊協定和替代傳輸。
Http.Sys 會以共用核心模式元件的形式運作,具有 kestrel 所沒有的以下功能:
- 連接埠共用
- 核心模式視窗驗證。 Kestrel 僅支援使用者模式的驗證.
- 透過佇列傳輸實現快速 Proxy
- 直接檔案傳輸
- 回應快取
裝載模型
有數個裝載模型可供使用:
Kestrel 自我裝載:Kestrel 網頁伺服器會執行,而不需要任何其他外部網頁伺服器,例如 IIS 或 HTTP.sys。
HTTP.sys 自我裝載是 Kestrel 的替代方案。 除非應用程式需要的功能在 Kestrel 中並未提供,否則建議使用 Kestrel 而不要使用 HTTP.sys。
IIS 同處理序裝載:ASP.NET Core 應用程式會在與其 IIS 工作者處理序相同的處理序中執行。 因為要求未透過回送介面卡 (將連出網路流量傳回同一部電腦的網路介面) 進行 proxy 處理,所以 IIS 同處理序裝載會提供優於 IIS 跨處理序裝載的效能。 IIS 透過 Windows 處理序啟用服務 (WAS) 來執行處理程序管理。
IIS 非同處理序代管:ASP.NET Core 應用程式可執行於與 IIS 背景工作處理序不同的處理序中,且此模組會進行處理序的管理。 此模組會在第一個要求到達時啟動 ASP.NET Core 應用程式的處理序,並在應用程式關閉或損毀時將它重新啟動。 此行為基本上與執行同處理序,並由 Windows 處理序啟用服務 (WAS) 所管理的應用程式相同。 使用另外的程序也可讓您裝載來自相同應用程式集區的多個應用程式。
如需詳細資訊,請參閱下列:
Kestrel
Kestrel 伺服器是預設、跨平台的 HTTP 伺服器實作。 Kestrel 可提供最佳的效能和記憶體使用率,但其沒有 HTTP.sys 中的一些進階功能。 如需詳細資訊,請參閱本文件中的 Kestrel 與 HTTP.sys。
使用 Kestrel:
供本身當作直接從網路 (包括網際網路) 處理要求的邊緣伺服器。
搭配「反向 Proxy 伺服器」使用,例如 Internet Information Services (IIS)、Nginx 或 Apache。 反向 Proxy 伺服器會從網際網路接收 HTTP 要求,然後轉送到 Kestrel。
支援任一裝載設定:使用或不使用反向 Proxy 伺服器。
如需 Kestrel 設定指引以及何時要在反向 Proxy 設定中使用 Kestrel 的資訊,請參閱 ASP.NET Core 中的 Kestrel 網頁伺服器。
ASP.NET Core 隨附下列項目:
- Kestrel 伺服器是預設、跨平台的 HTTP 伺服器。
- HTTP.sys 伺服器是以 HTTP.sys 核心驅動程式與 HTTP 伺服器 API 為基礎的僅限 Windows HTTP 伺服器。
在使用 IIS 或 IIS Express 時,應用程式會執行於從 IIS 背景工作處理序中分離出的處理序 (跨處理序),並搭配 Kestrel 伺服器。
因為 ASP.NET Core 應用程式執行所在的處理序會與 IIS 工作者處理序分開,所以此模組會執行處理程序管理。 此模組會在第一個要求到達時啟動 ASP.NET Core 應用程式的處理序,並在應用程式關閉或損毀時將它重新啟動。 此行為基本上與執行同處理序,並由 Windows 處理序啟用服務 (WAS) 所管理的應用程式相同。
下圖說明 IIS、ASP.NET Core 模組和跨處理序裝載應用程式之間的關聯性:
要求會從 Web 到達核心模式的 HTTP.sys 驅動程式。 驅動程式會在網站設定的通訊埠上將要求路由至 IIS,此通訊埠通常是 80 (HTTP) 或 443 (HTTPS)。 此模組會在應用程式的隨機通訊埠上將要求轉送至 Kestrel,而且不會是通訊埠 80 或 443。
此模組在啟動時透過環境變數指定連接埠,而 IIS 整合中介軟體則會設定伺服器來接聽 http://localhost:{port}
。 將會執行額外檢查,不是源自模組的要求都會遭到拒絕。 此模組不支援 HTTPS 轉送,因此即使由 IIS 透過 HTTPS 接收,要求還是會透過 HTTP 轉送。
Kestrel 收取來自模組的要求之後,要求會被推送至 ASP.NET Core 中介軟體管線。 中介軟體管線會處理要求,並將其作為 HttpContext
執行個體傳遞至應用程式的邏輯。 IIS Integration 新增的中介軟體會更新配置、遠端 IP 和帳戶路徑基底,以將要求轉送至 Kestrel。 應用程式的回應會傳回 IIS,而 IIS 會將其推送回起始要求的 HTTP 用戶端。
如需 IIS 和 ASP.NET Core 模組的設定指南,請參閱下列主題:
Nginx 搭配 Kestrel
如需如何在 Linux 上使用 Nginx 作為 Kestrel 反向 Proxy 伺服器的資訊,請參閱在 Linux 上使用 Nginx 裝載 ASP.NET Core。
HTTP.sys
如果您在 Windows 上執行 ASP.NET Core 應用程式,則 HTTP.sys 是 Kestrel 的替代方案。 除非應用程式需要的功能在 Kestrel 中並未提供,否則建議使用 Kestrel 而不要使用 HTTP.sys。 如需詳細資訊,請參閱在 ASP.NET Core 中實作 HTTP.sys 網頁伺服器。
HTTP.sys 也可用於只公開到內部網路的應用程式。
如需 HTTP.sys 設定指引,請參閱 ASP.NET Core 中的 HTTP.sys 網頁伺服器實作。
ASP.NET Core 伺服器基礎結構
Startup.Configure
方法提供的 IApplicationBuilder 會公開類型IFeatureCollection 的 ServerFeatures 屬性。 Kestrel 與 HTTP.sys 各自只會公開單一功能 IServerAddressesFeature,但不同的伺服器實作可公開更多的功能。
IServerAddressesFeature
可用來找出伺服器實作在執行階段已繫結的連接埠。
自訂伺服器
如果內建伺服器不符合應用程式的需求,則可以建立自訂伺服器實作。 Open Web Interface for .NET (OWIN) 指南示範如何撰寫採用 Nowin 的 IServer 實作。 只有該應用程式使用的功能介面才需要實作,但至少須支援 IHttpRequestFeature 及 IHttpResponseFeature。
伺服器啟動
伺服器會在整合式開發環境 (IDE) 或編輯器啟動應用程式時啟動:
- Visual Studio:您可以使用啟動設定檔搭配 IIS Express/ASP.NET Core 模組或主控台來啟動應用程式和伺服器。
- Visual Studio Code:應用程式和伺服器會由 Omnisharp 啟動,這也可啟動 CoreCLR 偵錯工具。
- Visual Studio for Mac:應用程式和伺服器會由 Mono Soft-Mode 偵錯工具啟動。
當您在專案資料夾中使用命令提示字元啟動應用程式時,dotnet run 會啟動應用程式和伺服器 (僅限 Kestrel 和 HTTP.sys)。 組態是由 -c|--configuration
選項指定,會設為 Debug
(預設值) 或 Release
。
使用 dotnet run
或內建在工具中的偵錯工具 (例如 Visual Studio) 啟動應用程式時,launchSettings.json
檔案會提供設定。 如果 launchSettings.json
檔案中有啟動設定檔,請使用 --launch-profile {PROFILE NAME}
選項搭配 dotnet run
命令,或在 Visual Studio 中選取設定檔。 如需詳細資訊,請參閱 dotnet run 和 .NET Core 發佈封裝。
HTTP/2 支援
在下列部署案例中,ASP.NET Core 支援 HTTP/2:
- Kestrel
- 作業系統
- Windows Server 2016/Windows 10 或更新版本†
- Linux 含 OpenSSL 1.0.2 或更新版本 (例如 Ubuntu 16.04 或更新版本)
- macOS 10.15 或更新版本
- 目標 Framework:.NET Core 2.2 或更新版本
- 作業系統
- HTTP.sys
- Windows Server 2016/Windows 10 或更新版本
- 目標 Framework:不適用於 HTTP.sys 部署。
- IIS (同處理序)
- Windows Server 2016/Windows 10 或更新版本;IIS 10 或更新版本
- 目標 Framework:.NET Core 2.2 或更新版本
- IIS (跨處理序)
- Windows Server 2016/Windows 10 或更新版本;IIS 10 或更新版本
- 公眾對應 Edge Server 連線使用 HTTP/2,但是對 Kestrel 的反向 Proxy 連線使用 HTTP/1.1。
- 目標 Framework:不適用於 IIS 跨處理序部署。
†Kestrel 在 Windows Server 2012 R2 與 Windows 8.1 對 HTTP/2 的支援有限。 支援有限的原因是這些作業系統上的支援 TLS 密碼編譯套件清單有限。 可能需要使用橢圓曲線數位簽章演算法 (ECDSA) 產生的憑證來保護 TLS 連線。
- Kestrel
- 作業系統
- Windows Server 2016/Windows 10 或更新版本†
- Linux 含 OpenSSL 1.0.2 或更新版本 (例如 Ubuntu 16.04 或更新版本)
- 未來版本的 macOS 將會支援 HTTP/2。
- 目標 Framework:.NET Core 2.2 或更新版本
- 作業系統
- HTTP.sys
- Windows Server 2016/Windows 10 或更新版本
- 目標 Framework:不適用於 HTTP.sys 部署。
- IIS (同處理序)
- Windows Server 2016/Windows 10 或更新版本;IIS 10 或更新版本
- 目標 Framework:.NET Core 2.2 或更新版本
- IIS (跨處理序)
- Windows Server 2016/Windows 10 或更新版本;IIS 10 或更新版本
- 公眾對應 Edge Server 連線使用 HTTP/2,但是對 Kestrel 的反向 Proxy 連線使用 HTTP/1.1。
- 目標 Framework:不適用於 IIS 跨處理序部署。
†Kestrel 在 Windows Server 2012 R2 與 Windows 8.1 對 HTTP/2 的支援有限。 支援有限的原因是這些作業系統上的支援 TLS 密碼編譯套件清單有限。 可能需要使用橢圓曲線數位簽章演算法 (ECDSA) 產生的憑證來保護 TLS 連線。
- Kestrel
- 作業系統
- Windows Server 2016/Windows 10 或更新版本†
- Linux 含 OpenSSL 1.0.2 或更新版本 (例如 Ubuntu 16.04 或更新版本)
- 未來版本的 macOS 將會支援 HTTP/2。
- 目標 Framework:.NET Core 2.2 或更新版本
- 作業系統
- HTTP.sys
- Windows Server 2016/Windows 10 或更新版本
- 目標 Framework:不適用於 HTTP.sys 部署。
- IIS (同處理序)
- Windows Server 2016/Windows 10 或更新版本;IIS 10 或更新版本
- 目標 Framework:.NET Core 2.2 或更新版本
- IIS (跨處理序)
- Windows Server 2016/Windows 10 或更新版本;IIS 10 或更新版本
- 公眾對應 Edge Server 連線使用 HTTP/2,但是對 Kestrel 的反向 Proxy 連線使用 HTTP/1.1。
- 目標 Framework:不適用於 IIS 跨處理序部署。
†Kestrel 在 Windows Server 2012 R2 與 Windows 8.1 對 HTTP/2 的支援有限。 支援有限的原因是這些作業系統上的支援 TLS 密碼編譯套件清單有限。 可能需要使用橢圓曲線數位簽章演算法 (ECDSA) 產生的憑證來保護 TLS 連線。
- HTTP.sys
- Windows Server 2016/Windows 10 或更新版本
- 目標 Framework:不適用於 HTTP.sys 部署。
- IIS (跨處理序)
- Windows Server 2016/Windows 10 或更新版本;IIS 10 或更新版本
- 公眾對應 Edge Server 連線使用 HTTP/2,但是對 Kestrel 的反向 Proxy 連線使用 HTTP/1.1。
- 目標 Framework:不適用於 IIS 跨處理序部署。
HTTP/2 連線必須使用 Application-Layer Protocol Negotiation (ALPN) 和 TLS 1.2 或更新版本。 如需詳細資訊,請參閱與伺服器部署案例相關的主題。