HAProxy基础配置详解

官方文档地址：http://cbonte.github.io/haproxy-dconv/

HAProxy 的配置文件haproxy.cfg由两大部分组成，分别是global和proxies部分

• global：全局配置段
• proxies：代理配置段

global配置

global块：进程及安全配置相关的参数、性能调整相关参数、Debug参数。

锁定运行目录

chroot /apps/haproxy

以守护进程运行

deamon

socket文件

stats socket /var/lib/haproxy/haproxy.sock mode 600 level admin process 1

运行haproxy的用户身份

user haproxy
group haproxy

开启的haproxy worker 进程数，默认进程数是一个(2.5版本后不再使用)

nbproc 1

每个haproxy进程开启的线程数，默认为每个进程一个线程

nbthread 1

绑定haproxy worker 进程至指定CPU，将第1个work进程绑定至0号CPU

cpu-map 1 0

绑定haproxy worker 进程至指定CPU，将第2个work进程绑定至1号CPU

cpu-map 2 1

每个haproxy进程的最大并发连接数

maxconn 100000

每个haproxy进程ssl最大连接数,用于haproxy配置了证书的场景下

maxsslconn n

每个进程每秒创建的最大连接数量

maxconnrate n

后端server状态check随机提前或延迟百分比时间，建议2-5(20%-50%)之间，默认值0

spread-checks 2

指定pid文件路径

pidfile

定义全局的syslog服务器；日志服务器需要开启UDP协议，最多可以定义两个

log 127.0.0.1 local7 info

HAProxy日志配置

HAproxy本身不记录客户端的访问日志，此外为减少服务器负载，一般生产中HAProxy不记录日志。也可以配置HAProxy利用rsyslog服务记录日志到指定日志文件中。

在global配置项中定义

log 127.0.0.1 local5 info

开启日志功能

listen web_port
  ...
  log global
  ...

编辑 /etc/rsyslog.conf

$ModLoad imudp
$UDPServerRun 514

local5.* /var/log/haproxy.log

重启服务

systemctl restart rsyslog
systemctl restart haproxy

查看日志记录

tail -f /var/log/haproxy.log

Proxies配置

• defaults [] #默认配置项，针对以下的frontend、backend和listen生效，可以多个name也可以没有name
• frontend #前端servername，类似于Nginx的一个虚拟主机 server和LVS服务集群。
• backend #后端服务器组，等于nginx的upstream和LVS中的RS服务器。
• listen #将frontend和backend合并在一起配置，相对于frontend和backend配置更简洁，生产常用。

注意：name字段只能使用大小写字母，数字，‘-’(dash)，’_‘(underscore)，’.’ (dot)和 ‘:'(colon)，并且严格区分大小写

defaults 配置参数

当server Id对应的服务器挂掉后，强制定向到其他健康的服务器，重新派发
option redispatch

当服务器负载很高时，自动结束掉当前队列处理比较久的连接，针对业务情况选择开启
option abortonclose

开启与客户端的会话保持
option http-keep-alive

透传客户端真实IP至后端web服务器
option forwardfor

设置默认工作类型,使用TCP服务器性能更好，减少压力
mode http|tcp

session 会话保持超时时间，此时间段内会转发到相同的后端服务器
timeout http-keep-alive 120s

客户端请求从haproxy到后端server最长连接等待时间(TCP连接之前)，默认单位ms
timeout connect 120s

客户端请求从haproxy到后端服务端的请求处理超时时长(TCP连接之后)，默认单位ms，如果超时，会出现502错误，此值建议设置较大些，访止502错误。
timeout server 600s

设置haproxy与客户端的最长非活动时间，默认单位ms，建议和timeout server相同
timeout client 600s

对后端服务器的默认检测超时时间
timeout check 5s

指定后端服务器的默认设置
default-server inter 1000 weight 3

listen 简化配置

使用listen替换 frontend和backend的配置方式，可以简化设置，通常只用于TCP协议的应用。

如果需要绑定在非本机的IP，需要开启内核参数：net.ipv4.ip_nonlocal_bind=1

listen WEB_PORT_80
  bind 10.0.0.7:80
  mode http
  option forwardfor
  server web1 10.0.0.17:8080 check inter 3000 fall 3 rise 5
  server web2 10.0.0.27:8080 check inter 3000 fall 3 rise 5

frontend 配置

指定HAProxy的监听地址，可以是IPV4或IPV6，可以同时监听多个IP或端口，可同时用于listen字段中
bind [<address>]:<port_range> [, ...] [param*]

针对所有server配置,当前端服务器的连接数达到上限后的后援队列长度，注意：不支持backend
backlog <backlog>

示例：

可以采用后面形式命名：业务-服务-端口号

frontend www_web_port 
  bind :80,:8080
  bind 10.0.0.7:10080,:8801-8810,10.0.0.17:9001-9010
  mode http|tcp 
  use_backend <backend_name> 

backend配置

定义一组后端服务器，backend服务器将被frontend进行调用。
backend 名称必须唯一，并且必须在listen或frontend中事先定义才可以使用，否则服务无法启动。

option 后面加 httpchk，smtpchk，mysql-check，pgsql-check，ssl-hello-chk方法，可用于实现更多应用层检测功能。

mode http|tcp #指定负载协议类型,和对应的frontend必须一致
option #配置选项
server #定义后端real server,必须指定IP和端口

server 配置

对指定real进行健康状态检查，如果不加此设置，默认不开启检查,只有check后面没有其它配置也可以启用检查功能
check

默认对相应的后端服务器IP和端口,利用TCP连接进行周期性健康性检查,注意必须指定端口才能实现健康性检查
可指定的健康状态监测IP，可以是专门的数据网段，减少业务网络的流量
addr <IP>

指定的健康状态监测端口
port <num>

健康状态检查间隔时间，默认2000 ms
inter <num>

后端服务器从线上转为线下的检查的连续失效次数，默认为3
fall <num>

后端服务器从下线恢复上线的检查的连续有效次数，默认为2
rise <num>

权重，默认为1，最大值为256，0(状态为蓝色)表示不参与负载均衡，但仍接受持久连接
weight <weight>

将后端服务器标记为备份状态,只在所有非备份主机down机时提供服务，类似Sorry Server
backup

将后端服务器标记为不可用状态，即维护状态，除了持久模式，将不再接受连接,状态为深黄色,优雅下线,不再接受新用户的请求
disabled

将请求临时(302)重定向至其它URL，只适用于http模式
redir http://www.baidu.com

当前后端server的最大并发连接数
maxconn <maxconn>

使用子配置文件

当业务众多时，将所有配置都放在一个配置文件中，会造成维护困难。可以考虑按业务分类，将配置信息拆分，放在不同的子配置文件中，从而达到方便维护的目的。

注意: 子配置文件的文件后缀必须为.cfg

创建子配置目录

mkdir /etc/haproxy/conf.d/

创建子配置文件，注意：必须为cfg后缀非.开头的配置文件

vim /etc/haproxy/conf.d/test.cfg

添加子配置目录到unit文件中

修改 /lib/systemd/system/haproxy.service

[Unit]
Description=HAProxy Load Balancer
After=syslog.target network.target

[Service]
ExecStartPre=/usr/bin/haproxy -f /etc/haproxy/haproxy.cfg -f /etc/haproxy/conf.d/ -c -q
ExecStart=/usr/bin/haproxy -Ws -f /etc/haproxy/haproxy.cfg -f /etc/haproxy/conf.d/ -p /var/lib/haproxy/haproxy.pid
ExecReload=/bin/kill -USR2 $MAINPID
LimitNOFILE=100000

[Install]
WantedBy=multi-user.target               1

重启服务

systemctl daemon-reload
systemctl restart haproxy