HAProxy Version

haproxy/haproxy
- GPL-2.0 / LGPL-2.1, C, TCP/HTTP Load Balancer, Reverse Proxy
- Reliable, high performance TCP/HTTP reverse proxy and load balancer.
Release cadence
- 每年约 2 个 feature branch。
- 偶数 minor 是 LTS，维护约 5 年，适合生产长期使用。
- 奇数 minor 是 stable，维护约 12–18 个月，适合需要新功能且能快速升级/回滚的用户。
- 同一 branch 内应尽量使用最新 patch。
参考

version	date	latest	status / EOL	notes
HAProxy 3.4	2026-06-03	3.4.0	LTS, 2031-Q2	dynamic backends, QMux, ACME dns-persist-01, OpenTelemetry
HAProxy 3.3	2025-11-26	3.3.10	stable, 2027-Q1	QUIC backend, persistent stats, ACME, Kernel TLS, ECH
HAProxy 3.2	2025-05-28	3.2.19	LTS, 2030-Q2	ACME/SSL management, CPU scalability, QUIC performance
HAProxy 3.1	2024-11-26	3.1.17	unmaintained, 2026-Q1	troubleshooting, config reliability, SPOE, H2/QUIC
HAProxy 3.0	2024-05-29	3.0.23	LTS, 2029-Q2	crt-stores, persistent stats, JSON/CBOR logs, syslog LB
HAProxy 2.9	2023-12-05	2.9.15	unmaintained, 2025-Q1	reverse-http, log backends, zero-copy forwarding
HAProxy 2.8	2023-05-31	2.8.24	critical fixes, 2028-Q2	QUIC production-ready, Lua mailers, OCSP auto updates
HAProxy 2.7	2022-12-01	2.7.12	unmaintained, 2024-Q1	traffic shaping, QUIC, thread groups
HAProxy 2.6	2022-05-31	2.6.29	critical fixes, 2027-Q2	QUIC/HTTP3, OpenSSL 3.0
HAProxy 2.5	2021-11-23	2.5.14	unmaintained, 2023-Q1	dynamic servers, runtime CA/CRL, Lua httpclient
HAProxy 2.4	2021-05-14	2.4.35	unmaintained, 2026-Q2	TCP syslog/DNS, OpenTracing, dynamic SSL update
HAProxy 2.3	2020-11-05	2.3.21	unmaintained, 2022-Q1	syslog forwarding, stricter config checking

版本选择

新部署优先选最新 LTS：当前为 HAProxy 3.4；保守生产也可选成熟 LTS 3.2 / 3.0 / 2.8 / 2.6。
不建议新上 3.1/2.9/2.7/2.5 等已 unmaintained stable branch。
2.4/2.2 等旧 LTS 已到或接近 EOL，应规划迁移。
使用 QUIC/HTTP3、ACME、OpenTelemetry、dynamic backend 等新能力时，优先看 3.4+。
当前开发分支为 3.5-dev，预计进入下一个 stable cycle；生产不要使用 dev 分支。

HAProxy 3.4

LTS
Release: 2026-06-03
Latest: 3.4.0
Dynamic backends
- Runtime API 可动态 add backend、publish backend、unpublish backend、del backend。
- 配合 virtual map 可实现更完整的 reload-free backend lifecycle。
QMux
- 实验性支持 HTTP/3 / QUIC over TCP，适合 UDP 被阻断或数据中心内 TCP 更合适的场景。
ACME 增强
- dns-persist-01 challenge。
- DNS-01 readiness：challenge-ready、dns-delay、dns-timeout。
- ACME profile、IP SAN、EAB。
TLS
- dummy/self-signed certificate generation。
- TLS certificate compression。
- 更方便生成 TLS keylog 变量。
Performance / Reliability
- 更细 buffer tuning，小 buffer/大 buffer 按需使用。
- 自动 CPU binding 继续增强。
- HTTP/1 glitch detector、HTTP/2 error log 控制。
- reusable healthcheck section。
- random balancing 算法考虑近期 RPS，分布更均匀。
Observability
- 新增 OpenTelemetry filter。
- OpenTracing deprecated，计划 3.5 移除。
Breaking / Deprecated
- stats page 默认不再显示 HAProxy version；需要 stats show-version。
- compression-direction deprecated。

HAProxy 3.3

stable
Release: 2025-11-26
Latest: 3.3.10
TLS / Security
- ACME 支持增强。
- SNI、passphrase protected cert、Encrypted Client Hello。
- Kernel TLS + splicing。
- JWT/OAuth 相关增强。
Observability
- Persistent stats 继续增强，reload 后保留更多统计状态。
- trace 能力改进。
Performance
- random load balancing 成为默认算法，替代 roundrobin。
- 多处连接、buffer、scheduler、HTTP/2/3 性能优化。
Flexibility
- QUIC on backend / HTTP/3 backend 方向增强。
- 新 fetch methods、converters、Runtime API 能力。
Usability / Deprecated
- 更严格的配置检查：重复 frontend / backend / listen / defaults 名称会被拒绝。
- program section 行为收紧。

HAProxy 3.2

LTS
Release: 2025-05-28
Latest: 3.2.19
Performance
- Automatic CPU binding：cpu-policy、thread-groups 相关配置简化大核数机器调优。
- QUIC performance 改进。
- deadlock watchdog / thread dump 调整，排障更可靠。
TLS / ACME
- ACME protocol 内置能力增强。
- ssl-f-use 简化多证书 frontend 的引用。
Observability / Debug
- Prometheus exporter、Runtime API 增强。
- debug counters、show events、show quic、show sess、show ssl cert、show ssl sni、trace 改进。
Load balancing
- strict-maxconn。
- HTTP compression 增加最小文件大小控制。
- relaxed HTTP parsing。
适合
- 需要 5 年 LTS，又想要 ACME/SSL 管理和新 QUIC/调试能力的生产环境。

HAProxy 3.1

stable，已 unmaintained
新的 SPOE
提升 H2 / QUIC 性能
improved config reliability、finer error reporting、troubleshooting
https://www.haproxy.com/blog/announcing-haproxy-3-1

HAProxy 3.0

使用 guid 跟踪配置对象
dump stats-file
- reload 后不会丢失统计数据
日志支持 JSON 和 CBOR 格式
https://www.haproxy.com/blog/announcing-haproxy-3-0

HAProxy 2.9

性能优化：内存使用、线程锁、日志锁、连接池、Maps、缓存锁、QUIC 内存、Stick tables 锁
HTTP 内存使用优化
- zero-copy forwarding
- tune.disable-zero-copy-forwarding
json_query
- 转换 json 响应数据
L7 fetch
- req.cook_names
- res.cook_names
Load balancing syslog

log-forward graylog
  # Listen on Graylog ports
  bind :12201
  dgram-bind :12201
  log backend@mylog-rrb local0

backend mylog-rrb
  mode log
  balance roundrobin

  server log1 [email protected]:514
  server log2 [email protected]:514

https://www.haproxy.com/blog/announcing-haproxy-2-9

HAProxy 2.8

OCSP Stapling
- 以前 set ssl ocsp-response
- 现在内置支持 ocs-update on
- 全局配置参数
  - tune.ssl.ocsp-update.mindelay
  - tune.ssl.ocsp-update.maxdelay
- 新 Command
  - update ssl ocsp-response
  - show ssl ocsp-updates
HTTP 压缩后端 Request & Response

backend webservers
  balance roundrobin
  server web1 192.168.56.10:8080 check maxconn 30

  filter compression
  compression direction both
  compression offload
  compression algo-req gzip
  compression type-req application/json
  compression algo-res gzip
  compression type-res text/css text/html text/javascript text/plain

HTTP Forwarded Header
- 在 option forwarde 之上控制
- rfc7239_is_valid
- rfc7239_field
- rfc7239_n2nn
- rfc7239_n2np
HTTP Actions
Tuning HTTP/2 Performance
- tune.h2.be.initial-window-size
- tune.h2.be.max-concurrent-streams
- tune.h2.fe.initial-window-size
- tune.h2.fe.max-concurrent-streams
- tune.h2.initial-window-size
- tune.h2.max-concurrent-streams
Defaults for Listener Sharding
- tune.listener.default-shards
Default ALPN Values
- 默认 h2,http/1.1
- 配置了 QUIC 会增加 h3
Fetch Method
- bc_rtt, bc_rttver
集成 acme.sh
- add the deploy script for acme.sh in admin directory
- 支持直接颁发证书
Signing Algorithms for TLS
- ssl-default-bind-client-sigalgs
- ssl-default-bind-sigalgs
支持使用 WolfSSL 编译
Lua
- mailers - 之前为 C 现在为 Lua 模块
- New Event Framework in Lua
  - core.event_sub(), Server.event_sub()
- Queues in Lua - core.queue()
- Lua Functions for Server Information
- Timeout for Lua execution
- Disable the Default Resolvers Section for the HTTP Client
  - global httpclient.resolvers.disabled on

global
  lua-load /etc/haproxy/mailers.lua

defaults
  email-alert mailers smtp_servers
  email-alert from [email protected]
  email-alert to [email protected]
  email-alert level info

mailers smtp_servers
  mailer mailserver1 mailserver1.example.com:25

https://github.com/rnwood/smtp4dev
- Email 测试服务
https://www.haproxy.com/blog/announcing-haproxy-2-8

HAProxy 2.7

Traffic shaping
- 下载速度
  - filter bwlim-out
  - http-response set-bandwidth-limit
- 上传速度
  - filter bwlim-in
  - http-request set-bandwidth-limit
thread-group
- 之前最多 64 个线程 - thread-group 1 threads 64
- 现在可以 64*64=4096 个线程 - thread-group 64 threads 64
QUICv2

echo "reload" | sudo socat -t300 /run/haproxy-master.sock -

show startup-logs

HAProxy 2.6

HTTP/3 over QUIC
Generic hash load balancing algorithm
- balance hash pathq
支持 OpenSSL 3.0
Master CLI
- HAProxy worker processes
- socat /run/haproxy-master.sock -
http-request set-var, tcp-request content set-var 支持选项
- ifexists, ifnotexists, ifempty, ifnotempty, ifset, ifnotset, ifgt, iflt

# 显示所有配置
haproxy -dKhelp -q -c -f /dev/null
# 某个主题下的配置项
haproxy -dKacl -q -c -f /dev/null

frontend mysite
  # enables HTTP/3 over QUIC
  bind quic4@:443 ssl crt /etc/haproxy/certs/foo.com/cert.pem alpn h3
  # 支持 stateless reset packets https://tools.ietf.org/id/draft-ietf-quic-transport-29.html#name-stateless-reset
  #cluster-secret

Reload

global
  stats socket /var/run/haproxy/api.sock mode 660 level admin expose-fd listeners

HAProxy 2.5

QUIC, HTTP/3 - 实验支持
完整动态服务支持
- 2.4 动态服务不支持 check, track, slowstart, error-limit, ssl, observe
支持在 defaults 配置 tcp-request 和 http-request 规则
Lua
- 新增 httpclient - 可发起请求
Announcing HAProxy 2.5

# 特性检查
haproxy -cc 'feature(PROMEX)' || echo not supported

# runtime api shell
socat stdio tcp4-connect:127.0.0.1:9999

experimental-mode on

global
  nbthread 40

defaults frontend-defaults
  log global
  mode http
  option httplog
  option dontlognull
  timeout client  10m
  # 新增
  http-request redirect scheme https unless { ssl_fc }

frontend mysite from frontend-defaults
  mode http
  # 废弃 process 使用 thread
  # 新增 shards 参数 - 等同于多次 bind
  bind :80 thread 1-20 shards 2 name website
  bind :443 ssl crt /etc/haproxy/ssl/cert.pem
  default_backend webservers

HAProxy 2.4

变化非常大

协议
- HTTP2/WebSocket
  - rfc8441 HTTP CONNECT
- FIX - Financial Information eXchange
- MQTT
  - 包有效性校验
  - 基于客户端标识路由
负载均衡
- 支持 TCP DNS
- 熔断增强 - http_fail_cnt, http_fail_rate
SSL/TLS
- 动态 SSL 证书存储 - 不再需要重启
- 允许动态 SNI 链接复用 - sni req.hdr(host)
Observability
- 内置 OpenTracing
- Prometheus 增加指标
- 统计增加 SSL/TLS 模块相关 - stats show-modules
缓存
- 支持 Vary 头 - process-vary on
- 最大缓存条目控制 - max-secondary-entries 10
配置
- 支持预处理
  - .if <condition> ... .elif <condition> ... .else ... .endif
  - .diag, .notice, .warning, .alert
    - -dD 显示诊断信息
  - 条件
    - defined(<name>)
    - feature(<name>) - haproxy -vv
      - OT - OpenTracing
    - streq(<str1>,<str2>), strneq(<str1>,<str2>)
    - version_atleast(<ver>), version_before(<ver>)
- 默认路径 - default-path
- 默认命名 - default http-defaults from tcp-defaults
- 动态超时 - http-request set-timeout
- TCP 升级 HTTP - fe tcp, be http - tcp-request content switch-mode
- 匹配删除 HTTP 头 - http-request del-header X-Forwarded -m beg
- 新增实验模式 - 开启实验功能
  - 动态服务
    - 通过 runtime api 新增服务
  - 变量修改
Lua
- 多线程 - lua-load-per-thread
参考
- Announcing HAProxy 2.4

# runtime api
echo "help add" | socat /var/run/haproxy/api.sock -
echo "show state" | socat /var/run/haproxy/api.sock -

# 服务
echo "experimental-mode on; add server be_app/app4 192.168.1.22:80" | socat /var/run/haproxy/api.sock -
echo "experimental-mode on; del server be_app/app4" | socat /var/run/haproxy/api.sock -
# 变量
echo "experimental-mode on; get var proc.myapp_version" | socat /var/run/haproxy/api.sock -
echo "experimental-mode on; set var proc.myapp_version str(green)" | socat /var/run/haproxy/api.sock -
echo "experimental-mode on; get var proc.myapp_version" | socat /var/run/haproxy/api.sock -

HAProxy 2.3

链接增强 - 为支持 QUIC 和 UDP 做准备
- 完善 Linux keepalive - 支持 sysctl 修改参数
协议 - Syslog TCP/UDP
负载均衡
- balance uri path-only - 解决 HTTP1 和 HTTP2 地址不一样问题
SSL/TLS
- 允许静态 SNI 链接复用 - sni str(example.local)
Observability
- stats HTTP 2 信息 - stats show-modules
- 基于 SPOE 集成 OpenTracing
Lua 5.4
参考
- Announcing HAProxy 2.3

版本选择​

HAProxy 3.4​

HAProxy 3.3​

HAProxy 3.2​

HAProxy 3.1​

HAProxy 3.0​

HAProxy 2.9​

HAProxy 2.8​

HAProxy 2.7​

HAProxy 2.6​

HAProxy 2.5​

HAProxy 2.4​

HAProxy 2.3​

版本选择

HAProxy 3.4

HAProxy 3.3

HAProxy 3.2

HAProxy 3.1

HAProxy 3.0

HAProxy 2.9

HAProxy 2.8

HAProxy 2.7

HAProxy 2.6

HAProxy 2.5

HAProxy 2.4

HAProxy 2.3