HAProxy是否支持代理H3连接至H3服务器？配置报错求助

问题背景 #

我查到HAProxy支持监听H3连接并转发到HTTP/1.1或HTTP/2，但不确定它是否支持直接转发到HTTP/3。我使用了以下配置尝试实现后端H3转发：

backend my_quic_backend
        mode http
        balance roundrobin
        server quic-app quic-service.default.svc.cluster.local:443 ssl verify none proto h3 check

错误信息 #

配置无法正常加载，服务器返回如下告警：

[NOTICE]   (1) : haproxy version is 3.0.5-8e879a5
[NOTICE]   (1) : path to executable is /usr/local/sbin/haproxy
[ALERT]    (1) : config : [/etc/haproxy/haproxy.cfg:53] : 'server my_quic_backend/quic-app' : 'proto' :  unknown MUX protocol 'h3'.
[ALERT]    (1) : config : Error(s) found in configuration file : /etc/haproxy/haproxy.cfg
[ALERT]    (1) : config : Fatal errors found in configuration.

使用的HAProxy版本 #

HAProxy version 3.0.5-8e879a5 2024/09/19 - https://haproxy.org/
Status: long-term supported branch - will stop receiving fixes around Q2 2029.
Known bugs: http://www.haproxy.org/bugs/bugs-3.0.5.html
Running on: Linux 6.8.0-62-generic #65-Ubuntu SMP PREEMPT_DYNAMIC Mon May 19 17:15:03 UTC 2025 x86_64

解答 #

当前HAProxy 3.0.x版本不支持通过proto h3配置后端使用HTTP/3协议。

HAProxy对HTTP/3的支持目前仅局限于前端层面：即作为入口监听H3请求，然后将请求转换为HTTP/1.1或HTTP/2协议转发给后端，并不支持直接以HTTP/3协议与后端服务器通信。你配置中的proto h3属于无效参数，因为当前版本未定义该MUX协议类型，这就是报错的直接原因。

如果需要处理H3流量，正确的配置方式是在前端启用H3监听，再转发到HTTP/1.1或HTTP/2的后端，示例如下：

frontend h3_frontend
    bind :443 ssl crt /path/to/your/cert.pem alpn h2,h3
    mode http
    default_backend my_http_backend

backend my_http_backend
    mode http
    balance roundrobin
    server app-node app-service:80 check

若你的业务必须要求HAProxy以HTTP/3协议对接后端，当前版本无法满足该需求，需关注HAProxy后续版本的功能更新。

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