树莓派2 Raspbian环境编译lighttpd1.4.59后无法通过HTTP/2传输

问题场景 #

• 设备环境：Raspberry Pi 2 硬件，运行稳定版 Raspbian 系统
• 部署情况：自行编译安装 lighttpd 1.4.59，按照版本发布说明的预期，该版本默认应支持 HTTP/2 功能
• 异常表现：实际测试中所有页面始终通过 HTTP/1.1 协议传输，访问 PHP 页面时收到的响应头始终为 HTTP/1.1 格式，未协商到预期的 h2 协议；浏览器开发者工具侧未显示 h2 协议标识。

执行lighttpd -V检查编译特性，输出内容如下：

pi@Raspi:~ $ lighttpd -V
lighttpd/1.4.59 - a light and fast webserver

Event Handlers:
        + select (generic)
        + poll (Unix)
        + epoll (Linux)
        - /dev/poll (Solaris)
        - eventports (Solaris)
        - kqueue (FreeBSD)
        - libev (generic)

Network handler:
        + linux-sendfile
        - freebsd-sendfile
        - darwin-sendfile
        - solaris-sendfilev
        + writev
        + write
        - mmap support

Features:
        + IPv6 support
        + zlib support
        - zstd support
        - bzip2 support
        - brotli support
        + crypt support
        - OpenSSL support
        - mbedTLS support
        - NSS crypto support
        - GnuTLS support
        - WolfSSL support
        - Nettle support
        + PCRE support
        - MySQL support
        - PgSQL support
        - DBI support
        - Kerberos support
        - LDAP support
        - PAM support
        - memcached support
        - FAM support
        - LUA support
        - xml support
        - SQLite support
        - GDBM support

核心原因定位 #

从编译特性输出就能直接定位两个根本问题：

1. 编译时未集成任何TLS加密后端
   输出中所有TLS相关功能（OpenSSL、mbedTLS、GnuTLS等）全部为未启用状态。lighttpd 1.4.59 的 HTTP/2 模块有强制编译依赖：检测不到可用的TLS加密库时，构建系统会直接跳过HTTP/2模块的编译流程，哪怕版本号符合发布说明的要求，HTTP/2功能也不会被内置。这也是浏览器永远无法协商到h2协议的最核心原因。

   注：主流浏览器仅支持通过 TLS ALPN 机制协商的 HTTP/2，几乎不支持明文场景下的 HTTP/2（h2c）连接，因此lighttpd从1.4.56版本开始，将TLS支持作为HTTP/2模块的编译前置依赖。

2. 测试场景不满足HTTP/2启用要求
   哪怕后续补上了HTTP/2模块的编译，当前测试全程走明文HTTP连接的场景，也无法触发HTTP/2协商——lighttpd默认不会在明文连接上启用HTTP/2，浏览器也完全不支持明文场景下的HTTP/2升级请求。

分步修复方案 #

• 第一步：安装编译前置依赖
  先在Raspbian系统中安装好lighttpd编译所需的基础依赖，包括OpenSSL开发库、zlib、PCRE：
  sudo apt install libssl-dev zlib1g-dev libpcre3-dev
• 第二步：重新配置编译参数，启用TLS和HTTP/2支持
  进入lighttpd 1.4.59源码目录，重新执行配置脚本，显式启用OpenSSL支持：
  ./configure --with-openssl --with-pcre --with-zlib
  配置脚本执行完成后，检查最终输出信息，确认明确标注 enable HTTP/2 support: yes 后，再执行编译安装：
  make && sudo make install
• 第三步：验证编译结果
  再次执行lighttpd -V命令，确认Features列表中：
  • OpenSSL support 标识为启用（前面带+号）
  • 列表中能查到HTTP/2 support为启用状态
• 第四步：调整lighttpd配置启用HTTPS和HTTP/2
  打开lighttpd主配置文件（默认路径/etc/lighttpd/lighttpd.conf），首先把mod_openssl、mod_h2模块加入加载列表：

  server.modules = (
    "mod_openssl",
    "mod_h2",
    # 保留原有配置里的其他模块
  )
  

  然后添加443端口的HTTPS监听配置，绑定证书路径、开启HTTP/2协商、配置ALPN协议优先级：

  $SERVER["socket"] == "0.0.0.0:443" {
    ssl.engine = "enable"
    # 替换为你的证书文件实际路径
    ssl.pemfile = "/etc/lighttpd/certs/your_site.pem"
    # 启用HTTP/2
    h2.on = "enable"
    # 配置ALPN协议顺序：优先h2，回退HTTP/1.1
    ssl.alpn = "h2,http/1.1"
  }
  

• 第五步：重载配置验证效果
  执行命令重载lighttpd服务使配置生效：
  sudo systemctl reload lighttpd
  之后通过HTTPS地址访问站点，打开浏览器开发者工具的网络面板，就能看到协议列显示为h2，即代表HTTP/2正常启用。

  提示：内网测试如果没有正式域名，可以先生成自签名证书配置，浏览器弹出安全提示不影响协议协商的验证。

内容的提问来源于stack exchange，提问作者TheUnexpected