Apache 源码编译如何启用 HTTP2 协议支持

风敏吖_8277

风敏吖_8277

2026-07-22

431人浏览

原创

Apache源码编译启用HTTP/2需先安装nghttp2开发库,再配置--enable-http2和--with-nghttp2参数,启用SSL及event MPM,加载mod_http2.so模块,并在HTTPS虚拟主机中设置Protocols h2 http/1.1。

apache 源码编译如何启用 http2 协议支持

Apache 源码编译启用 HTTP/2 支持,核心在于正确链接 nghttp2 库并启用 mod_http2 模块。HTTP/2 在 Apache 中不是默认内置功能,必须在编译阶段显式开启,且依赖外部的 libnghttp2 实现 ALPN 协商和帧解析。

确认系统已安装 nghttp2 开发库

nghttp2 是 Apache HTTP/2 的底层依赖,必须先安装其开发包(含头文件与静态/动态库):

  • Ubuntu/Debian:sudo apt install libnghttp2-dev
  • RHEL/CentOS/Fedora:sudo dnf install nghttp2-devel 或 sudo yum install nghttp2-devel
  • macOS(Homebrew):brew install nghttp2

验证安装成功:nghttp --version 应输出版本号(建议 ≥ 1.41.0),pkg-config --modversion nghttp2 也应返回有效版本。

编译时指定 --enable-http2 和 --with-nghttp2

解压 Apache 源码后,在 configure 阶段必须显式启用 HTTP/2 并指向 nghttp2 路径:

  • 若系统 pkg-config 可识别 nghttp2,直接使用:
    ./configure --enable-http2 --enable-ssl --enable-so --with-mpm=event
  • 若 configure 找不到 nghttp2(常见于自定义安装路径),需手动指定:
    ./configure --enable-http2 --with-nghttp2=/usr/local --enable-ssl --enable-so --with-mpm=event
    其中 /usr/local 替换为你的 nghttp2 安装前缀(如通过源码安装,通常为 /usr/local;用包管理器安装则一般无需指定)

注意:必须启用 --enable-ssl(因 HTTP/2 要求 TLS),且推荐使用 event MPM(prefork 不兼容 HTTP/2)。

Apache Tika Content Extraction Hub
Apache Tika Content Extraction Hub

通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。

下载

检查模块生成与加载配置

编译安装完成后:

  • 确认 modules/mod_http2.so 已生成(路径通常为 APACHE_HOME/modules/)
  • 检查 httpd.conf 中是否自动添加或需手动加入:
    LoadModule http2_module modules/mod_http2.so
  • 确保 SSL 模块已启用:LoadModule ssl_module modules/mod_ssl.so
  • 确认已加载 socache_shmcb_module(用于 TLS 会话缓存)

虚拟主机中启用 h2 协议并验证

仅编译支持还不够,还需在 HTTPS 虚拟主机中激活协议协商:

  • 在 块内添加:
    Protocols h2 http/1.1
  • 确保该虚拟主机已启用 SSLEngine on,且 TLS 版本 ≥ 1.2(推荐 SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1)
  • 重启 Apache:apachectl restart 或 systemctl restart httpd
  • 验证:curl -I --http2 https://yourdomain.com 应返回正常响应头;浏览器 DevTools Network 标签页中请求 Protocol 列显示 h2

若启动失败并报错 “Cannot load mod_http2.so: undefined symbol: nghttp2…”,说明 nghttp2 共享库未被运行时找到,需将 nghttp2 的 lib 目录(如 /usr/local/lib)加入 /etc/ld.so.conf.d/ 并执行 ldconfig。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

477

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

1020

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

3792

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

1236

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

1109

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

574

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

3516

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

6712

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

1007

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Apache Maven 官方安装指南
Apache Maven 官方安装指南

共0课时 | 0人学习

Apache Maven 官方用户中心
Apache Maven 官方用户中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习