# HAProxy 3.4.4 中文文档

> HAProxy 3.4 入门、配置与管理三套完整手册的简体中文译本

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

<!-- Generated by scripts/generate-haproxy-docs.py from pinned upstream text. -->

**HAProxy** 是一款免费、快速、可靠的反向代理，适用于高可用、TCP 与 HTTP 负载均衡及应用流量管理。本组件收录三套 HAProxy 3.4 核心手册的完整中文译文，并将其重新编排为适合 OINK 阅读器的扁平阅读顺序。

## 选择手册 {#choose-a-manual}

- [入门指南](/zh/docs/haproxy/load-balancing/) — 用 9 个主题介绍负载均衡基础、HAProxy 架构、功能、容量规划、版本升级与周边生态。
- [配置手册](/zh/docs/haproxy/http-fundamentals/) — 用 12 章完整覆盖代理、ACL、样本提取、日志、过滤器及各类选项。
- [管理指南](/zh/docs/haproxy/prerequisites/) — 用 13 章讲解启动、重载、资源、日志、统计信息、运行时 CLI、故障排查与安全。
{.cards}

## 版本涵盖范围 {#edition-coverage}

| 手册 | 上游篇幅 | 本站编排 |
| --- | ---: | ---: |
| 入门指南 | 1,695 行 | 9 个扁平主题页 |
| 配置手册 | 33,148 行 | 12 个扁平章节页 |
| 管理指南 | 5,285 行 | 13 个扁平章节页 |

全部 34 个阅读页面均直接位于 HAProxy 组件根目录下。侧边栏使用三个不可点击的分组占位页分隔三套手册，不增加目录层级，也不占用前后翻页节点。

固定版本的完整源文件及其 SHA-256 校验和保存在 `sources/haproxy/` 下。[上游许可声明](/third_party/haproxy/LICENSE)与 [GPLv2 全文](/third_party/haproxy/GPL-2.0)随手册一并发布。本中文版本与英文原文逐页对应。

---

本节页面：

- [入门指南]()
- [负载均衡基础](/zh/docs/haproxy/load-balancing/): 数据包、网络、服务器、L4 和 L7 负载均衡基础
- [HAProxy 是什么及其实现原理](/zh/docs/haproxy/architecture/): HAProxy 的角色、边界、事件驱动架构及请求处理模型
- [基本功能](/zh/docs/haproxy/basic-features/): 代理、TLS、监控、高可用性、负载均衡、会话粘性、日志、统计信息
- [标准功能](/zh/docs/haproxy/standard-features/): 样本提取、映射、ACL、内容切换、粘性表、重写和服务器保护
- [高级功能](/zh/docs/haproxy/advanced-features/): 运行时管理、操作系统能力、Lua 脚本编写和实时跟踪
- [性能与容量规划](/zh/docs/haproxy/sizing/): 容量规划原则、性能量级和实用规则
- [发布、软件包与升级](/zh/docs/haproxy/releases-and-upgrades/): 稳定分支、发布源、版本标识、维护与升级
- [相关产品与替代方案](/zh/docs/haproxy/ecosystem/): HAProxy 与 Apache、NGINX、Varnish、LVS、Envoy 及其他负载均衡器的关系
- [文档与社区](/zh/docs/haproxy/resources/): 上游手册、源码位置、支持渠道、联系方式与许可证
- [配置手册]()
- [1. 快速 HTTP 提示](/zh/docs/haproxy/http-fundamentals/): HTTP 交易、请求、响应、头和协议术语
- [2. 配置 HAProxy](/zh/docs/haproxy/configuration-basics/): 文件语法、引号、变量、条件、时间与大小格式、地址及示例
- [3. 全局段](/zh/docs/haproxy/global/): 进程安全、性能调优、调试和 HTTP 客户端设置
- [4. 代理](/zh/docs/haproxy/proxies/): 默认设置、前端、后端、监听器、代理关键字及动作引用
- [5. 绑定与服务器选项](/zh/docs/haproxy/bind-and-server-options/): 监听器、服务器、默认服务器和 DNS 解析选项
- [6. 缓存](/zh/docs/haproxy/cache/): 缓存段和代理段中的缓存限制与配置
- [7. ACL 与样本提取](/zh/docs/haproxy/acls-and-samples/): ACL 匹配、条件、转换器、样本提取和预定义 ACL
- [8. 日志记录](/zh/docs/haproxy/configuration-logging/): 日志级别、格式、配置文件、时间戳、捕获、状态及示例
- [9. 支持的过滤器](/zh/docs/haproxy/filters/): 跟踪、压缩、SPOE、缓存、FastCGI、OpenTracing、以及带宽过滤器
- [10. FastCGI 应用程序](/zh/docs/haproxy/fastcgi/): FastCGI 应用配置、参数、示例及限制
- [11. 粘性表与对等节点](/zh/docs/haproxy/stick-tables-and-peers/): 粘性表存储与对等节点复制声明
- [12. 其他配置段](/zh/docs/haproxy/other-sections/): 跟踪、用户、邮件发送器、错误、环形缓冲区、证书、ACME、全局健康检查
- [管理指南]()
- [1. 先决条件](/zh/docs/haproxy/prerequisites/): 读者应具备 Unix 系统管理与故障排查知识
- [2. HAProxy 架构](/zh/docs/haproxy/management-architecture/): 进程、线程、事件循环、chroot、日志、时钟与 TCP 代理模型
- [3. 启动 HAProxy](/zh/docs/haproxy/starting/): 命令行语法、选项、配置加载及启动行为
- [4. 停止与重启 HAProxy](/zh/docs/haproxy/stopping-and-restarting/): 信号、软停止、重载和主从重启
- [5. 文件描述符限制](/zh/docs/haproxy/file-descriptors/): 描述限制、sizing、系统约束及故障排查
- [6. 内存管理](/zh/docs/haproxy/memory/): 内存分配、限制、内存池、缓冲区与进程容量规划
- [7. CPU 使用率](/zh/docs/haproxy/cpu/): 线程、CPU 亲和性、饱和度、profiling 及性能行为
- [8. 日志记录](/zh/docs/haproxy/management-logging/): Syslog 集成、启动日志、运行时日志及日志故障排查
- [9. 统计信息与监控](/zh/docs/haproxy/statistics-and-monitoring/): CSV 和类型化统计信息、运行时 CLI 命令、主 CLI 和统计文件
- [10. 简化配置管理](/zh/docs/haproxy/configuration-management/): 让大型 HAProxy 配置更易维护的方法
- [11. 应避免的常见陷阱](/zh/docs/haproxy/traps/): 应避免的运维失误与反直觉行为
- [12. 调试与性能问题](/zh/docs/haproxy/debugging-and-performance/): 排查崩溃、卡顿、延迟和吞吐量问题的方法
- [13. 安全注意事项](/zh/docs/haproxy/security/): 特权隔离、攻击面、Linux 能力及安全运行

---

反链：

- [归属声明](/zh/attribution/)
- [文档](/zh/docs/)