haproxy

一、全局配置

 

“global”配置中的参数为进程级别的参数,且通常与其运行的OS相关。

 

* 进程管理及安全相关的参数

– chroot <jail dir>:修改haproxy的工作目录至指定的目录并在放弃权限之前执行chroot()操作,可以提升haproxy的安全级别,不过需要注意的是要确保指定的目录为空目录且任何用户均不能有写权限;

– daemon:让haproxy以守护进程的方式工作于后台,其等同于”-D”选项的功能,当然,也可以在命令行中以”-db”选项将其禁用;

– gid <number>:以指定的GID运行haproxy,建议使用专用于运行haproxy的GID,以免因权限问题带来风险;

– group <group name>:同gid,不过指定的组名;

– log <address> <facility> [max level [min level]]:定义全局的syslog服务器,最多可以定义两个;

– log-send-hostname [<string>]:在syslog信息的首部添加当前主机名,可以为”string”指定的名称,也可以缺省使用当前主机名;

– nbproc <number>:指定启动的haproxy进程的个数,只能用于守护进程模式的haproxy;默认只启动一个进程,鉴于调试困难等多方面的原因,一般只在单进程仅能打开少数文件描述符的场景中才使用多进程模式;

– pidfile:

– uid:以指定的UID身份运行haproxy进程;

– ulimit-n:设定每进程所能够打开的最大文件描述符数目,默认情况下其会自动进行计算,因此不推荐修改此选项;

– user:同uid,但使用的是用户名;

– stats:

– node:定义当前节点的名称,用于HA场景中多haproxy进程共享同一个IP地址时;

– description:当前实例的描述信息;

 

例如:

global 
 log 127.0.0.1 local2 
 chroot /var/lib/haproxy 
 pidfile /var/run/haproxy.pid 
 maxconn 4000 
 user haproxy 
 group haproxy 
 daemon 
 # turn on stats unix socket 
 stats socket /var/lib/haproxy/stats 
 打开日志(配置syslog): 
 # vim /etc/rsyslog.conf 
 local2.* /var/log/haproxy.log 
 # Provides UDP syslog reception 
 $ModLoad imudp 
 $UDPServerRun 514 
 # service rsyslog restart

 

* 性能调整相关的参数

– maxconn <number>:设定每个haproxy进程所接受的最大并发连接数,其等同于命令行选项”-n”;”ulimit -n”自动计算的结果正是参照此参数设定的;

– maxpipes <number>:haproxy使用pipe完成基于内核的tcp报文重组,此选项则用于设定每进程所允许使用的最大pipe个数;每个pipe会打开两个文件描述符,因此,”ulimit -n”自动计算时会根据需要调大此值;默认为maxconn/4,其通常会显得过大;

– noepoll:在Linux系统上禁用epoll机制;

– nokqueue:在BSD系统上禁用kqueue机制;

– nopoll:禁用poll机制;

– nosepoll:在Linux禁用启发式epoll机制;

– nosplice:禁止在Linux套接字上使用内核tcp重组,这会导致更多的recv/send系统调用;不过,在Linux 2.6.25-28系列的内核上,tcp重组功能有bug存在;

– spread-checks <0..50, in percent>:在haproxy后端有着众多服务器的场景中,在精确的时间间隔后统一对众服务器进行健康状况检查可能会带来意外问题;此选项用于将其检查的时间间隔长度上增加或减小一定的随机时长;

– tune.bufsize <number>:设定buffer的大小,同样的内存条件下,较小的值可以让haproxy有能力接受更多的并发连接,较大的值可以让某些应用程序使用较大的cookie信息;默认为16384,其可以在编译时修改,不过强烈建议使用默认值;

– tune.chksize <number>:设定检查缓冲区的大小,单位为字节;更大的值有助于在较大的页面中完成基于字符串或模式的文本查找,但也会占用更多的系统资源;不建议修改;

– tune.maxaccept <number>:设定haproxy进程内核调度运行时一次性可以接受的连接的个数,较大的值可以带来较大的吞吐率,默认在单进程模式下为100,多进程模式下为8,设定为-1可以禁止此限制;一般不建议修改;

– tune.maxpollevents <number>:设定一次系统调用可以处理的事件最大数,默认值取决于OS;其值小于200时可节约带宽,但会略微增大网络延迟,而大于200时会降低延迟,但会稍稍增加网络带宽的占用量;

– tune.maxrewrite <number>:设定为首部重写或追加而预留的缓冲空间,建议使用1024左右的大小;在需要使用更大的空间时,haproxy会自动增加其值; 
 – tune.rcvbuf.client <number>: 
 – tune.rcvbuf.server <number>:设定内核套接字中服务端或客户端接收缓冲的大小,单位为字节;强烈推荐使用默认值; 
 – tune.sndbuf.client: 
 – tune.sndbuf.server:

 

* Debug相关的参数

– debug

– quiet

 

二、代理

 

代理相关的配置可以如下配置段中。

 

– defaults <name> 
 – frontend <name> 
 – backend <name> 
 – listen <name>

 

“defaults”段用于为所有其它配置段提供默认参数,这配置默认配置参数可由下一个”defaults”所重新设定。

“frontend”段用于定义一系列监听的套接字,这些套接字可接受客户端请求并与之建立连接。

“backend”段用于定义一系列”后端”服务器,代理将会将对应客户端的请求转发至这些服务器。

“listen”段通过关联”前端”和”后端”定义了一个完整的代理,通常只对TCP流量有用。

所有代理的名称只能使用大写字母、小写字母、数字、-(中线)、_(下划线)、.(点号)和:(冒号)。此外,ACL名称会区分字母大小写。

 

三、队列调度

 

1、队列

 

1.1、roundrobin: 轮询,动态算法,每个后端主机最多支持4128个连接;

1.2、static-rr: 轮询,静态算法,每个后端主机支持的数量无上限;

1.3、leastconn: 根据后端主机的负载数量进行调度;仅适用长连接的会话;动态;

1.4、source:将请求的源地址进行hash运算,并由后端服务器的权重总数相除后派发至某匹配的服务器;

这可以使得同一个客户端IP的请求始终被派发至某特定的服务器;不过,当服务器权重总数发生变化时,如某服务器宕机或添加了新的服务器,许多客户端的请求可能会被派发至与此前请求不同的服务器;常用于负载均衡无cookie功能的基于TCP的协议;其默认为静态,不过也可以使用hash-type修改此特性;:

hash-type:

map-based:取模法;静态;

consistent:一致性哈希法;动态;可以动态变化

1.5、uri:对URI的左半部分(“问题”标记之前的部分)或整个URI进行hash运算,并由服务器的总权重相除后派发至某匹配的服务器;

这可以使得对同一个URI的请求总是被派发至某特定的服务器,除非服务器的权重总数发生了变化;此算法常用于代理缓存或反病毒代理以提高缓存的命中率;需要注意的是,此算法仅应用于HTTP后端服务器场景;其默认为静态算法,不过也可以使用hash-type修改此特性:

hash-type

map-based:取模法;静态;

consistent:一致性哈希法;动态;

1.6、url_param: 通过<argument>为URL指定的参数在每个HTTP GET请求中将会被检索;如果找到了指定的参数且其通过等于号”=”被赋予了一个值,那么此值将被执行hash运算并被服务器的总权重相除后派发至某匹配的服务器;根据url中的指定的参数的值进行调度;把值做hash计算,并除以总权重;多个参数,那个参数必须指明,适用客户端追踪(基于cookie 或者结余 param来追踪,实现会话绑定)

hash-type:

map-based:取模法;静态;

consistent:一致性哈希法;动态;可以动态变化

1.7、hdr(<name>) :根据请求报文中指定的header(如use_agent, referer, hostname)进行调度;把指定的header的值做hash计算;对于每个HTTP请求,通过<name>指定的HTTP首部将会被检索;如果相应的首部没有出现或其没有有效值,则使用轮叫算法对相应请求进行调度;其有一个可选选项”use_domain_only”,可在指定检索类似Host类的首部时仅计算域名部分(比如通过www.magedu.com来说,仅计算magedu字符串的hash值)以降低hash算法的运算量;此算法默认为静态的,不过其也可以使用hash-type修改此特性;

hash-type:

map-based:取模法;静态;

consistent:一致性哈希法;动态;可以动态变化

1.8、rdp-cookie

1.9、rdp-cookie(name):

 

直观说明source、uri、url_param、hdr(<name>): 
 protocol :// hostname[:port] / path / [;parameters][?query]#fragment 
 http://www.imailtone.com:80/WebApplication1/WebForm1.aspx;scale=false?name=tom&;age=20#resume 
 ftp://xngd_rw:xngd_zmj@172.16.31.124/6.x86_64/ 
 source:www.imailtone.com——>ip地址(做hash) 
 uri:——–> WebApplication1/WebForm1.aspx;scale=false做hash 
 url_param:——–> scale=false(做hash) 
 hdr(<name>) :根据请求报文中指定的header(如use_agent, referer, hostname)

2、hash-type

不管怎么做hash,对于是否支持动态可以用”hash-type”来指明

hash-type

格式:hash-type <method>

定义用于将hash码映射至后端服务器的方法;其不能用于frontend区段;可用方法有map-based和consistent,在大多数场景下推荐使用默认的map-based方法。

map-based:hash表是一个包含了所有在线服务器的静态数组。其hash值将会非常平滑,会将权重考虑在列,但其为静态方法,对在线服务器的权重进行调整将不会生效,这意味着其不支持慢速启动。此外,挑选服务器是根据其在数组中的位置进行的,因此,当一台服务器宕机或添加了一台新的服务器时,大多数连接将会被重新派发至一个与此前不同的服务器上,对于缓存服务器的工作场景来说,此方法不甚适用。

consistent:hash表是一个由各服务器填充而成的树状结构;基于hash键在hash树中查找相应的服务器时,最近的服务器将被选中。此方法是动态的,支持在运行时修改服务器权重,因此兼容慢速启动的特性。添加一个新的服务器时,仅会对一小部分请求产生影响,因此,尤其适用于后端服务器为cache的场景。不过,此算法不甚平滑,派发至各服务器的请求未必能达到理想的均衡效果,因此,可能需要不时的调整服务器的权重以获得更好的均衡性。

 

例子:

2.1、roundrobin 
 frontend main *:80 
 default_backend websrvs 
 #——————————————————————— 
 # round robin balancing between the various backends 
 #——————————————————————— 
 backend websrvs 
 balance roundrobin 
 server web1 172.16.100.68 check weight 1 
 server web2 172.16.100.69 check weight 3

 

2.2、uri

frontend main *:80 
  
 default_backend webservers 
 #——————————————————————— 
 # round robin balancing between the various backends 
 #——————————————————————— 
 backend webservers 
 balance uri 
 hash-type consistent 
 server web1 11.100.46.7:80 check 
 server web2 11.100.46.9:80 check 
 2.3、hdr(<name>) 
 frontend main *:80 
  
 default_backend webservers 
 #——————————————————————— 
 # round robin balancing between the various backends 
 #——————————————————————— 
  
 backend webservers 
 balance hdr(User-Agent) 
 hash-type consistent 
 server web1 11.100.46.7:80 check 
 server web2 11.100.46.9:80 check 
  
3、基于浏览器cookie实现session sticky: 
 backend websrvs 
 balance roundrobin 
 cookie SERVERID insert nocache indirect 
 server web1 172.16.100.68:80 check weight 1 cookie websrv1 
 server web2 172.16.100.69:80 check weight 3 cookie websrv2

 

要点:

(1) 每个server有自己惟一的cookie标识;

(2) 在backend中定义为用户请求调度完成后操纵其cookie,第一次随机之后seesion保持了

例如: 
 frontend main 
 bind :80,:443 
 bind 11.100.46.4:8080 
 default_backend webservers 
 #——————————————————————— 
 # round robin balancing between the various backends 
 #——————————————————————— 
 backend webservers 
 balance roundrobin 
 mode http 
 option httpchk OPTIONS * HTTP/1.1\r\nHost:\ 11.100.46.4 
 cookie SERVERID insert nocache indirect #cookie名字叫做SERVERID,server中 cookie webser2使用cookie 
 # option httpchk GET /index.html 
 server web1 11.100.46.7:80 check port 80 inter 2000 rise 1 fall 2 maxconn 3000 weight 1 cookie webser1 
 server web2 11.100.46.9:80 check port 80 inter 2000 rise 1 fall 2 maxconn 3000 weight 3 cookie webser2

四、后端server

server <name> <addr>[:port] [param*] 
 backup: 设定当前server为backup server; 
 check: 健康状态检测; 
 inter <delay>:检测时间间隔;单位为ms, 默认为2000; 
 fall: up –> down, soft state, soft state, hard state; 
 rise:down –> up, 
 cookie <value>: 
 maxconn: 此服务接受的并发连接的最大数量; 
 maxqueue: 请求队列的最大长度; 
 observe: 根据流量判断后端server的健康状态; 
 weight: 指定权重,默认为1,最大为256;0表示不被调度; 
 redir <prefix>: 重定向;所有发往此服务器的请求均以302响应; 
  
 后端http服务时的健康状态的检测方法: 
 option httpchk 
 option httpchk <uri> 
 option httpchk <method> <uri> 
 option httpchk <method> <uri> <version>:不能用于frontend段,例如: 
  
 frontend main 
 bind :80,:443 
 bind 11.100.46.4:8080 
 default_backend webservers 
  
 #——————————————————————— 
 # round robin balancing between the various backends 
 #——————————————————————— 
 backend webservers 
 balance roundrobin 
 mode http 
 option httpchk OPTIONS * HTTP/1.1\r\nHost:\ 11.100.46.4 
 # option httpchk GET /index.html 
 server web1 11.100.46.7:80 check port 80 inter 2000 rise 1 fall 2 maxconn 3000 weight 1 
 server web2 11.100.46.9:80 check port 80 inter 2000 rise 1 fall 2 maxconn 3000 weight 3 
五、 bind 
  
 bind [<address>]:<port_range> [, …] 
 bind [<address>]:<port_range> [, …] interface <interface>

 

此指令仅能用于frontend和listen区段,用于定义一个或几个监听的套接字。

 

<address>:可选选项,其可以为主机名、IPv4地址、IPv6地址或*;省略此选项、将其指定为*或0.0.0.0时,将监听当前系统的所有IPv4地址;

<port_range>:可以是一个特定的TCP端口,也可是一个端口范围(如5005-5010),代理服务器将通过指定的端口来接收客户端请求;需要注意的是,每组监听的套接字<address:port>在同一个实例上只能使用一次,而且小于1024的端口需要有特定权限的用户才能使用,这可能需要通过uid参数来定义;

<interface>:指定物理接口的名称,仅能在Linux系统上使用;其不能使用接口别名,而仅能使用物理接口名称,而且只有管理有权限指定绑定的物理接口;

例如:

frontend main 
 bind :80,:443 
 bind 11.100.46.4:8080

 

六、mode { tcp|http|health }

设定实例的运行模式或协议。当实现内容交换时,前端和后端必须工作于同一种模式(一般说来都是HTTP模式),否则将无法启动实例。

tcp:实例运行于纯TCP模式,在客户端和服务器端之间将建立一个全双工的连接,且不会对7层报文做任何类型的检查;此为默认模式,通常用于SSL、SSH、SMTP等应用;

http:实例运行于HTTP模式,客户端请求在转发至后端服务器之前将被深度分析,所有不与RFC格式兼容的请求都会被拒绝;

health:实例工作于health模式,其对入站请求仅响应”OK”信息并关闭连接,且不会记录任何日志信息;此模式将用于响应外部组件的健康状态检查请求;目前业讲,此模式已经废弃,因为tcp或http模式中的monitor关键字可完成类似功能;

HAProxy的工作模式;默认为tcp;

tcp, http, health


例如: 
 defaults 
 mode http #http 
 log global 
 option httplog #记录http详细日志 
 option logasap #不记录大小以及传输时间 
 option dontlognull 
 option http-server-close 
 option http-pretend-keepalive # 
 option forwardfor except 127.0.0.0/8 if-none 
 option redispatch 
 retries 3 
 timeout http-request 10s 
 timeout queue 1m 
 timeout connect 10s 
 timeout client 1m 
 timeout server 1m 
 timeout http-keep-alive 10s 
 timeout check 10s 
 maxconn 30000

 

七、log

1、log global 
 log <address> <facility> [<level> [<minlevel>]]

 

为每个实例启用事件和流量日志,因此可用于所有区段。每个实例最多可以指定两个log参数,不过,如果使用了”log global”且”global”段已经定了两个log参数时,多余了log参数将被忽略。

 

global:当前实例的日志系统参数同”global”段中的定义时,将使用此格式;每个实例仅能定义一次”log global”语句,且其没有任何额外参数;

<address>:定义日志发往的位置,其格式之一可以为<IPv4_address:PORT>,其中的port为UDP协议端口,默认为514;格式之二为Unix套接字文件路径,但需要留心chroot应用及用户的读写权限;

<facility>:可以为syslog系统的标准facility之一;

<level>:定义日志级别,即输出信息过滤器,默认为所有信息;指定级别时,所有等于或高于此级别的日志信息将会被发送;

 

例如:

global 
 log 127.0.0.1 local2 #定义日志 
 chroot /var/lib/haproxy 
 pidfile /var/run/haproxy.pid 
 maxconn 4000 
 user haproxy 
 group haproxy 
 daemon 
 # turn on stats unix socket 
 stats socket /var/lib/haproxy/stats 
  
 此时还需要在syslog服务上做一下配置: 
 打开日志(配置syslog): 
 # vim /etc/rsyslog.conf 
 local2.* /var/log/haproxy.log 
 # Provides UDP syslog reception 
 $ModLoad imudp 
 $UDPServerRun 514 
 # service rsyslog restart 
  
 2、capture request header 
 capture request header <name> len <length>

捕获并记录指定的请求首部最近一次出现时的第一个值,仅能用于”frontend”和”listen”区段。捕获的首部值使用花括号{}括起来后添加进日志中。如果需要捕获多个首部值,它们将以指定的次序出现在日志文件中,并以竖线”|”作为分隔符。不存在的首部记录为空字符串,最常需要捕获的首部包括在虚拟主机环境中使用的”Host”、上传请求首部中的”Content-length”、快速区别真实用户和网络机器人的”User-agent”,以及代理环境中记录真实请求来源的”X-Forward-For”。

<name>:要捕获的首部的名称,此名称不区分字符大小写,但建议与它们出现在首部中的格式相同,比如大写首字母。需要注意的是,记录在日志中的是首部对应的值,而非首部名称。

<length>:指定记录首部值时所记录的精确长度,超出的部分将会被忽略。

可以捕获的请求首部的个数没有限制,但每个捕获最多只能记录64个字符。为了保证同一个frontend中日志格式的统一性,首部捕获仅能在frontend中定义。

例如:

frontend main 
 bind :80,:443 
 bind 11.100.46.4:8080 
 default_backend webservers 
 capture request header Host len 20 
 capture request header Referer len 60 
 capture request header User-Agent len 60 
  
  
 3、capture response header 
 capture response header <name> len <length>

捕获并记录响应首部,其格式和要点同请求首部。

例如:

frontend main 
 bind :80,:443 
 bind 11.100.46.4:8080 
 default_backend webservers 
 capture request header User-Agent len 60 
 capture request header Host len 15 
 capture request header X-Forwarded-For len 15 
 capture request header Referer len 15 
 capture response header Content-length len 9 
 capture response header Location len 15

4、option httplog

option httplog [ clf ]

启用记录HTTP请求、会话状态和计时器的功能。

clf:使用CLF格式来代替HAProxy默认的HTTP格式,通常在使用仅支持CLF格式的特定日志分析器时才需要使用此格式。

默认情况下,日志输入格式非常简陋,因为其仅包括源地址、目标地址和实例名称,而”option httplog”参数将会使得日志格式变得丰富许多,其通常包括但不限于HTTP请求、连接计时器、会话状态、连接数、捕获的首部及cookie、”frontend”、”backend”及服务器名称,当然也包括源地址和端口号等

 

 

5、option logasap

no option logasap

启用或禁用提前将HTTP请求记入日志,不能用于”backend”区段。

默认情况下,HTTP请求是在请求结束时进行记录以便能将其整体传输时长和字节数记入日志,由此,传较大的对象时,其记入日志的时长可能会略有延迟。”option logasap”参数能够在服务器发送complete首部时即时记录日志,只不过,此时将不记录整体传输时长和字节数。此情形下,捕获”Content-Length”响应首部来记录传输的字节数是一个较好选择。下面是一个例子。

 

listen http_proxy 0.0.0.0:80 
 mode http 
 option httplog 
 option logasap 
 log 172.16.100.9 local2 
  
6、option forwardfor 
option forwardfor [ except <network> ] [ header <name> ] [ if-none ]

允许在发往服务器的请求首部中插入”X-Forwarded-For”首部。

<network>:可选参数,当指定时,源地址为匹配至此网络中的请求都禁用此功能。

<name>:可选参数,可使用一个自定义的首部,如”X-Client”来替代”X-Forwarded-For”。有些独特的web服务器的确需要用于一个独特的首部。

if-none:仅在此首部不存在时才将其添加至请求报文问道中。

HAProxy工作于反向代理模式,其发往服务器的请求中的客户端IP均为HAProxy主机的地址而非真正客户端的地址,这会使得服务器端的日志信息记录不了真正的请求来源,”X-Forwarded-For”首部则可用于解决此问题。HAProxy可以向每个发往服务器的请求上添加此首部,并以客户端IP为其value。

需要注意的是,HAProxy工作于隧道模式,其仅检查每一个连接的第一个请求,因此,仅第一个请求报文被附加此首部。如果想为每一个请求都附加此首部,请确保同时使用了”option httpclose”、”option forceclose”和”option http-server-close”几个option。

 

例如:

option forwardfor except 127.0.0.0/8 if-none 
 在后端apache中记录: 
 LogFormat “%{X-Forwarded-For}i %l %u %t \”%r\” %>s %b \”%{Referer}i\” \”%{User-Agent}i\”” combined

7、option dontlognull: 在一定的环境中,有部分会定期连接到各种系统,以确定他们是否仍然正常。它即可以是 另一台负载平衡器或者操作系统。默认情况下,即使简单的端口探测或扫描将产生日志。如果这些连接污染日志太多了,就有可能使期权”dontlognull”来指明 没有传输数据的连接将不被记录,通常对应于那些探针。注意错误仍然是 返回到客户端,并在统计中占。如果这不是什么 期望,选项 http-ignore-probes忽略探头可以用来代替。

 

 

下面是一个例子。

frontend www 
 mode http 
 option forwardfor except 127.0.0.1

 

日志例子:

global 
 log 127.0.0.1 local2 #启用日志 
  
 chroot /var/lib/haproxy 
 pidfile /var/run/haproxy.pid 
 maxconn 4000 
 user haproxy 
 group haproxy 
 daemon 
  
 # turn on stats unix socket 
 stats socket /var/lib/haproxy/stats 
  
defaults 
 mode http 
 log global 
 option httplog #记录http详细日志 
 option logasap #不记录大小以及传输时间 
 option dontlognull 
 option httpclose 
 option http-server-close 
 option forceclose 
 option http-pretend-keepalive # 
 option forwardfor except 127.0.0.0/8 if-none 
 option redispatch 
 retries 3 
 timeout http-request 10s 
 timeout queue 1m 
 timeout connect 10s 
 timeout client 1m 
 timeout server 1m 
 timeout http-keep-alive 10s 
 timeout check 10s 
 maxconn 30000

 

 

 

 

八、maxconn

maxconn <conns>

设定一个前端的最大并发连接数,因此,其不能用于backend区段。对于大型站点来说,可以尽可能提高此值以便让haproxy管理连接队列,从而避免无法应答用户请求。当然,此最大值不能超出”global”段中的定义。此外,需要留心的是,haproxy会为每个连接维持两个缓冲,每个缓冲的大小为8KB,再加上其它的数据,每个连接将大约占用17KB的RAM空间。这意味着经过适当优化后,有着1GB的可用RAM空间时将能维护40000-50000并发连接。

如果为<conns>指定了一个过大值,极端场景下,其最终占据的空间可能会超出当前主机的可用内存,这可能会带来意想不到的结果;因此,将其设定了一个可接受值方为明智决定。其默认为2000。

例如: 
 global 
 log 127.0.0.1 local2 
  
 chroot /var/lib/haproxy 
 pidfile /var/run/haproxy.pid 
 maxconn 4000 #前端(全局)最大连接数 
 user haproxy 
 group haproxy 
 daemon 
  
 # turn on stats unix socket 
 stats socket /var/lib/haproxy/stats 
frontend main 
 bind :80,:443 
 bind 11.100.46.4:8080 
 default_backend repo 
  
backend repo 
 balance hdr(User-Agent) 
 hash-type consistent 
 server repo 172.16.31.125 check port 80 inter 2000 rise 1 fall 2 maxconn 3000 #后端realserver最大连接数

九、default_backend

 

default_backend <backend>

 

在没有匹配的”use_backend”规则时为实例指定使用的默认后端,因此,其不可应用于backend区段。在”frontend”和”backend”之间进行内容交换时,通常使用”use-backend”定义其匹配规则;而没有被规则匹配到的请求将由此参数指定的后端接收。

<backend>:指定使用的后端的名称;

使用案例:

use_backend dynamic if url_dyn 
use_backend static if url_css url_img extension_img 
default_backend dynamic 
  
  
十、 stats 
listen statistics 
 bind 11.100.46.4:8008 
 stats enable 
 stats hide-version 
# stats scope . 
 stats uri /haproxyadmin?stats 
 stats realm Haproxy\ Statistics 
 stats auth xngdadmin:xngd 
 stats auth xngd:xngd 
 stats admin if TRUE

1、stats hide-version:启用统计报告并隐藏HAProxy版本报告,不能用于”frontend”区段。

2、stats realm:启用统计报告并高精认证领域,不能用于”frontend”区段。(认证文字)

3、stats scope:启用统计报告并限定报告的区段,不能用于”frontend”区段。当指定此语句时,统计报告将仅显示其列举出区段的报告信息,所有其它区段的信息将被隐藏。如果需要显示多个区段的统计报告,此语句可以定义多次。需要注意的是,区段名称检测仅仅是以字符串比较的方式进行,它不会真检测指定的区段是否真正存在。

4、stats auth:启用认证

5、stats admin:在指定的条件满足时启用统计报告页面的管理级别功能,它允许通过web接口启用或禁用服务器,不过,基于安全的角度考虑,统计报告页面应该尽可能为只读的。此外,如果启用了HAProxy的多进程模式,启用此管理级别将有可能导致异常行为。

 

十一、error

1、errorfile

errorfile <code> <file>

在用户请求不存在的页面时,返回一个页面文件给客户端而非由haproxy生成的错误代码;可用于所有段中。

 

<code>:指定对HTTP的哪些状态码返回指定的页面;这里可用的状态码有200、400、403、408、500、502、503和504;

<file>:指定用于响应的页面文件;

 

例如:

errorfile 400 /etc/haproxy/errorpages/400badreq.http 
 errorfile 403 /etc/haproxy/errorpages/403forbid.http 
 errorfile 503 /etc/haproxy/errorpages/503sorry.http 
  
 2、errorloc 和 errorloc302 
 errorloc <code> <url> 
 errorloc302 <code> <url>

请求错误时,返回一个HTTP重定向至某URL的信息;可用于所有配置段中。

<code>:指定对HTTP的哪些状态码返回指定的页面;这里可用的状态码有200、400、403、408、500、502、503和504;

<url>:Location首部中指定的页面位置的具体路径,可以是在当前服务器上的页面的相对路径,也可以使用绝对路径;需要注意的是,如果URI自身错误时产生某特定状态码信息的话,有可能会导致循环定向;

需要留意的是,这两个关键字都会返回302状态吗,这将使得客户端使用同样的HTTP方法获取指定的URL,对于非GET法的场景(如POST)来说会产生问题,因为返回客户的URL是不允许使用GET以外的其它方法的。如果的确有这种问题,可以使用errorloc303来返回303状态码给客户端。

 

3、errorloc303 
 errorloc303 <code> <url>

请求错误时,返回一个HTTP重定向至某URL的信息给客户端;可用于所有配置段中。

<code>:指定对HTTP的哪些状态码返回指定的页面;这里可用的状态码有400、403、408、500、502、503和504;

<url>:Location首部中指定的页面位置的具体路径,可以是在当前服务器上的页面的相对路径,也可以使用绝对路径;需要注意的是,如果URI自身错误时产生某特定状态码信息的话,有可能会导致循环定向;

例如:

backend webserver 
 server 172.16.100.6 172.16.100.6:80 check maxconn 3000 cookie srv01 
 server 172.16.100.7 172.16.100.7:80 check maxconn 3000 cookie srv02 
 errorloc 403 /etc/haproxy/errorpages/sorry.htm 
 errorloc 503 /etc/haproxy/errorpages/sorry.htm 
配置实例: 
 global 
 log 127.0.0.1 local2 
 chroot /var/lib/haproxy 
 pidfile /var/run/haproxy.pid 
 maxconn 4000 
 user haproxy 
 group haproxy 
 daemon 
 stats socket /var/lib/haproxy/stats 
 defaults 
 mode http 
 log global 
 option httplog #记录http详细日志 
 option logasap #不记录大小以及传输时间 
 option dontlognull 
 option httpclose 
 option http-server-close 
 option forceclose 
 option http-pretend-keepalive # 
 option forwardfor except 127.0.0.0/8 if-none 
 option redispatch 
 retries 3 
 timeout http-request 10s 
 timeout queue 1m 
 timeout connect 10s 
 timeout client 1m 
 timeout server 1m 
 timeout http-keep-alive 10s 
 timeout check 10s 
 maxconn 30000 
 frontend main 
 bind :80,:443 
 bind 11.100.46.4:8080 
 default_backend webservers 
 mode http 
 log global 
 option httpclose 
 option logasap 
 capture request header User-Agent len 60 
 capture request header Host len 15 
 capture request header X-Forwarded-For len 15 
 capture request header Referer len 15 
 capture response header Content-length len 9 
 capture response header Location len 15 
 frontend healthcheck 
 bind :8008 
 mode http 
 option httpclose 
 option forwardfor 
 default_backend webservers 
 option httpchk OPTIONS * HTTP/1.1\r\nHost:\ 11.100.46.4 
 listen statistics 
 bind 11.100.46.4:8009 
 stats enable 
 stats hide-version 
 stats uri /haproxyadmin?stats 
 stats realm Haproxy\ Statistics 
 stats auth xngdadmin:xngd 
 stats auth xngd:xngd 
 stats admin if TRUE 
 backend webservers 
 balance roundrobin 
 cookie SERVERID insert nocache indirect #不能用在frontend中 
 server web1 11.100.46.7:80 check port 80 inter 2000 rise 1 fall 2 maxconn 3000 weight 1 cookie webser1 
 server web2 11.100.46.9:80 check port 80 inter 2000 rise 1 fall 2 maxconn 3000 weight 3 cookie webser2