宝塔面板默认不开启HTTP/2,需同时满足Nginx≥1.9.5且编译启用--with-http_v2_module、已部署有效SSL证书、listen 443 ssl后显式添加http2参数,并重载配置验证h2生效。

宝塔面板默认不开启 HTTP/2,哪怕你已配置 HTTPS 且 Nginx 版本看起来够新——关键在模块是否启用、配置是否显式声明、以及 SSL 是否真正就位。只改一行 listen 443 ssl http2; 不够,漏掉任一环节都会让协议协商失败。
确认 Nginx 版本和 http_v2 模块是否真实可用
很多用户卡在这一步:宝塔显示 Nginx 是 1.22 或 1.25,但 nginx -V 输出里搜不到 http_v2。这意味着编译时没加 --with-http_v2_module,版本再高也没用。
- 执行
nginx -V 2>&1 | grep http_v2,无输出 = 模块未启用 - CentOS 7 上旧环境(如 Nginx 1.16)必须升级;推荐直接上
1.25或1.26,为 HTTP/3 预留兼容性 - 升级最稳方式是宝塔官方脚本:
wget https://download.bt.cn/install/0/nginx5.sh && bash nginx5.sh install 1.25 - 升级后务必再跑一次
nginx -V | grep http_v2确认输出存在
修改站点配置文件,显式启用 http2 协商
光有模块还不够,Nginx 必须在监听指令里“点名”用 HTTP/2。listen 443 ssl; 只表示走 TLS,不指定协议版本;http2 才触发 ALPN 协商。
- 路径:宝塔 → 网站 → 目标站点 → 设置 → 配置文件
- 找到所有带
ssl的listen 443行(包括 IPv6 的listen [::]:443 ssl;) - 逐行改为
listen 443 ssl http2;和listen [::]:443 ssl http2;,注意空格分隔,结尾分号不能丢 - 确保没有重复的
listen 443行(比如既有ssl又有非ssl的 443 监听),否则 Nginx 启动会报错 - 保存后点「重载 Nginx」,不是「重启」——重载不中断现有连接
验证是否真走 h2,别被浏览器锁图标骗了
地址栏显示小锁 ≠ HTTP/2 生效。中间代理、浏览器插件、企业防火墙都可能强制降级到 HTTP/1.1,导致本地验证失真。
- 用 Chrome 无痕模式 + 关闭所有扩展,F12 → Network → 刷新页面 → 查任意请求的
Protocol列,值为h2才算成功 - 进阶验证可访问
chrome://net-internals/#http2,搜索域名看是否有活跃的 HTTP/2 会话 - 命令行辅助:
curl -I --http2 https://yourdomain.com,返回头第一行是HTTP/2 200表示服务端支持(但客户端是否协商成功需结合浏览器验证) - 若验证失败,优先检查证书是否有效(自签名或过期证书会导致 h2 被拒)、是否开了强制 HTTPS、以及防火墙是否拦截了 ALPN 握手
最容易被忽略的是:HTTP/2 依赖完整有效的 TLS 链,哪怕证书链缺一级中间证书,Chrome 都会静默回退到 HTTP/1.1 —— 这类问题不会报错,只会让你反复怀疑配置写错了。











