官方文档地址:http://cbonte.github.io/haproxy-dconv/
![](https://frogvps.com/wp-content/uploads/2022/11/20221103a1-1024x719.jpg)
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