HAProxy / 数据面代理内核：从 Frontend 到 Seamless Reload
内容提要
本文介绍HAProxy数据面系列教程，涵盖请求路径、线程调度、HTX/ACL、后端负载均衡、Runtime API与无缝重载等14篇内容，旨在帮助工程师深入理解延迟与失败点，并对比Nginx、Envoy等选型，提供从配置到运维的完整机制路线图。
延伸解读
定位：与 Nginx、Envoy 的差异
本文明确 HAProxy 在数据面代理中的生态位：与 Nginx 的多进程文件驱动、Envoy 的 API 驱动 Filter/xDS 不同，HAProxy 以事件循环和共享内存为核心。理解这一差异有助于架构师在选型时根据自身对配置动态性、协议支持和运维模式的需求做出判断。
阅读路径建议
系列提供多条阅读路径：快速建立坐标系可选 1→2→4→8→12→13；深挖请求路径可选 3→4→5→6→7；动态运维可选 11→12→13；选型对照可选 1→13→14。读者可根据自身角色和目标选择路径，避免盲目通读。
关注延迟与失败点
系列核心在于帮助工程师定位延迟与失败点：从 frontend 的 accept 路径，到 stream/mux/HTX 的协议处理，再到 ACL 求值和 backend 负载均衡，每一层都可能成为瓶颈。理解这些层次有助于在性能调优和故障排查时快速定位问题。
动态运维的边界
Runtime API 与 seamless reload 是 HAProxy 动态运维的两大工具，但各有边界：Runtime API 可热改权重、上下线等，但某些配置必须 reload；seamless reload 通过 FD 交接实现不丢连接，但 stick-table 等状态保留有限。理解这些边界可避免运维中的误操作。
Q&A
HAProxy数据面系列教程主要覆盖哪些内容？
该系列教程覆盖HAProxy数据面的核心机制，包括线程调度、frontend bind/accept、Stream/mux/HTX、ACL求值、backend负载均衡、stick-table、健康检查、TLS路径、Runtime API、无缝重载（seamless reload）以及排障与选型，共14篇。
HAProxy中一次请求的延迟和失败点通常出现在哪些层？
延迟和失败点可能出现在多个层：线程调度、frontend accept、Stream/mux/HTX处理、ACL求值、backend负载均衡、健康检查、TLS握手等。具体可参考系列的第1-7篇和第13篇。
HAProxy的Runtime API和seamless reload有什么区别？
Runtime API允许在运行时热修改某些配置，如权重、上下线等，但并非所有配置都能热改；seamless reload则通过FD交接和旧进程排空实现不中断的重启，但会丢失部分运行时状态（如stick-table）。
HAProxy内部如何处理HTTP请求？HTX和mux的作用是什么？
HAProxy使用HTX作为版本无关的内部HTTP表示，分离解析与处理；mux负责处理不同协议（如HTTP/1、HTTP/2）的流。http-request改写等操作作用于HTX，而非原始缓冲。
HAProxy的多线程模式下，共享状态（如stick-table）如何管理？
HAProxy通过线程组和每线程事件循环管理并发，共享状态如stick-table需要跨线程同步，并支持peers复制和reload保留。具体细节可参考第2篇和第8篇。
HAProxy、Nginx和Envoy在数据面设计上有何主要区别？
HAProxy采用多线程事件驱动，Nginx是多进程文件驱动，Envoy是API驱动的Filter/xDS架构。三者各有优劣，选型需根据具体场景。
HAProxy无缝重载（seamless reload）是如何实现的？
无缝重载通过`-x`选项、`expose-fd` listeners和master-worker sockpair实现listen FD的交接，旧进程通过SIGUSR1 soft-stop排空连接，同时stick-table等状态通过peers保留。
HAProxy的ACL求值在请求处理中起什么作用？
ACL求值用于根据规则匹配请求，决定路由、限流等行为，与stick-table和健康检查耦合。匹配顺序和副作用需注意。
