宝塔面板开启HTTP/3配置教程

想大幅提升网站传输性能与连接效率？HTTP/3凭借基于UDP的QUIC协议，能显著降低延迟、提升弱网体验，但宝塔面板默认并不支持——本文手把手教你如何在宝塔环境下手动编译启用HTTP/3：从内核与OpenSSL版本校验、使用BoringSSL编译支持v3模块的Nginx，到精准修改站点配置添加http3监听与alt-svc头，再到多维度验证（Chrome net-internals、Network协议列、curl命令），每一步都直击实操难点，助你安全、稳定地为现有站点注入下一代HTTP协议能力。

如果您在宝塔面板中部署了网站，但希望启用HTTP/3协议以提升传输性能与连接效率，则需手动配置Nginx的QUIC支持，因为宝塔默认不开启HTTP/3。以下是实现该目标的具体操作步骤：

一、确认系统内核与OpenSSL版本兼容性

HTTP/3依赖于支持QUIC的Nginx版本（1.25.0+）及配套的BoringSSL或OpenSSL 3.0.0+，同时要求Linux内核≥4.18以支持UDP GSO特性。未满足任一条件将导致编译失败或运行时错误。

1、执行命令 uname -r 查看当前内核版本。

2、执行命令 openssl version 验证OpenSSL是否为3.0.0或更高版本。

3、执行命令 nginx -V 2>&1 | grep -o "nginx version: nginx/1\.[2-9][5-9]" 检查Nginx主版本是否达到1.25及以上。

二、编译支持HTTP/3的Nginx（使用BoringSSL）

宝塔官方源提供的Nginx不含QUIC模块，必须从源码重新编译并启用--with-http_v3_module。BoringSSL是目前最稳定的QUIC后端实现，推荐采用。

1、执行命令 cd /www/server/panel/install && bash install.sh 进入宝塔安装目录，备份原Nginx配置。

2、执行命令 wget https://nginx.org/download/nginx-1.25.3.tar.gz && tar -zxvf nginx-1.25.3.tar.gz 下载适配HTTP/3的Nginx源码。

3、执行命令 git clone https://boringssl.googlesource.com/boringssl && cd boringssl && mkdir build && cd build && cmake .. && make -j$(nproc) 编译BoringSSL静态库。

4、执行命令 cd /root/nginx-1.25.3 && ./configure --with-http_v3_module --with-cc-opt="-I../boringssl/include" --with-ld-opt="-L../boringssl/build/ssl -L../boringssl/build/crypto" 配置编译参数。

5、执行命令 make -j$(nproc) && make install 完成编译并覆盖安装。

三、修改站点Nginx配置启用HTTP/3

HTTP/3基于UDP端口443运行，需在server块中显式声明listen指令并启用quic参数，同时复用现有TLS证书配置，无需额外证书。

1、进入宝塔面板 → 网站 → 对应站点 → 设置 → 配置文件。

2、在server块内原有listen 443 ssl行下方添加：listen 443 ssl http3;

3、在同一server块中添加：add_header alt-svc 'h3=":443"; ma=86400';

4、确保已存在 ssl_protocols TLSv1.2 TLSv1.3; 且未禁用TLSv1.3。

5、保存配置后，执行命令 nginx -t 验证语法，再执行 nginx -s reload 重载服务。

四、验证HTTP/3是否生效

配置完成后需通过客户端实际请求确认QUIC连接建立状态，仅靠响应头alt-svc字段不足以证明服务端已正确处理HTTP/3流量。

1、在Chrome浏览器地址栏输入 chrome://net-internals/#quic，点击“Start Recording”。

2、访问您的站点URL，观察日志中是否出现 QUIC_SESSION 及对应状态码200。

3、打开开发者工具 → Network选项卡 → 右键表头 → 勾选Protocol，刷新页面，检查资源协议列是否显示h3。

4、执行命令 curl -I --http3 https://your-domain.com，若返回HTTP/3响应头则表示成功。

到这里，我们也就讲完了《宝塔面板开启HTTP/3配置教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！