daohualiuxiang
/
AspNetCore.Docs
mirror of https://github.com/dotnet/AspNetCore.Docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
AspNetCore.Docs/aspnetcore/fundamentals/servers/kestrel/http2.md

42 lines
2.0 KiB
Markdown
Raw Normal View History

Split kestrel.md into multiple pages (#21091) Co-authored-by: James Newton-King <james@newtonking.com> Co-authored-by: Scott Addie <10702007+scottaddie@users.noreply.github.com>
2021-01-16 07:11:48 +08:00
---
title: Use HTTP/2 with the ASP.NET Core Kestrel web server
author: rick-anderson
description: Learn about using HTTP/2 with Kestrel, the cross-platform web server for ASP.NET Core.
monikerRange: '>= aspnetcore-5.0'
ms.author: riande
ms.custom: mvc
ms.date: 05/04/2020
Add Home and Privacy to no-loc (#22237) * Add Home and Privacy to no-loc * Add Home and Privacy to no-loc
2021-05-09 04:12:34 +08:00
no-loc: [Home, Privacy, Kestrel, appsettings.json, "ASP.NET Core Identity", cookie, Cookie, Blazor, "Blazor Server", "Blazor WebAssembly", "Identity", "Let's Encrypt", Razor, SignalR]
Split kestrel.md into multiple pages (#21091) Co-authored-by: James Newton-King <james@newtonking.com> Co-authored-by: Scott Addie <10702007+scottaddie@users.noreply.github.com>
2021-01-16 07:11:48 +08:00
uid: fundamentals/servers/kestrel/http2
---
# Use HTTP/2 with the ASP.NET Core Kestrel web server
[HTTP/2](https://httpwg.org/specs/rfc7540.html) is available for ASP.NET Core apps if the following base requirements are met:
* Operating system&dagger;
* Windows Server 2016/Windows 10 or later&Dagger;
* Linux with OpenSSL 1.0.2 or later (for example, Ubuntu 16.04 or later)
* Target framework: .NET Core 2.2 or later
* [Application-Layer Protocol Negotiation (ALPN)](https://tools.ietf.org/html/rfc7301#section-3) connection
* TLS 1.2 or later connection
&dagger;HTTP/2 will be supported on macOS in a future release.
&Dagger;Kestrel has limited support for HTTP/2 on Windows Server 2012 R2 and Windows 8.1. Support is limited because the list of supported TLS cipher suites available on these operating systems is limited. A certificate generated using an Elliptic Curve Digital Signature Algorithm (ECDSA) may be required to secure TLS connections.
If an HTTP/2 connection is established, [HttpRequest.Protocol](xref:Microsoft.AspNetCore.Http.HttpRequest.Protocol%2A) reports `HTTP/2`.
Starting with .NET Core 3.0, HTTP/2 is enabled by default. For more information on configuration, see the [Kestrel HTTP/2 limits](xref:fundamentals/servers/kestrel/options#http2-limits) and [ListenOptions.Protocols](xref:fundamentals/servers/kestrel/endpoints#listenoptionsprotocols) sections.
## Advanced HTTP/2 features
Additional HTTP/2 features in Kestrel support gRPC, including support for response trailers and sending reset frames.
### Trailers
[!INCLUDE[](~/includes/trailers.md)]
### Reset
[!INCLUDE[](~/includes/reset.md)]