HAProxy安装配置

墨烦信息

已于 2023-06-24 11:07:10 修改

阅读量678

点赞数

CC 4.0 BY-SA版权

文章标签：服务器负载均衡 nginx

于 2023-06-23 12:22:23 首次发布

本文链接：https://blog.youkuaiyun.com/wang11876/article/details/131349505

本文详细介绍了HAProxy1.6.8的安装过程，包括依赖安装、编译和安装步骤。接着，文章提供了基础配置模板，涉及负载均衡、日志、超时设置和服务器池等关键配置选项，并与Nginx进行了对比。HAProxy不仅可用于7层负载均衡，还能作为SSH反向代理和MySQL代理。此外，文章还提到了如何进行日志配置以及性能调优，如最大连接数的设定。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

HAProxy安装配置

HAProxy版本: 1.6.8

HAProxy与Nginx类似, 安装简单, 配置复杂且灵活, 所以文档大部分都时着眼于配置. 另外, 由于最先接触nginx, 这里将以nginx作为类比, 去解释HAProxy的配置选项.

至于应用场景, 它做的比nginx多, 可以做为ssh反向代理, 当作跳板机来用(其实就是端口转发, 不过比iptables方便多了); 还可以代理mysql, 来源限制就写在haproxy自己的配置文件里, 不必每当有一台新机器需要连接mysql时就在mysql中开放对这个IP的限制, 多麻烦.

这篇文章里只是讲了和nginx一样作为7层负载均衡的配置, 其他场景下的配置请查阅另一篇文章.

1. 安装

安装依赖

其中pcre-devel是为了使用正则匹配功能, openssl-devel是为了支持https的功能

yum install -y pcre-devel openssl-devel

编译

HAProxy的源码编译没有configure的过程, 源码目录下直接就有Makefile文件, 一些配置项是通过在使用make命令时设置的.

tar -zxf haproxy-1.6.8.tar.gz
cd haproxy-1.6.8
## 这里指定了安装目录, 开启pcre及ssl支持. 更多配置项可以参考源码包内的`README`文件
make PREFIX=/usr/local/haproxy TARGET=linux26 USE_PCRE=1 USE_OPENSSL=1 ADDLIB=-lz
## 将haproxy安装到指定位置
make install PREFIX=/usr/local/haproxy

2. 配置

这个版本的HAProxy没有提供一个默认的配置文件, 初次安装可能会不知道从何处入手. 这里提供一个最简的模板文件, 等到熟悉之后, 其余的配置项可以通过参考官方文档自行定义.

defaults
    # 默认的模式mode { tcp|http|health }，tcp是4层，http是7层，health只会返回OK
    mode tcp
    # 采用http日志格式
    option tcplog
    # 三次连接失败就认为是服务器不可用，也可以通过后面设置
    retries 3
    # 如果cookie写入了serverId而客户端不会刷新cookie，
    # 当serverId对应的服务器挂掉后，强制定向到其他健康的服务器
    option redispatch
    # 当服务器负载很高的时候，自动结束掉当前队列处理比较久的链接
    option abortonclose
    # 默认的最大连接数
    maxconn 4096
    balance roundrobin    #设置默认负载均衡方式，轮询方式

    # 连接超时
    timeout connect 5000
    # 客户端超时
    timeout client 30000
    # 服务器超时
    timeout server 30000
    # 心跳检测超时
    timeout check 2000

    # 注: 一些参数值为时间，比如说timeout。时间值通常单位为毫秒(ms)，但是也可以通过加#后缀，来使用其他的单位。
    #- us : microseconds.
    #- ms : milliseconds.
    #- s  : seconds.
    #- m  : minutes.
    #- h  : hours.
    #- d  : days.

global
    # 全局的日志配置 其中日志级别是[err warning info debug]
    # local0 是日志设备, 必须为如下24种标准syslog设备的一种:                     
    # kern   user   mail   daemon auth   syslog lpr    news   
    # uucp   cron   auth2  ftp    ntp    audit  alert  cron2  
    # local0 local1 local2 local3 local4 local5 local6 local7
    # 下面日志配置一节中在/etc/syslog.conf文件中定义的是local0, 所以这里也是用local0
    log 127.0.0.1 local0 info
    # 最大连接数
    maxconn 4096

    # 用户/组
    user haproxy
    group haproxy
    ## 服务模式
    daemon
    # 创建4个进程进入deamon模式运行. 此参数要求将运行模式设置为"daemon"
    nbproc 4
    # pid文件位置
    pidfile /usr/local/haproxy/var/run/haproxy.pid

########frontend配置############
## 前端访问路径, front_server1这个名字可以自定义
frontend front_server1
    # 监听端口
    bind 0.0.0.0:80
    # http的7层模式
    mode http
    # 应用全局的日志配置
    log global
    # 启用http的log
    option httplog
    # 每次请求完毕后主动关闭http通道, HA-Proxy不支持keep-alive模式
    option httpclose
    # 如果后端服务器需要获得客户端的真实IP需要配置次参数,
    # 将可以从Http Header中获得客户端IP
    option forwardfor

    ########### 日志格式 ##########
    capture request  header Host len 40
    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

    #################### acl策略定义 #########################
    ## acl 类似于nginx的location, 也可以执行if判断
    # 如果请求的域名满足正则表达式返回true -i是忽略大小写
    acl rule1 hdr_reg(host) -i ^(www.exam.com)$

    ###################### acl策略匹配 ###################
    ## acl匹配是类似于nginx的proxy_pass命令, 就是将请求转发至后端服务器池(upstream的概念)
    # 当满足rule1的策略时使用名为 backend_pool 的 backend(后端服务器池)
    use_backend backend_pool if rule1
    #以上都不满足的时候使用默认backend_pool的backend
    default_backend backend_pool

    # HAProxy 错误页面设置
    ## 貌似不处理404错误
    errorfile 403 /usr/local/haproxy/error/403.html
    errorfile 503 /usr/local/haproxy/error/503.html

##########backend的设置##############
## 后端服务器池, nginx中的upstream概念, backend_pool这个名称可以自定义
  backend backend_pool
    # http的7层模式
    mode http
    # 负载均衡的方式, roundrobin平均方式
    balance roundrobin
    # 允许插入serverid到cookie中, serverid后面可以定义
    cookie SERVERID

    ## httpchk心跳检测的URL, haproxy将定时访问后端服务器的这个路径以确定其是否存活
    ## 'HTTP/1.1\r\nHost:XXXX', 指定了心跳检测发出的请求采用的HTTP的版本和域名
    # 在应用的检测URL对应的功能有对域名依赖的话需要设置
    option httpchk GET /index.html HTTP/1.1\r\nHost:www.exam.com

    # 服务器池定义, 'cookie 1'表示serverid为1, 'check inter 1500'是心跳检测的频率
    # rise 3是3次正确认为服务器可用, fall 3是3次失败认为服务器不可用, weight代表权重
    ## server_1, server_2这样的服务器别名是必须要写的
    server server_1 172.17.0.1:80 cookie 1 check inter 1500 rise 3 fall 3 weight 1
    server server_2 172.17.0.2:80 cookie 2 check inter 1500 rise 3 fall 3 weight 1

将其命名为haproxy.cfg, 放在/usr/local/haproxy/etc目录下, 默认可能没有etc目录, 可以手动创建. 其实配置文件的名称随意, 路径也随意, 只要在启动HAProxy时指定就好了.

上面示例文件中指定启动用户为haproxy, 所以先创建这个用户useradd haproxy.

另外, 配置文件中指定了pid文件, 为/usr/local/haproxy/var/run/haproxy.pid, 所以还需要创建var/run目录, 这个路径也随意, 可以在配置文件中更改, 只要HAProxy的启动用户有其写权限即可.

还有, 配置文件中指定了403, 503两个状态码的响应文件(好像errorfile指令不能处理404错误, 这个状态码应该不是后端服务器的响应码, 而是HAProxy本身的响应状态). 所以创建/usr/local/haproxy/error目录, 及403.html, 503.html两个文件, 内容随意(建议内容分别写为这是一个403错误, 这是一个503错误, 方便识别), 其实路径也随意, 只是在配置文件中指定到这个路径就行了.

配置文件中指定了一个访问域名www.exam.com, 可以通过添加hosts文件, 将此域名指向HAProxy所在服务器.

其中由一个option httpchk指令, 指定每隔一段时间, HAProxy就会访问后端服务器上的某个路径, 如果能够正常访问, 则说明后端服务器正常, 否则视其为宕机. 这里指定了访问url为/index.html, 所以后端服务器的80端后下还必须有index.html这个文件可以访问.

然后, HAProxy的启动方式是(root身份)/usr/local/haproxy/sbin/haproxy -f /usr/local/haproxy/etc/haproxy.cfg

访问方式为curl www.examl.com/index.html.

这个配置文件的意思是, HAProxy所在的服务器监听80端口, 访问www.exam.com, HAProxy将请求转发至后端172.17.0.1与172.17.0.2两台服务器的80端口以实现负载均衡的功能.

其中, frontend front_server1相当于nginx中的server块, 可以指定端口, 域名, 转发路径等信息. 其下的acl策略定义及匹配则相当于nginx的location{}块, 并且也可以进行if判断与正则匹配. use_backend指令相当于proxy_pass, 将符合当前规则的请求, 转发至服务器池.

backend backend_pool类似于nginx的upstream 名称, 定义后端服务器池的名称. 可以为后端服务器设置权重及检测存活状态.

3. 常用操作

启动服务

/usr/local/haproxy/sbin/haproxy -f /usr/local/haproxy/haproxy.cfg

重启服务(没有换行)

/usr/local/haproxy/sbin/haproxy -f /usr/local/haproxy/etc/haproxy.cfg -st `cat /usr/local/haproxy/var/run/haproxy.pid`

重新加载(平滑重启, 注意haproxy没有主进程, pid文件中可能是多个进程号, 所以cat命令还是十分有必要的)

/usr/local/haproxy/sbin/haproxy -f /usr/local/haproxy/etc/haproxy.cfg -sf `cat /usr/local/haproxy/var/run/haproxy.pid`

停止服务

killall haproxy

HAProxy-timeout client server超时配置

常用配置如下

defaults
  log     global
  timeout server 600s
  timeout client 600s
  timeout connect 600s

timeout client定义是客户端与haproxy(frontend块)的连接超时时间, timeout server则是haproxy与后端server的连接超时时间(backend块).

区别在于, haproxy的timeout是在双方之间没有数据传输的时候开始计时, 超时这个时间就会由haproxy主动断开连接, 需要客户端完成重连. 与linux 的 tcp keepalive 行为差不多.

需要注意的是, 虽然同样是检测空闲连接, 但这个timeout是进程级别的, 与linux的 tcp keepalive 不是同一个东西.

前者在双方端口都存在, 且能正常工作时, 也会触发断连.

后者则是用于, 在对端端口关闭时, 清理本机上的无效连接的.

HAProxy日志配置

假设日志服务为syslog或rsyslog(后者是前者的增强版, 作用, 配置文件几乎相同), 这里以rsyslog为例. HAProxy不像Nginx与Apache, 没有办法自行创建并写入日志文件. 它需要调用rsyslog服务, 将日志信息发送给rsyslog, 并由rsyslog管理其日志.

我们需要做的, 首先, 在HAProxy本身的配置文件haproxy.cft中添加

defaults
    # 采用http日志格式
    option httplog
...
global
   log 127.0.0.1 local0 info
...
frontend front_server1
    # 应用全局的日志配置
    log global

其中option指令指定日志格式, 有tcplog,httplog等; log指令指定日志级别, local0是rsyslog服务开放给自定义服务的日志类型, 包括local0-local78种类型, info是记录的日志级别.

然后编辑/etc/rsyslog.conf文件, 修改成如下:

# Provides UDP syslog reception
## 解开以下行的注释, 不然日志文件会创建但没有日志输出
$ModLoad imudp
$UDPServerRun 514
...

## 这里的local0与haproxy中的`local0`相对应.
local0.*        /var/log/haproxy.log

因为UDP 514是Linux系统默认的syslog使用的端口(在/etc/service中可查看), 重启rsyslog与haproxy服务, 可以看到有日志产生.

HAProxy性能调优

global
    ...
    maxconn 4096
    ...

在global块中设置这个值后, 所有的块连接数默认都是4096, 并且默认后端服务器池的连接数是前端的1/10, 见图中红框.

在listen块中设置这个值, 则对应的前端(frontend)与后端(backend)都会变化, 并且维持10:1的比例.

在frontend块中设置这个值, 则只会在对应前端会发生变化, 但是引用的后端不变;

同样, 在backend块中设置时, 只能在某一个server字段的后端服务器单独设置, 也只会影响目标server, 如下

server callback_server1 127.0.0.1:8080 maxconn 10240 cookie 1 check inter 1500 rise 3 fall 3 weight 1