当前位置：首页 > news >正文

HaProxy基本配置详解

news 来源：原创 2025/6/8 16:28:25

一、haproxy基础配置

官方文档：HAProxy version 2.2.22 - Configuration Manual

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

global：全局配置段

进程及安全配置相关的参数
性能调整相关参数
Debug参数

proxies：代理配置段

defaults：为frontend, backend, listen提供默认配置
frontend：前端，相当于nginx中的server {}
backend：后端，相当于nginx中的upstream {}
listen：同时拥有前端和后端配置

1、haproxy global 配置

官方文档：HAProxy version 2.2.22 - Configuration Manual

chroot #锁定运行目录
deamon #以守护进程运行
stats socket /var/lib/haproxy/haproxy.sock mode 600 level admin process 1 #socket文件
user, group, uid, gid  #运行haproxy的用户身份
nbproc    n     #开启的haproxy work 进程数，默认进程数是一个
#nbthread  1    #指定每个haproxy进程开启的线程数，默认为每个进程一个线程,和nbproc互斥（版本有关）
#如果同时启用nbproc和nbthread 会出现以下日志的错误，无法启动服务
Apr  7 14:46:23 haproxy haproxy: [ALERT] 097/144623 (1454) : config : cannot enable multiple processes if multiple threads are configured. Please use either nbproc or nbthread but not both.

cpu-map 1 0     #绑定haproxy 进程至指定CPU，将第一个work进程绑定至0号CPU
maxconn  n      #每个haproxy进程的最大并发连接数
maxsslconn  n   #每个haproxy进程ssl最大连接数,用于haproxy配置了证书的场景下
maxconnrate n   #每个进程每秒创建的最大连接数量
spread-checks n #后端server状态check随机提前或延迟百分比时间，建议2-5(20%-50%)之间，默认值0
pidfile         #指定pid文件路径
log 127.0.0.1  local2 info #定义全局的syslog服务器；日志服务器需要开启UDP协议，最多可以定义两个

范例：多进程和socket文件

[root@node1 ~]# vim /etc/haproxy/haproxy.cfg
global
maxconn 100000
chroot /apps/haproxy
stats socket /var/lib/haproxy/haproxy.sock1 mode 600 level admin process 1               
stats socket /var/lib/haproxy/haproxy.sock2 mode 600 level admin process 2
uid 99
gid 99
daemon
nbproc 2
[root@node1 ~]# systemctl restart haproxy
[root@node1 ~]# pstree -p |grep haproxy
           |-haproxy(2281)-+-haproxy(2285)
           |               `-haproxy(2286)
[root@node1 ~]# ll /var/lib/haproxy/
总用量 4
-rw-r--r-- 1 root root 5 2月  23 10:34 haproxy.pid
srw------- 1 root root 0 2月  23 10:23 haproxy.sock
srw------- 1 root root 0 2月  23 10:34 haproxy.sock1
srw------- 1 root root 0 2月  23 10:34 haproxy.sock2

2、haproxy proxies配置

官方文档：HAProxy version 2.2.22 - Configuration Manual

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

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

（1）Proxies配置-defaults

defaults 配置参数：

option redispatch       #当server Id对应的服务器挂掉后，强制定向到其他健康的服务器，重新派发
option abortonclose     #当服务器负载很高时，自动结束掉当前队列处理比较久的链接，针对业务情况选择开启
option http-keep-alive  #开启与客户端的会话保持
option  forwardfor      #透传客户端真实IP至后端web服务器
mode http|tcp           #设置默认工作类型,使用TCP服务器性能更好，减少压力
timeout http-keep-alive 120s #session 会话保持超时时间，此时间段内会转发到相同的后端服务器
timeout connect 120s    #客户端请求从haproxy到后端server最长连接等待时间(TCP连接之前)，默认单位ms
timeout server  600s    #客户端请求从haproxy到后端服务端的请求处理超时时长(TCP连接之后)，默认单位ms，如果超时，会出现502错误，此值建议设置较大些，访止502错误
timeout client  600s    #设置haproxy与客户端的最长非活动时间，默认单位ms，建议和timeout server相同
timeout  check   5s     #对后端服务器的默认检测超时时间
default-server inter 1000 weight 3   #指定后端服务器的默认设置

（2）Proxies配置-frontend

fronted 配置参数：

bind：   #指定HAProxy的监听地址，可以是IPV4或IPV6，可以同时监听多个IP或端口，可同时用于listen字段中

#格式：
bind [<address>]:<port_range> [, ...] [param*]

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

范例：

listen http_proxy                           #监听http的多个IP的多个端口和sock文件
    bind :80,:443,:8801-8810
    bind 10.0.0.1:10080,10.0.0.1:10443
    bind /var/run/ssl-frontend.sock user root mode 600 accept-proxy

listen http_https_proxy                     #https监听
    bind :80
    bind :443 ssl crt /etc/haproxy/site.pem #公钥和私钥公共文件

listen http_https_proxy_explicit            #监听ipv6、ipv4和unix sock文件
    bind ipv6@:80
    bind ipv4@public_ssl:443 ssl crt /etc/haproxy/site.pem
    bind unix@ssl-frontend.sock user root mode 600 accept-proxy

listen external_bind_app1                   #监听file descriptor
    bind "fd@${FD_APP1}"

生产示例：

frontend  oepnlab_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>  #调用的后端服务器组名称

（3）backend 配置-backend

定义一组后端服务器，backend服务器将被frontend进行调用：

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

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

option 配置参数：

check               #对指定real进行健康状态检查，如果不加此设置，默认不开启检查
    addr  <IP>        #可指定的健康状态监测IP，可以是专门的数据网段，减少业务网络的流量
    port  <num>   #指定的健康状态监测端口
    inter <num>   #健康状态检查间隔时间，默认2000 ms
    fall  <num>       #后端服务器从线上转为线下的检查的连续失效次数，默认为3
    rise  <num>       #后端服务器从下线恢复上线的检查的连续有效次数，默认为2
weight  <weight>  #默认为1，最大值为256，0表示不参与负载均衡，但仍接受持久连接
backup              #将后端服务器标记为备份状态,只在所有非备份主机down机时提供服务，类似Sorry Server
disabled            #将后端服务器标记为不可用状态，即维护状态，除了持久模式，将不再接受连接
redirect prefix  http://www.baidu.com/      #将请求临时(302)重定向至其它URL，只适用于http模式
redir http://www.baidu.com                  #将请求临时(302)重定向至其它URL，只适用于http模式
maxconn <maxconn>     #当前后端server的最大并发连接数
backlog <backlog> #当前端服务器的连接数达到上限后的后援队列长度，注意：不支持backend

（4）frontend+backend配置实例

范例1：

frontend openlab-test-http
    bind :80,:8080
    mode tcp
    use_backend openlab-test-http-nodes

backend openlab-test-http-nodes
    mode tcp
    default-server inter 1000 weight 6
    server web1 192.168.150.14:80 check weight 2 addr 192.168.150.114 port 8080
    server web2 192.168.150.15:80 check

范例2：

#官网业务访问入口
frontend  WEB_PORT_80
    bind 192.168.150.11:80
    mode http
    use_backend  web_prot_http_nodes

backend web_prot_http_nodes
    mode  http
    option forwardfor
    server 192.168.150.14 192.168.150.14:80   check inter 3000 fall 3 rise 5
    server 192.168.150.15 192.168.150.15:80   check inter 3000 fall 3 rise 5

（5）Proxies配置-listen替代frontend+backend

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

#官网业务访问入口
listen  WEB_PORT_80
    bind 192.168.150.11:80
    mode http
    option  forwardfor
    server web1   192.168.150.14:80   check inter 3000 fall 3 rise 5
    server web2   192.168.150.15:80   check inter 3000 fall 3 rise 5

二、使用子配置文件保存配置

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

#创建子配置目录
[root@localhost ~]# mkdir /etc/haproxy/conf.d/

#创建子配置文件，注意：必须为cfg后缀
[root@localhost ~]# vim   /etc/haproxy/conf.d/test.cfg
listen  WEB_PORT_80
    bind 192.168.150.11:80
    mode http
    balance roundrobin
    server web1   192.168.150.14:80   check inter 3000 fall 3 rise 5
    server web2   192.168.150.15:80   check inter 3000 fall 3 rise 5

#添加子配置目录到unit文件中
[root@localhost ~]# vim  /lib/systemd/system/haproxy.service
[Unit]
Description=HAProxy Load Balancer
After=syslog.target network.target

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

[Install]
WantedBy=multi-user.target

[root@localhost ~]# systemctl daemon-reload 
[root@localhost ~]# systemctl restart haproxy

三、haproxy日志配置

配置HAProxy记录日志到指定日志文件中

1、haproxy配置

#在global配置项定义：
log 127.0.0.1  local{1-7} info #基于syslog记录日志到指定设备，级别有(err、warning、info、debug)

listen  web_port
  bind 127.0.0.1:80
  mode http
  log global                                #开启当前web_port的日志功能，默认不记录日志
  server web1  127.0.0.1:8080  check inter 3000 fall 2 rise 5

# systemctl  restart haproxy

2、rsyslog配置

vim /etc/rsyslog.conf 
$ModLoad imudp
$UDPServerRun 514
......
# Save haproxy messages also to haproxy.log
local2.*                                                /var/log/haproxy.log
......

# systemctl  restart rsyslog

3、验证haproxy日志

重启syslog服务并访问app页面，然后验证是否生成日志

[root@localhost ~]# cat /var/log/haproxy.log
Feb 23 16:30:52 localhost haproxy[12324]: Connect from 192.168.121.1:55708 to 192.168.121.51:9999 (stats/HTTP)
Feb 23 16:30:52 localhost haproxy[12324]: Connect from 192.168.121.1:55708 to 192.168.121.51:9999 (stats/HTTP)
Feb 23 16:30:52 localhost haproxy[12324]: Connect from 192.168.121.1:55708 to 192.168.121.51:9999 (stats/HTTP)