在 nginx 源码编译中添加 http/2 支持,核心步骤是在执行 ./configure 时加入 --with-http_v2_module 参数。这会将 http/2 模块静态编译进 nginx 二进制文件中,从而启用该功能。配置完成后,运行 make 和 make install 即可完成安装。

如何验证编译后的 Nginx 是否包含 http_v2_module
要确认编译结果中是否成功集成了 HTTP/2 模块,最直接的方法是使用 -V 参数查看 Nginx 的版本及配置信息。执行 nginx -V 后,在输出的 configure arguments 列表中查找 --with-http_v2_module。如果存在该参数,说明模块已正确编译并嵌入到当前二进制文件中。

nginx -V # 输出示例: # nginx version: nginx/1.24.0 # built by gcc 11.4.0 (Ubuntu 11.4.0-1ubuntu1~22.04) # configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --with-http_v2_module
除了命令行检查,还可以通过编写一个简单的测试脚本来验证模块加载情况。创建一个名为 check_module.sh 的脚本,内容如下:
#!/bin/bash
if nginx -V 2>&1 | grep -q "--with-http_v2_module"; then
echo "HTTP/2 module is present."
else
echo "HTTP/2 module is NOT present."
fi
赋予执行权限后运行 ./check_module.sh,若输出 HTTP/2 module is present.,则证明编译成功。此方法适用于自动化部署流程中的快速校验。
编译依赖 OpenSSL 版本对 HTTP/2 的影响
HTTP/2 模块依赖于 OpenSSL 库来实现 TLS 加密连接。在较新版本的 Nginx(1.9.5+)中,默认使用 OpenSSL 1.1.1 或更高版本以支持 ALPN(应用层协议协商),这是 HTTP/2 over TLS 的必要条件。如果在编译时使用的 OpenSSL 版本过低,可能导致 HTTP/2 功能无法正常工作或编译失败。

# 检查当前系统 OpenSSL 版本 openssl version # 预期输出:OpenSSL 1.1.1k 25 Mar 2021 或更高 # 如果需要使用特定版本的 OpenSSL,可以在 configure 时指定路径 ./configure --with-openssl=/path/to/openssl/source --with-http_v2_module
确保 OpenSSL 支持 ALPN 是启用 HTTP/2 的关键。可以通过以下命令验证 OpenSSL 是否支持 ALPN:
openssl s_client -connect example.com:443 -alpn h2 # 如果返回 Protocol : h2,则支持 ALPN
在实际操作中,建议从官方源下载最新稳定版的 OpenSSL 源码,并在编译 Nginx 前完成其安装。这样可以避免因依赖问题导致的编译错误或运行时异常。同时,注意保持 Nginx 与 OpenSSL 版本的兼容性,参考官方文档获取支持的版本列表。
配置 Nginx 启用 HTTP/2 的具体指令
编译完成后,需要在 Nginx 配置文件中使用 listen 指令显式启用 HTTP/2。在 server 块中,将 listen 端口设置为 443 ssl http2。例如:
server {
listen 443 ssl http2;
server_name example.com;
ssl_certificate /etc/nginx/ssl/cert.pem;
ssl_certificate_key /etc/nginx/ssl/key.pem;
# ... 其他配置
}
对于 Nginx 1.25.1 及以上版本,推荐使用 http2 on; 指令替代 http2 参数,因为旧语法已被弃用。示例如下:
server {
listen 443 ssl;
http2 on;
server_name example.com;
# ... 其他配置
}
修改配置后,务必执行 nginx -t 测试配置文件的语法正确性,然后使用 nginx -s reload 重新加载配置以使更改生效。通过浏览器开发者工具或 curl -I https://example.com 可以验证 HTTP/2 是否已成功启用。


















