如何在 Nginx 中启用 HTTP 3.0/QUIC 支持

最新推荐文章于 2025-02-28 00:03:30 发布
最新推荐文章于 2025-02-28 00:03:30 发布
阅读量1w 收藏 16
点赞数 3
文章标签： nginx linux java http https

公众号关注 「奇妙的 Linux 世界」

设为「星标」，每天带你玩转 Linux ！



在 Nginx 中支持 HTTP3.0 / QUIC

HTTP 3.0，也称作 HTTP over QUIC。核心是 QUIC (读音quick)协议，由 Google 在 2015 年提出的 SPDY v3 演化而来的新协议，传统的 HTTP 协议是基于传输层 TCP 的协议，而 QUIC 是基于传输层 UDP 上的协议，可以定义成：HTTP3.0 基于 UDP 的安全可靠的 HTTP2.0 协议，主要有以下特性：

图片来自Nginx官博

  • 基于 UDP 减少了 TCP 三次握手及 TLS 握手时间

  • 解决多路复用丢包时的线头阻塞问题

  • 优化重传策略

  • 流量控制

  • 连接迁移

本文主要讲解一下如何在 Nginx 中开启 HTTP3.0 的支持。

方案选择

对于 HTTP3.0，由于整个协议还是处于草案阶段，目前来说没有一个完整的标准，所以各大浏览器厂商还只是在开发者版本中才会支持，例如 Chrome的金丝雀版本 Chrome Canary[1]，并且各个服务器厂商也是在持续跟进中，对于 Nginx 来说，支持 HTTP3.0 目前有两种方案可以选择：

  • 基于 Cloudflare 的分支版本 Nginx：对于 HTTP3.0/QUIC，Cloudflare 始终走在了前列，借助于自家维护的开源项目 quic[2]，从 Nginx 中拉出了一个分支来开发，并编译出了对 HTTP 3.0 支持的 Nginx 服务器。

  • Nginx 官方 Nginx-quic 项目：今年 6 月1 0 日，Nginx 官博[3]发布公告称已经在研发支持 HTTP3.0/QUIC 协议的工作，目前项目维护在 nginx-quic[4]，该项目和基于 Cloudflare 基于 Nginx 的分支并无关系，算是相对于正统的方案。

基于此，本文将会以部署 nginx-quic 的方式来让 Nginx 支持 HTTP3.0/QUIC。

改造过程

我们最终的目的是得到 nginx-quic 版本的 nginx 可执行文件，需要经过一系列的安装和编译，期间可能会遇到很多问题，如果各位读者不想实际操作，可以直接用我编译好的版本 nginx-quic.linux-x86_64.zip 传送门[5]。

准备工作：

以 centos7 为例，下载 nginx-quic 源码传送门[6]，下载完成之后，需要进行编译安装，由于 nginx-quic 依赖 boringSSL，所以还需下载 boringSSL 源码传送门[7]，然后同样需要编译安装 boringSSL，执行这些操作之前，需要在 linux 上安装一些前置模块，通过 yum 来安装，执行以下命令：

sudo yum install build-essential mercurial psmisc lsb-release cmake golang libunwind-dev git libpcre3-dev zlib1g-dev

什么是 boringSSL：

对于 Nginx 来说，在编译时需要配置对于的 SSL 库，不管是 HTTP3.0 还是 HTTP2.0，始终都要基于 HTTPS，而加密算法这块主要有 OpenSSL来提供，而 BoringSSL 是谷歌创建的 OpenSSL 分支，用于支持 TLS1.3的 UDP 协议 0-RTT 数据传输的加密算法（可以理解成 TLS 1.3 是标准协议，BoringSSL 是实现工具），BoringSSL 的一些特性会在合适的时机同步给 OpenSSl。

编译安装 boringSSL：

cd boringssl-master/
mkdir build
cd build
cmake ../
make

执行之后，可以在 build/crypto，和 build/ssl下获得对应的文件，如下图：

注意编译安装 boringSSL 需要使用 cmake3 以上的版本。

编译安装 nginx-quic：

cd nginx-quic/
./auto/configure --prefix=/root/nginx --with-http_ssl_module --with-http_v2_module --with-http_v3_module --with-cc-opt="-I../boringssl-master/include" --with-ld-opt="-L../boringssl-master/build/ssl -L../boringssl-master/build/crypto"
make 
make install

执行命令之后，会在/root/nginx目录下生成对应的 nginx 可执行文件，如下图：

其中，配置文件在conf/下，nginx命令在sbin/目录下。

修改配置文件，启动 nginx：

vi /root/nginx/conf/nginx.conf

添加 http3 配置:

server {
    listen 443 ssl http2;              # TCP listener for HTTP/2
    listen 443 http3 reuseport;  # UDP listener for QUIC+HTTP/3

    ssl_protocols       TLSv1.3; # QUIC requires TLS 1.3
    ssl_certificate     ssl/www.example.com.crt;
    ssl_certificate_key ssl/www.example.com.key;

    add_header Alt-Svc 'quic=":443"; h3-27=":443";h3-25=":443"; h3-T050=":443"; h3-Q050=":443";h3-Q049=":443";h3-Q048=":443"; h3-Q046=":443"; h3-Q043=":443"'; # Advertise that QUIC is available
}

其中，要求使用 TLSv1.3 版本，并且当浏览器不支持 http3 时，可以选择 http2。另外，add_header Alt-Svc添加这个返回头不可缺少。

  • Alt-Svc 全称为 “Alternative-Service”，直译为“备选服务”。该头部列举了当前站点备选的访问方式列表，让服务器可以告诉客户端 “看，我在这个主机的这个端口用这个协议提供相同的服务”。一般用于在提供 “QUIC” 等新兴协议支持的同时，实现向下兼容。参考 MDN[8]。

验证 HTTP3 生效：

由于目前浏览器对HTTP3.0/QUIC的支持性有限，可以通过 http3check.net/[9] 来验证站点启用HTTP3是否成功，以我的站点为例：

坑点总结

整个过程看似很简单，但是真正配置过程中遇到了不少坑，前前后后加上搜索问题花了一天半的时间才真正解决，把这些问题记录下来，分享给大家。

开启 UDP 的 443 端口：

由于 quic 协议使用的是 UDP 的 443 端口，这个端口对于 centos7 来说是默认关闭的，可以采用下面命令开启：

firewall-cmd --zone=public --add-port=443/udp --permanent

如果项目托管在阿里云上，需要更新 ECS 的安全组策略来对外开启对应的协议和端口，如下图：

TLS 版本向下兼容：

由于使用了 TLS 1.3，所以会修改对应加密算法，但是对于一些浏览器而言还不支持这么高的版本，尤其是对于苹果的 Safari，所以，在配置 nginx 配置文件时，要多配置几个版本向下兼容，代码如下：

ssl_protocols       TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;

-Werror 错误问题：

在编译 nginx-quic 时，有时会遇到如下错误：

cc -c -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g -I../boringssl-master/include -I src/core -I src/event -I src/event/modules -I src/os/unix -I objs \
 -o objs/src/os/unix/ngx_linux_sendfile_chain.o \
 src/os/unix/ngx_linux_sendfile_chain.c
cc -c -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g -I../boringssl-master/include -I src/core -I src/event -I src/event/modules -I src/os/unix -I objs \
 -o objs/src/event/ngx_event_openssl.o \
 src/event/ngx_event_openssl.c
cc -c -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g -I../boringssl-master/include -I src/core -I src/event -I src/event/modules -I src/os/unix -I objs \
 -o objs/src/event/ngx_event_openssl_stapling.o \
 src/event/ngx_event_openssl_stapling.c
cc -c -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g -I../boringssl-master/include -I src/core -I src/event -I src/event/modules -I src/os/unix -I objs \
 -o objs/src/event/ngx_event_quic.o \
 src/event/ngx_event_quic.c
cc -c -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g -I../boringssl-master/include -I src/core -I src/event -I src/event/modules -I src/os/unix -I objs \
 -o objs/src/event/ngx_event_quic_transport.o \
 src/event/ngx_event_quic_transport.c
src/event/ngx_event_quic_transport.c: In function ‘ngx_quic_create_stream’:
src/event/ngx_event_quic_transport.c:54:9: error: comparison is always true due to limited range of data type [-Werror=type-limits]
      : ((uint32_t) value) <= 16383 ? 2                                        \
         ^
src/event/ngx_event_quic_transport.c:1299:15: note: in expansion of macro ‘ngx_quic_varint_len’
         len = ngx_quic_varint_len(sf->type);
               ^
cc1: all warnings being treated as errors
make[1]: *** [objs/src/event/ngx_event_quic_transport.o] Error 1
make[1]: Leaving directory `/root/nginx-quic'
make: *** [build] Error 2
[root@iz2zehmi1ztqtx8tg6ca7gz nginx-quic]#

解决办法是：

cd nginx-quic\objs

vi Makefile

找到 CFLAGS = -pipe -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g -I../boringssl-master/include将 -Werror 参数去掉。

reuseport 只需配置一次：

假如有多个域名需要开启 http3，则 reuseport 建议只在根域名上配置，如果一个配置文件中出现多个 reuseport，会报错，配置如下：

    server {
        
        listen 443 ssl http2;              # TCP listener for HTTP/2
        listen 443 http3 reuseport;  # UDP listener for QUIC+HTTP/3

        server_name  www.nihaoshijie.com.cn default_server;

    }

    server {

        listen 443 ssl http2;        # TCP listener for HTTP/2
        listen 443 http3;  # UDP listener for QUIC+HTTP/3

        server_name  app.nihaoshijie.com.cn;

    }

编译安装时的性能问题：

如果编译安装时报类似下面的错误，可能是主机的内容不足，需要关闭一些运行的程序来往下进行。

...
c++: internal compiler error: Killed (program cc1plus)

快开启你的 HTTP3 之旅吧!

参考资料

[1]

Chrome Canary: https://www.google.cn/chrome/canary/

[2]

cloudflare-quic: https://cloudflare-quic.com/

[3]

introducing-technology-preview-nginx-support-for-quic-http-3: https://www.nginx.com/blog/introducing-technology-preview-nginx-support-for-quic-http-3/

[4]

nginx-quic: https://hg.nginx.org/nginx-quic

[5]

nginx-quic.linux-x86_64.zip: https://www.nihaoshijie.com.cn/mypro/nginx-quic.linux-x86_64.zip

[6]

nginx-quic-source-code: https://hg.nginx.org/nginx-quic

[7]

boringssl-code: https://github.com/google/boringssl

[8]

MDN: https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Alt-Svc

[9]

http3check: https://http3check.net/?host=www.nihaoshijie.com.cn

本文转载自：「云原生生态圈」，原文：https://tinyurl.com/yd4kzvv3，版权归原作者所有。欢迎投稿，投稿邮箱: editor@hi-linux.com。


你可能还喜欢

点击下方图片即可阅读

手把手教你深度定制 Kubernetes Nginx Ingress 错误提示页面

点击上方图片，打开小程序，加入「玩转 Linux」圈子

更多有趣的互联网新鲜事，关注「奇妙的互联网」视频号全了解！

运维之美
关注
Nginx中支持HTTP3.0/QUIC
ordersyhack
02-01 2339
Nginx中支持HTTP3.0/QUIC
NGINX开启HTTP3，给web应用提个速
水中加点糖
09-08 3173
如rfc9114所述，http3主要基于QUIC协议实现，在具备高性能的同时又兼备了可靠性的特点，在大多数场景下可提高web应用的访问速率。关于http3和quic的介绍网上资料有很多，这里不再过多赘述。自nginx的1.25.0版本开始，nginx首次对http3进行了正式支持，这也为我们在WEB服务器上部署http3提供了极大的便利。本文以重实践角度出发，使用web服务器——NGINX，分享下如何在NGINX中开启HTTP3。在浏览器中通过ip或域名访问搭建的站点。
一文说清楚Http1到Http2到Http3的优化
最新发布
LUCIAZZZ的博客
02-28 916
但是，对于一些具有重复性的 HTTP 请求，比如每次请求得到的数据都一样的，我们可以把这对「请求 - 响应」的数据都缓存在本地，那么下次就直接读取本地的数据，不必在通过网络获取服务器的响应了，这样的话 HTTP/1.1 的性能肯定肉眼可见的提升。
CentOS7 开启 Nginx HTTP3.0/QUIC 支持
2401_86358234的博客
07-19 663
HTTP 3.0，也称作 HTTP over QUIC。ps：2023年5月23日起，nginx 官方主线版本 1.25.0 开始正式支持 quic 协议，可自行下载。创建 /opt/nginx/conf/conf.d/example.conf 文件（内容如下）创建 /opt/nginx/conf/conf.d 目录。下载 nginx-quic 源码。下载 ngx_brotli 源码。下载 QuicTLS 源码。下载 pcre2 源码。下载 zlib 源码。
如何配置Nginx以实现HTTP/3支持？
长风破浪会有时的博客
06-11 1061
首先，我们需要了解什么是HTTP/3。HTTP/3是HTTP协议的最新版本，它使用了一种叫做QUIC的新技术来传输数据。与之前的HTTP版本相比，HTTP/3可以更快地加载网页，提供更好的性能和用户体验。请注意，为了使用HTTP/3，你的客户端（如浏览器）也需要支持QUIC协议。指令，指定Nginx监听443端口，并启用了SSL、HTTP/2和QUIC（HTTP/3）。在配置文件中，我们需要添加一个支持HTTP/3的监听块。重新加载配置后，Nginx就会开始支持HTTP/3了。
Nginx HTTP/3服务器-客户端环境搭建
m0_71540099的博客
03-05 3254
NGINX作为一种高性能的Web服务器，在现代Web架构中扮演着至关重要的角色。而随着HTTP/3协议的推出，基于QUIC协议的新一代传输层协议，开发者们迎来了一个全新的性能和安全性提升的机会。 本文旨在介绍如何搭建NGINX HTTP/3服务器环境，并详细讨论了HTTP/3协议的优势和特性。我们将从NGINX服务器的安装和配置开始，逐步说明如何启用和配置HTTP/3支持，以及如何测试服务器以确保一切正常运行。通过本文的指导，读者将能够轻松地搭建一个高性能、安全的NGINX HTTP/3服务器。
Nginx 开启http3 quic支持——筑梦之路
筑梦之路
09-30 1811
环境说明： 操作系统：ubuntu nginx版本 1.20.1 https://github.com/cloudflare/quiche/tree/master/extras/nginx 1.安装编译工具包 apt install --no-install-recommends -y \ build-essential software-properties-common flex bison \ libpcre3-dev libpcre++-dev libx.
centos6.9安装nginx安装http3
c-rain
04-14 1112
前言：   安装nginx支持http3时对版本是软件的有一些要求的，安装过程中如果版本不差异会导致编译存在问题。 还有就是安装过程中会有一些依赖支持库;   gcc版本：大于 gcc-4.7   pcre版本： pcre-8.00   nginx版本： nginx-1.17.9 或 nginx-1.16.x   cmake版本： 大于 cmake-3.0   golang版本： go1.13.x...
使用nginx-quic支持HTTP/3
tinychen
03-01 4466
本文主要介绍使用nginx-quic和boringssl项目来对服务器进行升级支持HTTP/3协议。 1、背景介绍 nginx官方从1.19版本开始，新建立了一个分支，专门用来对QUIC进行支持，官网的链接点这里。注意该项目还处于早期的alpha版本，非常不建议用于生产环境。 The code is at an early alpha level of quality and should not be used in production. nginx-quic的安装包可以在下面这里找到，由于还处于
编译Nginx配置QUIC/HTTP3.0
jaket5219999的博客
04-08 833
1. 安装。
宝塔编译Nginx开启HTTP/3.0+Brotli
u014555255的博客
05-28 2442
宝塔编译Nginx开启HTTP/3.0+Brotli
nginx-quic
07-27
- *1* [如何在 Nginx 中启用 HTTP 3.0/QUIC 支持](https://blog.csdn.net/easylife206/article/details/112975714)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_...
LNMP 环境下 Nginx 1.26.0 开启 HTTP/3 QUIC 支持
草根博客站长明月登楼的CSDN博客
05-06 2291
对于使用了国内 CDN 的站点来说，这个 Nginx 里开启 HTTP/3 QUIC 后可能是没有效果的，因为还需要 CDN 层面的支持，国内支持 HTTP/3 QUIC 的好像只有七牛、又拍云，国外 CloudFlare 免费支持 HTTP/3 QUIC 开启的，并且只要 CDN 支持 HTTP/3 QUIC，源站开没开启 HTTP/3 QUIC 都是可以的，所以本文更多的是处于技术学习的范畴了，毕竟现在网站没有 CDN 的保护是不敢想象的，裸奔的服务器和网站在现在的国内互联网生态里太少见了。
如何配置Nginx以实现QUIC协议支持？
长风破浪会有时的博客
06-04 730
首先，我们需要确保我们的Nginx服务器是支持QUIC协议的版本。在我们的Nginx配置文件中，我们需要添加一些配置来启用QUIC协议的支持。另外，由于QUIC协议相对较新，并且还在不断的发展和完善中，因此并不是所有的设备和网络环境都支持QUIC协议。在配置QUIC支持时，我们需要考虑到这一点，并确保我们的服务器能够同时处理QUIC和传统协议的请求。总的来说，配置Nginx以实现QUIC协议的支持就像是为我们的服务器添加了一种新的通信方式。配置完成后，我们需要重启我们的Nginx服务器，以使新的配置生效。
http3 nginx quic 安装与配置
李炜伦的博客
11-11 3126
nginx quic分支地址http://hg.nginx.org/nginx-quic，下载gz或者zip压缩包 boringssl地址https://github.com/google/boringssl.git，下载zip压缩包 编译boringssl yum install gcc-c++ libunwind-devel golang cmake; /opt/boringssl-master/; mkdir build; cd build; cmake ../; make -j 4; 编译ngin
okhttp3.0的简单使用
qq_lzty的博客
10-26 402
首先实例化一个httpclient OkHttpClient client=new OkHttpClient(); client.newCall(request).enqueue(callback);异步请求 client.newCall(request).execute().body().string();//同步请求 同步请求时需try{}catch(){};将异常抛出1.简单的get
Nginx（16）-利用http2/http3提升系统性能及支持websocket
davidwkx的博客
11-21 1068
HTTP（ Hyper Text Transfer Protocol 超文本传输协议）是为Web浏览器与Web服务器之间的通信而设计的应用层传输协议，用于传输超文本文档，基于TCP协议。HTTP/2和HTTP/3都是HTTP发展产物，当前主流是HTTP/2，所有客户端器和服务端均支持。HTTP/3支持还并不那么全面。Nginx也是在最新版本Nginx1.25版本开始支持HTTP/3。
Nginx QUIC 开源项目教程
gitblog_00684的博客
08-22 675
Nginx QUIC 开源项目教程 nginx-quicnginx support quic项目地址:https://gitcode.com/gh_mirrors/ng/nginx-quic 1. 项目的目录结构及介绍 Nginx QUIC 项目的目录结构如下： nginx-quic/ ├── auto ├── conf ├── contrib ├── src │ ├── core │ ...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值