Linux 源码编译 Nginx 时怎么开启 HTTP2 协议支持-Nginx-PHP中文网

nginx源码编译启用http/2必须同时满足：openssl≥1.0.2e（推荐1.1.1+）、显式启用--with-http_ssl_module和--with-http_v2_module、listen 443 ssl http2配置正确、alpn协商成功，缺一不可。

linux 源码编译 nginx 时怎么开启 http2 协议支持

要在 Linux 上通过源码编译 Nginx 并真正启用 HTTP/2 支持，不能只加个模块名就完事——必须确保 OpenSSL 兼容、模块显式启用、TLS 协商路径畅通。下面分四步讲清楚关键操作。

HTTP/2 在 Nginx 中强制走加密通道，依赖 OpenSSL 的 ALPN 协商能力：

运行 openssl version，确认 ≥ 1.0.2e（推荐 1.1.1 或 3.x）；若系统自带版本过低（如 CentOS 7 默认的 1.0.2k 虽可用，但 1.0.1e 不支持 ALPN），需单独编译安装新版 OpenSSL
安装基础编译工具：yum groupinstall "Development Tools"（CentOS/RHEL）或 apt install build-essential libpcre3-dev zlib1g-dev libssl-dev（Ubuntu/Debian）
提前下载好源码包：Nginx（≥1.9.5，建议 1.24+）、OpenSSL（如 3.0.20）、PCRE 和 zlib（系统已有可跳过）

HTTP/2 模块（http_v2_module）与 SSL 模块（http_ssl_module）缺一不可，且需明确指向正确的 OpenSSL：

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

若 OpenSSL 已系统安装且版本达标：
./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_v2_module --with-http_stub_status_module
若 OpenSSL 是手动编译安装在 /usr/local/ssl：
./configure --prefix=/usr/local/nginx --with-openssl=/usr/local/ssl --with-http_ssl_module --with-http_v2_module --with-http_stub_status_module
务必避免遗漏 --with-http_ssl_module——http_v2_module 依赖它，否则编译会通过但运行时无法协商 HTTP/2

执行 make && sudo make install 后，检查是否真启用了模块：

运行 /usr/local/nginx/sbin/nginx -V 2>&1 | grep -o with-http_v2_module，输出应为 with-http_v2_module（不能为空或报错）
运行 /usr/local/nginx/sbin/nginx -V 2>&1 | grep -i openssl，确认显示的 OpenSSL 路径和版本符合预期
运行 ldd /usr/local/nginx/sbin/nginx | grep ssl，确保链接的是你指定的 OpenSSL 动态库（如 libssl.so.3），不是系统旧版

模块编译进去了，只是第一步；实际生效还要靠正确配置：

编辑站点 server 块，把原 listen 443 ssl; 改为 listen 443 ssl http2;（IPv4）或 listen [::]:443 ssl http2;（IPv6）
必须合并写在同一行，不能拆成 listen 443 ssl; 和 listen 443 http2;，否则 Nginx 会静默忽略 http2
配套设置 ssl_protocols TLSv1.2 TLSv1.3;，禁用 TLSv1.0/TLSv1.1；证书路径（ssl_certificate 和 ssl_certificate_key）要指向可读的 PEM 文件

不复杂但容易忽略