Skip to content

Commit 91e5fee

Browse files
committed
Update Kestrel HTTP/3 docs
1 parent 67b93ab commit 91e5fee

File tree

1 file changed

+22
-28
lines changed
  • aspnetcore/fundamentals/servers/kestrel

1 file changed

+22
-28
lines changed

aspnetcore/fundamentals/servers/kestrel/http3.md

Lines changed: 22 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -20,29 +20,33 @@ uid: fundamentals/servers/kestrel/http3
2020
> [!IMPORTANT]
2121
> Apps configured to take advantage of HTTP/3 should be designed to also support HTTP/1.1 and HTTP/2.
2222
23-
## HTTP/3 requirements
24-
25-
HTTP/3 has different requirements depending on the operating system. If the platform that Kestrel is running on doesn't have all the requirements for HTTP/3, then it's disabled, and Kestrel will fall back to other HTTP protocols.
26-
27-
### Windows
28-
29-
* Windows 11 Build 22000 or later OR Windows Server 2022.
30-
* TLS 1.3 or later connection.
31-
32-
### Linux
33-
34-
* `libmsquic` package installed.
23+
## HTTP/3 benefits
3524

36-
`libmsquic` is published via Microsoft's official Linux package repository at `packages.microsoft.com`. To install this package:
25+
`HTTP/3`:
3726

38-
1. Add the `packages.microsoft.com` repository. See [Linux Software Repository for Microsoft Products](/windows-server/administration/linux-package-repository-for-microsoft-software) for instructions.
39-
2. Install the `libmsquic` package using the distro's package manager. For example, `apt install libmsquic=1.9*` on Ubuntu.
27+
* Is the latest version of the Hypertext Transfer Protocol.
28+
* Builds on the strengths of `HTTP/2` while addressing some of its limitations, particularly in terms of performance, latency, reliability, and security.
4029

41-
**Note:** .NET 6 is only compatible with the 1.9.x versions of libmsquic. Libmsquic 2.x is not compatible due to breaking changes. Libmsquic receives updates to 1.9.x when needed to incorporate security fixes.
30+
+---------------+-------------------------+-------------------------+
31+
| Feature | `HTTP/2` | `HTTP/3` |
32+
+---------------+-------------------------+-------------------------+
33+
| Transport | Uses [TCP](https://developer.mozilla.org/docs/Glossary/TCP) | Uses [QUIC](https://www.rfc-editor.org/rfc/rfc9000.html) |
34+
| Layer | | |
35+
| Connection | Slower due to TCP + TLS | Faster with 0-RTT QUIC |
36+
| Setup | handshake | handshakes |
37+
| Head-of-Line | Affected by TCP-level | Eliminated with QUIC |
38+
| Blocking | blocking | stream multiplexing |
39+
| Encryption | TLS over TCP | TLS is built into QUIC |
40+
+---------------+-------------------------+-------------------------+
4241

43-
### macOS
42+
The key differences from `HTTP/2` to `HTTP/3` are:
4443

45-
HTTP/3 isn't currently supported on macOS and may be available in a future release.
44+
* **Transport Protocol**: `HTTP/3` uses QUIC instead of TCP. QUIC offers improved performance, lower latency, and better reliability, especially on mobile and lossy networks.
45+
* **Head-of-Line Blocking**: `HTTP/2` can suffer from head-of-line blocking at the TCP level, where a delay in one stream can affect others. `HTTP/3`, with QUIC, provides independent streams, so packet loss in one stream doesn't stall others.
46+
* **Connection Establishment**: `HTTP/3` with QUIC can establish connections faster, sometimes in zero round-trip time (0-RTT) for returning clients, as it combines transport and encryption handshakes.
47+
* **Encryption**: `HTTP/3` mandates TLS 1.3 encryption, providing enhanced security by default, whereas it's optional in `HTTP/2`.
48+
* **Multiplexing**: While both support multiplexing, `HTTP/3`'s implementation with QUIC is more efficient and avoids the TCP-level head-of-line blocking issues.
49+
* **Connection Migration**: QUIC in `HTTP/3` allows connections to persist even when a client's IP address changes (like switching from Wi-Fi to cellular), improving mobile user experience.
4650

4751
## Getting started
4852

@@ -71,16 +75,6 @@ HTTP/3 is discovered as an upgrade from HTTP/1.1 or HTTP/2 via the [`alt-svc`](h
7175
* Set [`HttpRequestMessage.Version`](xref:System.Net.Http.HttpRequestMessage.Version) to 3.0, or
7276
* Set [`HttpRequestMessage.VersionPolicy`](xref:System.Net.Http.HttpRequestMessage.VersionPolicy) to [`HttpVersionPolicy.RequestVersionOrHigher`](xref:System.Net.Http.HttpVersionPolicy.RequestVersionOrHigher).
7377

74-
## HTTP/3 benefits
75-
76-
HTTP/3 uses the same semantics as HTTP/1.1 and HTTP/2: the same request methods, status codes, and message fields apply to all versions. The differences are in the underlying transport. Both HTTP/1.1 and HTTP/2 use TCP as their transport. HTTP/3 uses a new transport technology developed alongside HTTP/3 called [QUIC](https://datatracker.ietf.org/doc/html/draft-ietf-quic-transport-34).
77-
78-
HTTP/3 and QUIC have a number of benefits compared to HTTP/1.1 and HTTP/2:
79-
80-
* Faster response time of the first request. QUIC and HTTP/3 negotiates the connection in fewer round-trips between the client and the server. The first request reaches the server faster.
81-
* Improved experience when there is connection packet loss. HTTP/2 multiplexes multiple requests via one TCP connection. Packet loss on the connection affects all requests. This problem is called "head-of-line blocking". Because QUIC provides native multiplexing, lost packets only impact the requests where data has been lost.
82-
* Supports transitioning between networks. This feature is useful for mobile devices where it is common to switch between WIFI and cellular networks as a mobile device changes location. Currently, HTTP/1.1 and HTTP/2 connections fail with an error when switching networks. An app or web browsers must retry any failed HTTP requests. HTTP/3 allows the app or web browser to seamlessly continue when a network changes. Kestrel doesn't support network transitions in .NET 8. It may be available in a future release.
83-
8478
:::moniker-end
8579

8680
[!INCLUDE[](~/fundamentals/servers/kestrel/includes/http3-6-7.md)]

0 commit comments

Comments
 (0)