ASP.NET Core 中的 Kestrel Web 服务器

作者：Tom Dykstra、Chris Ross 和 Stephen Halter

Kestrel 是一个跨平台的适用于 Kestrel。 Kestrel 是建议用于 ASP.NET Core 的服务器，默认情况下在 ASP.NET Core 项目模板中对其进行配置。

Kestrel 的功能包括：

• 跨平台：Kestrel 是可在 Windows、Linux 和 macOS 上运行的跨平台 Web 服务器。
• 高性能：Kestrel 经过优化，可有效处理大量并发连接。
• 轻量级：它经过优化，可在资源受限的环境（如容器和边缘设备）中运行。
• 强化了安全性：Kestrel支持 HTTPS 并经过强化可抵御 Web 服务器漏洞。
• 宽协议支持：Kestrel 支持常见的 Web 协议，包括：
  • HTTP/1.1、HTTP/2 和 HTTP/3
  • WebSockets
• 与 ASP.NET Core 集成：与其他 ASP.NET Core 组件（例如中间件管道、依赖项注入和配置系统）无缝集成。
• 灵活工作负载：Kestrel 支持许多工作负载：
  • ASP.NET 应用框架，例如最小 API、MVC、Razor 页、SignalR、Blazor 和 gRPC。
  • 使用 YARP 生成反向代理。
• 扩展性：通过配置、中间件和自定义传输自定义 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 Web 服务器配置终结点
• 对 WebApplication.CreateBuilder 的 UseKestrel 方法调用的源
• 为 ASP.NET Core Kestrel Web 服务器配置选项
• 对 ASP.NET Core Kestrel Web 服务器使用 HTTP/2
• 何时对 ASP.NET Core Kestrel Web 服务器使用反向代理
• 对 ASP.NET Core Kestrel Web 服务器使用主机筛选
• ASP.NET Core 项目故障排除和调试
• 在 ASP.NET Core 中强制使用 HTTPS
• 配置 ASP.NET Core 以使用代理服务器和负载均衡器
• RFC 9110：HTTP 语义（第 7.2 节：托管和授权）
• 在 Linux 上使用 UNIX 套接字时，该套接字不会在应用关闭时自动删除。 有关详细信息，请参阅此 GitHub 问题。

注意

从 ASP.NET Core 5.0 开始，Kestrel 的 libuv 传输将过时。 libuv 传输不会接收用于支持新 OS 平台（如 Windows ARM64）的更新，并会在将来的版本中被删除。 删除对过时 UseLibuv 方法的任何调用并改为使用 Kestrel 的默认套接字传输。