HAproxy指南之haproxy配置详解
HAProxy主要提供两个功能：http协议反向代理(不提供缓存功能)、基于tcp层的负载均衡(如https、mysql协议)。适用于需要会话保持或七层处理的且负载特别大的站点。可支持数以万计的并发连接。说到haproxy就不得不说与其相关的配置文件了，下面就让我们一起来了解haproxy配置语法。
一. haproxy配置文件详解
haproxy配置分为五部分，分别如下:
1 global: (全局配置主要用于设定义全局参数，属于进程级的配置，通常和操作系统配置有关)
2 default : (配置默认参数，这些参数可以被用到frontend，backend，Listen组件)
在此部分中设置的参数值，默认会自动引用到下面的frontend、backend、listen部分中，因引，某些参数属于公用的配置，只需要在defaults部分添加一次即可。而如果frontend、backend、listen部分也配置了与defaults部分一样的参数，Defaults部分参数对应的值自动被覆盖。
3 frontend：( 接收请求的前端虚拟节点，Frontend可以更加规则直接指定具体使用后端的backend)
frontend是在haproxy 1.3版本以后才引入的一个组件，同时引入的还有backend组件。通过引入这些组件，在很大程度上简化了haproxy配置文件的复杂性。forntend可以根据ACL规则直接指定要使用的后端backend。
4 backend : (后端服务集群的配置，真实服务器，一个Backend对应一个或者多个实体服务器)
在HAProxy1.3版本之前，HAProxy的所有配置选项都在这个部分中设置。为了保持兼容性，haproxy新的版本依然保留了listen组件配置试。两种配置方式任选一中。
5 Listen : (Fronted和backend的组合体) 比如haproxy实例状态监控部分配置
代理配置段:
Backend:后端服务器组的定义
Frontend:定义面向客户的监听的地址和端口,以及关联的后端的服务器组
Listen:组合的方式直接定义frontend及相关的backend
Defaults:默认的配置
关于haproxy时间格式配置说明
一些包含了值的参数表示时间，如超时时长。这些值一般以毫秒为单位，但也可以使用其它的时间单位后缀。
us: 微秒(microseconds)，即1/1000000秒；
ms: 毫秒(milliseconds)，即1/1000秒；
s: 秒(seconds)；
m: 分钟(minutes)；
h：小时(hours)；
d: 天(days)；
1.1 haproxy global部分配置说明
通常主要定义全局配置主要用于设定义全局参数，属于进程级的配置，通常和操作系统配置有关
global
log 127.0.0.1 local3 #定义haproxy日志输出设置
log 127.0.0.1 local1 notice
#log loghost local0 info #定义haproxy 日志级别
ulimit-n 82000 #设置每个进程的可用的最大文件描述符
maxconn 20480 #默认最大连接数
chroot /usr/local/haproxy #chroot运行路径
uid 99 #运行haproxy 用户 UID
gid 99 #运行haproxy 用户组gid
daemon #以后台形式运行harpoxy
nbproc 1 #设置进程数量
pidfile /usr/local/haproxy/run/haproxy.pid #haproxy 进程PID文件
#debug #haproxy调试级别，建议只在开启单进程的时候调试
#quiet
log：全局的日志配置，local0是日志输出设置，info表示日志级别（err，waning，info，debug）；
maxconn：设定每个HAProxy进程可接受的最大并发连接数，此选项等同于linux命令选项”ulimit -n”
chroot ：修改haproxy的工作目录至指定的目录并在放弃权限之前执行chroot()操作,可以提升haproxy的安全级别，不过需要注意的是要确保指定的目录为空目录且任何用户均不能有写权限；
daemon：让haproxy以守护进程的方式工作于后台，其等同于“-D”选项的功能，当然，也可以在命令行中以“-db”选项将其禁用；
nbproc ：指定启动的haproxy进程个数，只能用于守护进程模式的haproxy；默认只启动一个进程，鉴于调试困难等多方面的原因，一般只在单进程仅能打开少数文件描述符的场景中才使用多进程模式；
pidfile：将haproxy的进程写入pid文件。
ulimit-n：设定每进程所能够打开的最大文件描述符数目，默认情况下其会自动进行计算，因此不推荐修改此选项。
stats socket 如要设置haproxy的日志内容，可参考以下配置 capture request header Host len 40 1.2 haproxy global部分配置说明 用于设置配置默认参数，这些参数可以被用到frontend，backend，Listen组件； 此部分中设置的参数值，默认会自动引用到下面的frontend、backend、listen部分中，因引，某些参数属于公用的配置，只需要在 defaults部分添加一次即可。而如果frontend、backend、listen部分也配置了与defaults部分一样的参 数，Defaults部分参数对应的值自动被覆盖 defaults #《---上述选项意思是指serverID 对应的服务器挂掉后，强制定向到其他健康的服务器, 当使用了 cookie时， mode http 设置haproxy的运行模式，有三种｛http|tcp|health｝。注意：如果haproxy中还要使用4层的应用（mode tcp）的话，不建议在此定义haproxy的运行模式。 设置HAProxy实例默认的运行模式有tcp、http、health三种可选： tcp模式：在此模式下，客户端和服务器端之前将建立一个全双工的连接，不会对七层报文做任何检查，默认为tcp模式，经常用于SSL、SSH、SMTP等应用。 log global 设置日志继承全局配置段的设置。 option httplog 表示开始打开记录http请求的日志功能。 option dontlognull 如果产生了一个空连接，那这个空连接的日志将不会记录。 option http-server-close 打开http协议中服务器端关闭功能，使得支持长连接，使得会话可以被重用，使得每一个日志记录都会被记录。 option forwardfor except 127.0.0.0/8 如果上游服务器上的应用程序想记录客户端的真实IP地址，haproxy会把客户端的IP信息发送给上游服务器，在HTTP请求中添加”X-Forwarded-For”字段,但当是haproxy自身的健康检测机制去访问上游服务器时是不应该把这样的访问日志记录到日志中的，所以用except来排除127.0.0.0，即haproxy身。 option redispatch 当与上游服务器的会话失败(服务器故障或其他原因)时，把会话重新分发到其他健康的服务器上,当原来故障的服务器恢复时，会话又被定向到已恢复的服务器上。还可以用”retries”关键字来设定在判定会话失败时的尝试连接的次数。 retries 3 向上游服务器尝试连接的最大次数，超过此值就认为后端服务器不可用。 option abortonclose 当haproxy负载很高时，自动结束掉当前队列处理比较久的链接。 timout http-request 10s 客户端发送http请求的超时时间。 timeout queue 1m 当上游服务器在高负载响应haproxy时，会把haproxy发送来的请求放进一个队列中，timeout queue定义放入这个队列的超时时间。 timeout connect 5s haproxy与后端服务器连接超时时间，如果在同一个局域网可设置较小的时间。 timeout client 1m 定义客户端与haproxy连接后，数据传输完毕，不再有数据传输，即非活动连接的超时时间。 timeout server 1m 定义haproxy与上游服务器非活动连接的超时时间。 timeout http-keep-alive 10s 设置新的http请求连接建立的最大超时时间，时间较短时可以尽快释放出资源，节约资源。 timeout check 10s 健康检测的时间的最大超时时间。 maxconn 3000 最大并发连接数。 contimeout 5000 设置成功连接到一台服务器的最长等待时间，默认单位是毫秒，新版本的haproxy使用timeout connect替代，该参数向后兼容。 clitimeout 3000 设置连接客户端发送数据时的成功连接最长等待时间，默认单位是毫秒，新版本haproxy使用timeout client替代。该参数向后兼容。 srvtimeout 3000 设置服务器端回应客户度数据发送的最长等待时间，默认单位是毫秒，新版本haproxy使用timeout server替代。该参数向后兼容。 balance roundrobin 设置负载算法为：轮询算法rr balance :用来定义负载均衡算法 1.roundrobin：基于权重进行的轮叫算法，在服务器的性能分布经较均匀时这是一种最公平的，最合量的算法。 8.rdp-cookie(name)：示根据据cookie(name)来锁定并哈希每一次TCP请求。 1.3 haproxy frontend 部分配置说明 frontend是在haproxy 1.3版本以后才引入的一个组件，同时引入的还有backend组件。通过引入这些组件，在很大程度上简化了haproxy配置文件的复杂性。frontend根据任意 HTTP请求头内容做ACL规则匹配,然后把请求定向到相关的backend frontend http_80_in HttpHeader中获得客户端IP frontend http_80_in 定义一个名为http_80_in的frontend。 bind 0.0.0.0:80 定义haproxy前端部分监听的端口。 mode http 定义为http模式。 log global 继承global中log的定义。 option forwardfor 使后端server获取到客户端的真实IP。 1.4 haproxy backend 部分配置说明 用来定义后端服务集群的配置，真实服务器，一个Backend对应一个或者多个实体服务器 backend wwwpool #定义wwwpool服务器组。 cookie：表示充许向cookie插入SERVERID,每台服务器的SERVERID可以下面的server关键字中使用cookie关键字定义。 option httpchk用法： option httpchk server:用来定义多台后端真实服务器,不能用于defaults和frontend部分,格式为:server name address:port param* name：为后端真实服务器指定一个内部名称，随便这下义一个即可。 maxconn：设定每个backend中server进程可接受的最大并发连接数，此选项等同于linux命令选项”ulimit -n” backup：设置后端真实服务器的备份服器，仅仅在后端所有真实服务器均不可用的情况下才启用。 1.5 haproxy listen 部分配置说明 常常用于状态页面监控，以及后端server检查，是Fronted和backend的组合体 如下为haproxy访问状态监控页面配置 listen admin_status #Frontend和Backend的组合体,监控组的名称，按需自定义名称 总结:代理配置段主要有以下几部分配置块:1. Frontend:定义面向客户的监听的地址和端口,以及关联的后端的服务器组 ；2. Backend:后端服务器组的定义；3. Listen:组合的方式直接定义frontend及相关的backend;4. Defaults:默认的配置。其中listen配置块可以直接使用frontend和backend中任意一项参数配置， 比如acl语法配置以及server语法配置参数。 上一小节的从haproxy的配置文件我们知道haproxy相关参数基本介绍，但是在实际生产环境中，往往需要根据相关规则做请求匹配跳转，这时就需要用到Frontend；Backend这两个配置段，再结合Frontend的acl匹配规则来做相应的客户端请求跳转；另外，可能还会遇到客户端访问出错，这时就需要利用错误重定向功能，将其定义到相关友情提示的错误页面上，这样更加人性化。 一. Frontend匹配规则ACL用法详解 haproxy ACL具有很强大的功能，能够定义三到七层的规则。ACL的作用，就是为了匹配一些特别的请求，然后对其进行修改或者分发到不同的服务器组中 ①haproxy acl定义 格式： acl [flags]：目前haproxy的acl支持的标志位有3个： -i：不区分中模式字符的大小写； -f：从指定的文件中加载模式； --：标志符的强制结束标记，在模式中的字符串像标记符时使用； 整数或整数范围：如1024:65535表示从1024至65535；仅支持使用正整数(如果出现类似小数的标识，其为通常为版本测试)，且支持使用的操作符有5个，分别为eq、ge、gt、le和lt； 字符串：支持使用“-i”以忽略字符大小写，支持使用“\”进行转义；如果在模式首部出现了-i，可以在其之前使用“–”标志位； 正则表达式：其机制类同字符串匹配； IP地址及网络地址； 注意:同一个acl中可以指定多个测试条件，这些测试条件需要由逻辑操作符指定其关系。条件间的组合测试关系有三种：“与”(默认即为与操作)、“或”(使用“||”操作符)以及“非”(使用“!”操作符)。 常用的测试标准(criteria) (1) 基于七层协议（http）规则acl测试标准 method 例如： 利用method来实现前段读写分离： acl read method GET 用于测试请求的URL是否以指定的模式开头;下面的例子用于测试URL是否以 /static、/images、/javascript或/stylesheets头。 例如：利用path_beg实现以/static /images开头的请求转交到 static server上： acl url_static path_beg -i /static /images 用于测试请求的URL是否以 例如：利用path_end实现以.jpg .gif .png .css等结尾的格式的请求转交到 static server上： acl url_static path_end -i .jpg .gif .png .css .js .html 用于测试请求报文的指定首部的开头部分是否符合 acl is_lvs3 hdr_beg(host) -i lvs3.test.net:8080 #表示当request header中的host前缀部分匹配到lvs.test.net.:8080则将请求转给后端backend定义的 is_lvs3上 用于测试请求报文的指定首部的结尾部分是否符合 acl is_lvs3 hdr_end(host) -i lvs3.test.net:8080 #表示当request header中的host后缀部分匹配到lvs3.test.net.:8080则将请求转给后端backend定义的 is_lvs2上 用于测试请求报文中的所有首部或指定首部信息是否满足指定的条件；指定首部时， 其名称不区分大小写， 且在括号中“（）”不能有任何多余的空白字符。测试服务器端的响应报文时可以使用shdr()。 例如 当用户访问172.16.1.100时，重定向到http://www.afwing.com acl dstipaddr hdr(Host) 172.16.1.100 (2) 基于四层协议（ip）规则acl测试标准 定义访问地址为目标地址或目标端口的acl规则 定义访问地址为源地址或源端口的acl规则 例如： 允许10.0.0.0/24的用户访问，其他用户将禁止 acl net10 src 10.0.0.0/24 ②haproxy acl引用 当定义好了ACL后我们可以利用“use_backend” 参数来引用acl规则，如果需要引用多个acl时，只需要依次在后面添加相关acl ，也可以 匹配多个acl，如下示例： 1.正常写法： use_backend static if url_static 2.或者写法： use_backend backend1 if aclA || aclB 注意上面“||”也可以使用or来表示 3.非（不符合）写法： use_backend backend1 if aclA !aclB 4.与（and）写法： use_backend backend1 if aclA !aclB haproxy 常见应用实例: frontend webservs 二. haproxy 错误重定向用法 格式为: errorfile 错误代码code 错误代码文件路径 如下为常用的优化客户端访问出现错误时错误提示页面示例 errorfile 403 /etc/haproxy/errorfiles/403.http 至此，以上关于haproxy的配置文件相关参数就介绍到这里了，这些都是基本参数，如要更详细的配置介绍，请访问haproxy官方文档说明：https://cbonte.github.io/haproxy-dconv/configuration-1.5.html
capture request header Content-Length len 10
capture request header Referer len 200
capture response header Server len 40
capture response header Content-Length len 10
capture response header Cache-Control len 8 log global #引入global定义的日志格式
mode http #所处理的类别(7层代理http，4层代理tcp)
maxconn 50000 #最大连接数
option httplog #日志类别为http日志格式
option httpclose #每次请求完毕后主动关闭http通道
option dontlognull #不记录健康检查日志信息
option forwardfor #如果后端服务器需要获得客户端的真实ip，需要配置的参数，
可以从http header 中获取客户端的IP
retries 3 #3次连接失败就认为服务器不可用，也可以通过后面设置
option redispatch
haproxy将会将其请求的后端服务器的serverID插入到cookie中，以保证会话的SESSION持久性；而此时，如果
后端的服务器宕掉了,但是客户端的cookie是不会刷新的，如果设置此参数，将会将客户的请求强制定向到另外一个
后端server上，以保证服务的正常---》 stats refresh 30 #设置统计页面刷新时间间隔
option abortonclose #当服务器负载很高的时候，自动结束掉当前队列处理比较久的连接
balance roundrobin #设置默认负载均衡方式，轮询方式
#balance source #设置默认负载均衡方式，类似于nginx的ip_hash
#contimeout 5000 #设置连接超时时间
#clitimeout 50000 #设置客户端超时时间
#srvtimeout 50000 #设置服务器超时时间
timeout http-request 10s #默认http请求超时时间
timeout queue 1m #默认队列超时时间
timeout connect 10s #默认连接超时时间
timeout client 1m #默认客户端超时时间
timeout server 1m #默认服务器超时时间
timeout http-keep-alive 10s #默认持久连接超时时间
timeout check 10s #设置心跳检查超时时间
http模式：在此模式下，客户端请求在转发至后端服务器之前将会被深度分板，所有不与RFC格式兼容的请求都会被拒绝。
health：已基本不用了。
2.static-rr：也是基于权重时行轮叫的算法，不过此算法为静态方法，在运行时调整其服务权重不会生效。
3.source：是基于请求源IP的算法，此算法对请求的源IP时行hash运算，然后将结果与后端服务器的权理总数相除后转发至某台匹配的后端服务器，这种方法可以使用一个客户端IP的请求始终转发到特定的后端服务器。
4.leastconn：此算法会将新的连接请求转发到具有最少连接数目的后端服务器。在会话时间较长的场景中推荐使用此算法。例如数据库负载均衡等。此算法不适合会话较短的环境，如基于http的应用。
5.uri：此算法会对部分或整个URI进行hash运算，再经过与服务器的总权重要除，最后转发到某台匹配的后端服务器上。
6.uri_param：此算法会椐据URL路径中的参数时行转发，这样可以保证在后端真实服务器数量不变时，同一个用户的请求始终分发到同一台机器上。
7.hdr：此算法根据httpd头时行转发，如果指定的httpd头名称不存在，则使用roundrobin算法进行策略转发。bind 0.0.0.0:80 #设置监听端口，即haproxy提供的web服务端口，和lvs的vip 类似
mode http #http 的7层模式
log global #应用全局的日志设置
option httplog #启用http的log
option httpclose #每次请求完毕后主动关闭http通道，HAproxy不支持keep-alive模式
option forwardfor #如果后端服务器需要获得客户端的真实IP需要配置此参数，将可以从
default_backend wwwpool #设置请求默认转发的后端服务池，
mode http #http的7层模式
option redispatch
option abortonclose
balance source #负载均衡的方式，源哈希算法
cookie SERVERID #允许插入serverid到cookie中，serverid后面可以定义
option httpchk GET /test.html #心跳检测
server web1 10.1.1.2:80 cookie 2 weight 3 check inter 2000 rise 2 fall 3 maxconn 8
option httpchk：此选项表示启用HTTP的服务状态检测功能。 HAProxy作为一个专业的负载均衡器，并且它支持对backend部分指定的后端服务节点的 健康检查，以保证在后端的backend中某个节点不能服务时，把从frontend端进来的客户端请求分配至backend中其他健康节点上，从而保证 整体服务的可用性。
method：表示HTTP请求的方式，常用的有OPTIONS、GET、HEAD几种方式。
一般健康检查可以采用HEAD方式进行，而不是采用GET方式，这是因为HEAD方式没有数据返回，仅检查Response的HEAD是不是状态码200。因此，相对于GET，HEAD方式更快，更简单。
uri：表示要检测的URL地址，通过执行此URL，可以获取后端服务器的运行状态，在正常情况下返回状态码200，返回其他状态码均为异常状态。
version：指定心跳检测时的HTTP的版本号。
address：后端真实服务器的iP地址或主机名。
port：指定连接请求发往真实服务器时的目标端口，在未设定时，将使用客户端请求时的同一端口。
param*：为后端服务器设定的一系列参数，可用参数非常多，
check：表示启用对此后端服务器执行健康检查。
inter：设置健康状态检查的时间间隔，单位为毫秒。
rise：设置人故障状态转换至正常状态需要成功检查的次数，如 rise 2：表示2次检查正确就认为此服务器可用。
fall：设置后端服务器从正常状态转换为不可用状态需要检查的次数，如 fall 3表示3 次检查失败就认为此服务器不可用。
cookie：为指定的后端服务器设定cookie值，此外指定的值将在请求入站时被检查，第一次为此值挑选的后端服务器将在后续的请求中一直被选中，其目的在于实现持久连接的功能。
cookie server1：表示web1的serverid为server1。
weigth：设置后端真实服务器的权重，默认为1，最大值为256，设置为0表示不参与负载均衡。 bind 0.0.0.0:8888 #监听端口
mode http #http的7层模式
log 127.0.0.1 local3 err #错误日志记录
stats refresh 5s #每隔5秒自动刷新监控页面
stats uri /admin?stats #监控页面的url访问路径
stats realm itnihao\ welcome #监控页面的提示信息
stats auth admin:admin #监控页面的用户和密码admin,可以设置多个用户名
stats auth admin1:admin1 #监控页面的用户和密码admin1
stats hide-version #隐藏统计页面上的HAproxy版本信息
stats admin if TRUE #手工启用/禁用,后端服务器(haproxy-1.4.9以后版本)
acl read method HEAD
acl write method PUT
acl write method POST
use_backend imgservers if read
use_backend uploadservers if write
use_backend static if url_static
use_backend static if url_static
use_backend lvs3 if is_lvs3
use_backend lvs3 if is_lvs2
redirect location http://www.afwing.com if dstipaddr
tcp-request content accept if net10
tcp-request content reject
tcp-request content accept [ {if | unless} ]
Accept a connection if/unless a content inspection condition is matched
use_backend backend1 if aclA || !aclC
use_backend backend1 if aclA !aclB !aclC
use_backend backend1 if aclA !aclB !aclC
bind *:80
acl url_static path_beg -i /static /images /javascript /stylesheets
acl url_static path_end -i .jpg .gif .png .css .js .html
acl url_php path_end -i .php
use_backend static if url_static or host_static
use_backend dynamic if url_php
default_backend dynamic
backend static
balance roundrobin
server node1 192.168.1.111:80 check maxconn 3000
backend dynamic
balance roundrobin
server node2 192.168.1.112:80 check maxconn 1000
errorfile 500 /etc/haproxy/errorfiles/500.http
errorfile 502 /etc/haproxy/errorfiles/502.http
errorfile 503 /etc/haproxy/errorfiles/503.http
errorfile 504 /etc/haproxy/errorfiles/504.http