KestrelServidor Web no ASP.NET Core

Por Tom Dykstra, Chris Ross e Stephen Halter

O Kestrel é um servidor Web multiplataforma para ASP.NET Core. Kestrel é o servidor recomendado para ASP.NET Core e é configurado por padrão em ASP.NET Core modelos de projeto.

Os recursos de Kestrel incluem:

• Multiplataforma:Kestrel é um servidor Web multiplataforma executado no Windows, Linux e macOS.
• Alto desempenho:Kestrel é otimizado para lidar com um grande número de conexões simultâneas com eficiência.
• Leve: otimizado para execução em ambientes restritos a recursos, como contêineres e dispositivos de borda.
• Segurança protegida:Kestrel dá suporte a HTTPS e é protegido contra vulnerabilidades do servidor Web.
• Suporte amplo a protocolos:Kestrel dá suporte a protocolos Web comuns, incluindo:
  • HTTP/1.1, HTTP/2 e HTTP/3
  • WebSockets
• Integração com o ASP.NET Core: integração perfeita com outros componentes ASP.NET Core, como o pipeline de middleware, injeção de dependência e sistema de configuração.
• Cargas de trabalho flexíveis: Kestrel dá suporte a muitas cargas de trabalho:
  • Estruturas de aplicativo do ASP.NET, como APIs mínimas, MVC, páginas do Razor, SignalR, Blazor e gRPC.
  • Criando um proxy reverso com YARP.
• Extensibilidade: Personalize Kestrel por meio de configuração, middleware e transportes personalizados.
• Diagnóstico de desempenho:Kestrel fornece recursos internos de diagnóstico de desempenho, como registro em log e métricas.

Introdução

Os modelos de projeto do ASP.NET Core usam Kestrel por padrão quando não são hospedados com o IIS. No seguinte modelo gerado Program.cs, o método WebApplication.CreateBuilder chama UseKestrel internamente:

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

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

app.Run();

Para obter mais informações sobre como configurar WebApplication e WebApplicationBuilder, consulte Referência rápida de APIs mínimas.

Certificados do cliente opcionais

Para obter informações sobre aplicativos que precisam proteger um subconjunto do aplicativo com um certificado, consulte Certificados de cliente opcionais.

Comportamento com depurador anexado

Os seguintes tempos limite e limites de taxa não são impostos quando um depurador é anexado a um processo Kestrel:

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

Recursos adicionais

• Configurar os pontos de extremidade do servidor Web Kestrel do ASP.NET Core
• Origem da WebApplication.CreateBuilderchamada de método para UseKestrel
• Configurar opções para o Kestrelservidor Web do ASP.NET Core
• Usar HTTP/2 com o Kestrelservidor Web do ASP.NET Core
• Quando usar um proxy reverso com o Kestrelservidor Web do ASP.NET Core
• Filtragem de host com o Kestrelservidor Web do ASP.NET Core
• Solucionar problemas e depurar projetos do ASP.NET Core
• Impor HTTPS no ASP.NET Core
• Configurar o ASP.NET Core para trabalhar com servidores proxy e balanceadores de carga
• RFC 9110: Semântica HTTP (Seção 7.2: Host e :authority)
• Ao usar soquetes UNIX no Linux, o soquete não é excluído automaticamente no desligamento do aplicativo. Saiba mais neste tópico do GitHub.

Observação

A partir do ASP.NET Core 5.0, o transporte libuv de Kestrel ficou obsoleto. O transporte libuv não recebe atualizações para dar suporte a novas plataformas do sistema operacional, como o Windows ARM64, e será removido em uma versão futura. Remova todas as chamadas para o método obsoleto UseLibuv e use, ao invés dele, o transporte de soquete padrão de Kestrel.