HAProxy配置详解

文章目录

一：全局配置信息
二：默认的全局设置
三：监控页面的设置
四：网站监测listen配置
五：frontend配置
六：设置haproxy 错误页面
七：HAProxy的日志记录内容设置
八：acl策略配置
九：acl策略匹配相应
十：backend的设置
十一：backend server_blog
十二：backend server_bbs
十三：虚拟主机的配置支持
十四：完整配置文件
十五：Haproxy相关启动参数

一：全局配置信息

# 注释：参数是进程级的，通常和操作系统（OS）相关参数
global
       maxconn 20480                    #默认最大连接数 
       log 127.0.0.1 local3             #[err warning info debug] 
       chroot /usr/local/haproxy        #chroot运行的路径 
       uid 99                           #所属运行的用户uid 
       gid 99                           #所属运行的用户组 
       daemon                           #以后台形式运行haproxy 
       nbproc 1                         #进程数量(可以设置多个进程提高性能) 
       pidfile /var/run/haproxy.pid     #haproxy的pid存放路径,启动进程的用户必须有权限访问此文件 
       ulimit-n 65535                   #ulimit的数量限制

二：默认的全局设置

# 注释：这些参数可以被利用配置到frontend，backend，listen组件
defaults 
       log global 
       mode http                       #所处理的类别 (#7层 http;4层tcp  ) 
       maxconn 20480                   #最大连接数 
       option httplog                  #日志类别http日志格式 
       option httpclose                #每次请求完毕后主动关闭http通道 
       option dontlognull              #不记录健康检查的日志信息 
       option forwardfor               #如果后端服务器需要获得客户端真实ip需要配置的参数，可以从Http Header中获得客户端ip  
       option redispatch               #serverId对应的服务器挂掉后,强制定向到其他健康的服务器  
       option abortonclose             #当服务器负载很高的时候，自动结束掉当前队列处理比较久的连接 
       stats refresh 30                #统计页面刷新间隔 
       retries 3                       #3次连接失败就认为服务不可用，也可以通过后面设置 
       balance roundrobin              #默认的负载均衡的方式,轮询方式 
       #balance source                 #默认的负载均衡的方式,类似nginx的ip_hash,可以固定session
       #balance leastconn              #默认的负载均衡的方式,最小连接 
       contimeout 5000                 #连接超时5s , 单位是ms
       clitimeout 50000                #客户端超时 
       srvtimeout 50000                #服务器超时 
       timeout check 2000              #心跳检测超时 

       #注: 时间的设置,单位为毫秒ms
       #1ms = 1/1000 second
       #1m = 60s = 60000 ms
       #1h = 60m = 3600s 
       #1d = 24h = 1440m = 86400s = 864000000ms

三：监控页面的设置

# 三：监控页面的设置
listen admin_status                      #Frontend和Backend的组合体,监控组的名称，按需自定义名称 
        bind :65532                      #本地监听端口 
        mode http                        #http的7层模式 
        log 127.0.0.1 local3 err         #错误日志记录 
        stats refresh 5s                 #每隔5秒自动刷新监控页面 
        stats uri /admin?stats           #监控页面的url 
        stats realm Haproxy\ Statistics  #监控页面的提示信息 
        stats auth yangcan:yangcan       #监控页面的用户和密码yangcan,可以设置多个用户名 
        stats auth admin:admin           #监控页面的用户和密码admin
        stats hide-version               #隐藏统计页面上的HAproxy版本信息  
        stats admin if TRUE              #手工启用/禁用,后端服务器(haproxy-1.4.9以后版本)

四：网站监测listen配置

# 四：网站监测listen配置
# 注释：此用法主要是监控haproxy后端服务器的监控状态
listen site_status 
       bind :1081                             #本地监听端口 
       mode http                              #http的7层模式 
       log 127.0.0.1 local3 err               #[err warning info debug] 
       monitor-uri /site_status               #网站健康检测URL，用来检测HAProxy管理的网站是否可以用，正常返回200，不正常返回503 
       acl site_dead nbsrv(server_web)  lt 2  #定义网站down时的策略当挂在负载均衡上的指定backend的中有效机器数小于2台时返回true 
       acl site_dead nbsrv(server_blog)  lt 2 
       acl site_dead nbsrv(server_bbs)   lt 2  
       monitor fail if site_dead              #当满足策略的时候返回503，网上文档说的是500，实际测试为503 
       monitor-net 10.0.0.103/24              #来自10.0.0.103的日志信息不会被记录和转发 
       monitor-net 10.0.0.25/24

五：frontend配置

# 五：frontend配置
# 注释：注意，frontend配置里面可以定义多个acl进行匹配操作
frontend http_80_in 
       bind :8080            #本地监听端口，即haproxy提供web服务的端口，和lvs的vip端口类似 
       mode http             #http的7层模式 
       log global            #应用全局的日志配置 
       option httplog        #启用http的log 
       option httpclose      #每次请求完毕后主动关闭http通道，HA-Proxy不支持keep-alive模式 
       option forwardfor     #如果后端服务器需要获得客户端的真实IP需要配置次参数，将可以从Http Header中获得客户端IP

六：设置haproxy 错误页面

# 六：设置haproxy 错误页面
       #errorfile 403 /home/haproxy/haproxy/errorfiles/403.http
       #errorfile 500 /home/haproxy/haproxy/errorfiles/500.http
       #errorfile 502 /home/haproxy/haproxy/errorfiles/502.http
       #errorfile 503 /home/haproxy/haproxy/errorfiles/503.http
       #errorfile 504 /home/haproxy/haproxy/errorfiles/504.http

七：HAProxy的日志记录内容设置

# 七：HAProxy的日志记录内容设置
       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策略配置
       acl baby_web hdr_reg(host) -i ^(blog80.baby.local |station80.baby.local)$    
       # 如果请求的域名满足正则表达式中的2个域名返回true -i是忽略大小写,主要用于redirect到www80.baby.local上; 
       acl baby_blog hdr_dom(host) -i www80.baby.local 
       # 如果请求的域名满足www80.baby.local 返回true -i是忽略大小写 
       #acl baby    hdr(host) -i baby.local 
       # 如果请求的域名满足baby.local 返回true -i是忽略大小写 
       #acl file_req url_sub -i  killall= 
       # 在请求url中包含killall=，则此控制策略返回true,否则为false 
       #acl dir_req url_dir -i allow 
       # 在请求url中存在allow作为部分地址路径，则此控制策略返回true,否则返回false 
       #acl missing_cl hdr_cnt(Content-length) eq 0 
       # 当请求的header中Content-length等于0时返回true

九：acl策略匹配相应

# 九：acl策略匹配相应
       #block if missing_cl 
       #当请求中header中Content-length等于0阻止请求返回403 
       #block if !file_req || dir_req 
       #block表示阻止请求，返回403错误，当前表示如果不满足策略file_req，或者满足策略dir_req，则阻止请求 
       redirect prefix http://www80.baby.local code 301 if baby
       #当访问itnihao.cn的时候，用http的301挑转到http://10.0.0.103 
       reqisetbe       ^[^\]*\/(img|css)/       server_web 
       reqisetbe       ^[^\]*\/bbs/             server_blog 
       # reqisetbe 关键字定义,根据定义的关键字选择backend
       use_backend  server_web  if  baby_web
       当满足baby_web的策略时使用server_web的backend 
       use_backend  server_blog if baby_log 
       #当满足baby_log的策略时使用server_blog的backend 
       default_backend server_bbs 
       #以上都不满足的时候使用默认server_bbs的backend 
       # 注: redirect 和 reqisetbe 需要放置在 use_backend 之前

十：backend的设置

# 十：backend的设置
# 注释：下面我将设置三组服务器 server_web，server_blog，server_bbs；backend server_we
backend server_web 
       mode http                       #http的7层模式 
       balance roundrobin              #负载均衡的方式，roundrobin平均方式 
       cookie SERVERID                 #允许插入serverid到cookie中，serverid后面可以定义 
       option httpchk GET /index.html  #心跳检测的文件 
       server web1 10.0.0.25:80 cookie web1 check inter 1500 rise 3 fall 3 weight 1  
       #服务器定义，cookie 1表示serverid为web1，check inter 1500是检测心跳频率rise 3是3次正确认为服务器可用， 
       #fall 3是3次失败认为服务器不可用，weight代表权重 
       server web2 10.0.0.103:80 cookie web2 check inter 1500 rise 3 fall 3 weight 2 
       #服务器定义，cookie 1表示serverid为web2，check inter 1500是检测心跳频率rise 3是3次正确认为服务器可用， 
       #fall 3是3次失败认为服务器不可用，weight代表权重

十一：backend server_blog

# 十一：backend server_blog
backend server_blog 
       mode http 
       balance roundrobin
       cookie SERVERID 
       option httpchk GET /index.html 
       server blog1 10.0.0.25:80 cookie blog1 check inter 1500 rise 3 fall 3 weight 1  
       server blog2 10.0.0.103:80 cookie blog2 check inter 1500 rise 3 fall 3 weight 2

十二：backend server_bbs

# 十二：backend server_bbs
backend server_bbs 
       mode http     
       balance roundrobin 
       cookie SERVERID  
       option httpchk GET /index.html 
       server bbs1 10.0.0.25:80 cookie bbs1 check inter 1500 rise 3 fall 3 weight 1  
       server bbs2 10.0.0.103:80 cookie bbs2 check inter 1500 rise 3 fall 3 weight 2

十三：虚拟主机的配置支持

# 十三：虚拟主机的配置支持
listen blog80.baby.local 0.0.0.0:80 
       mode http     
       balance roundrobin 
       cookie SERVERID  
       option httpchk GET /index.html 
       server bbs1 10.0.0.25:80 cookie bbs1 check inter 1500 rise 3 fall 3 weight 1  
       server bbs2 10.0.0.103:80 cookie bbs2 check inter 1500 rise 3 fall 3 weight 2 

listen bbs.baby.local 0.0.0.0:80 
       mode http     
       balance roundrobin 
       cookie SERVERID  
       option httpchk GET /index.html 
       server bbs1 10.0.0.25:80 cookie bbs1 check inter 1500 rise 3 fall 3 weight 1  
       server bbs2 10.0.0.103:80 cookie bbs2 check inter 1500 rise 3 fall 3 weight 2

十四：完整配置文件

global
       maxconn 20480                    #默认最大连接数 
       log 127.0.0.1 local3               #[err warning info debug] 
       chroot /usr/local/haproxy       #chroot运行的路径 
       uid 99                                    #所属运行的用户uid 
       gid 99                                    #所属运行的用户组 
       daemon                                #以后台形式运行haproxy 
       nbproc 1                               #进程数量(可以设置多个进程提高性能) 
       pidfile /var/run/haproxy.pid   #haproxy的pid存放路径,启动进程的用户必须有权限访问此文件 
       ulimit-n 65535                      #ulimit的数量限制 

defaults 
       log global 
       mode http                             #所处理的类别 (#7层 http;4层tcp  ) 
       maxconn 20480                   #最大连接数 
       option httplog                       #日志类别http日志格式 
       option httpclose                   #每次请求完毕后主动关闭http通道 
       option dontlognull                #不记录健康检查的日志信息 
       option forwardfor                 #如果后端服务器需要获得客户端真实ip需要配置的参数，可以从Http Header中获得客户端ip  
       option redispatch                 #serverId对应的服务器挂掉后,强制定向到其他健康的服务器  
       option abortonclose             #当服务器负载很高的时候，自动结束掉当前队列处理比较久的连接 
       stats refresh 30                   #统计页面刷新间隔 
       retries 3                               #3次连接失败就认为服务不可用，也可以通过后面设置 
       balance roundrobin             #默认的负载均衡的方式,轮询方式 
       #balance source                  #默认的负载均衡的方式,类似nginx的ip_hash,可以固定session
       #balance leastconn              #默认的负载均衡的方式,最小连接 
       contimeout 5000                 #连接超时5s , 单位是ms
       clitimeout 50000                 #客户端超时 
       srvtimeout 50000                #服务器超时 
       timeout check 2000            #心跳检测超时 

       #注: 时间的设置,单位为毫秒ms
       #1ms = 1/1000 second
       #1m = 60s = 60000 ms
       #1h = 60m = 3600s 
       #1d = 24h = 1440m = 86400s = 864000000ms 

listen admin_status                      #Frontend和Backend的组合体,监控组的名称，按需自定义名称 
        bind :65532                         #本地监听端口 
        mode http                           #http的7层模式 
        log 127.0.0.1 local3 err      #错误日志记录 
        stats refresh 5s                  #每隔5秒自动刷新监控页面 
        stats uri /admin?stats           #监控页面的url 
        stats realm Haproxy\ Statistics  #监控页面的提示信息 
        stats auth yangcan:yangcan       #监控页面的用户和密码yangcan,可以设置多个用户名 
        stats auth admin:admin           #监控页面的用户和密码admin
        stats hide-version               #隐藏统计页面上的HAproxy版本信息  
        stats admin if TRUE              #手工启用/禁用,后端服务器(haproxy-1.4.9以后版本) 

listen site_status 
       bind :1081                         #本地监听端口 
       mode http                          #http的7层模式 
       log 127.0.0.1 local3 err           #[err warning info debug] 
       monitor-uri /site_status           #网站健康检测URL，用来检测HAProxy管理的网站是否可以用，正常返回200，不正常返回503 
       acl site_dead nbsrv(server_web)  lt 2  #定义网站down时的策略当挂在负载均衡上的指定backend的中有效机器数小于2台时返回true 
       acl site_dead nbsrv(server_blog)  lt 2 
       acl site_dead nbsrv(server_bbs)   lt 2  
       monitor fail if site_dead            #当满足策略的时候返回503，网上文档说的是500，实际测试为503 
       monitor-net 10.0.0.103/24            #来自10.0.0.103的日志信息不会被记录和转发 
       monitor-net 10.0.0.25/24 

frontend http_80_in 
       bind :8080            #本地监听端口，即haproxy提供web服务的端口，和lvs的vip端口类似 
       mode http             #http的7层模式 
       log global            #应用全局的日志配置 
       option httplog        #启用http的log 
       option httpclose      #每次请求完毕后主动关闭http通道，HA-Proxy不支持keep-alive模式 
       option forwardfor     #如果后端服务器需要获得客户端的真实IP需要配置次参数，将可以从Http Header中获得客户端IP 

       #errorfile 403 /home/haproxy/haproxy/errorfiles/403.http
       #errorfile 500 /home/haproxy/haproxy/errorfiles/500.http
       #errorfile 502 /home/haproxy/haproxy/errorfiles/502.http
       #errorfile 503 /home/haproxy/haproxy/errorfiles/503.http
       #errorfile 504 /home/haproxy/haproxy/errorfiles/504.http

       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 baby_web hdr_reg(host) -i ^(blog80.baby.local |station80.baby.local)$    
       # 如果请求的域名满足正则表达式中的2个域名返回true -i是忽略大小写,主要用于redirect到www80.baby.local上; 
       acl baby_blog hdr_dom(host) -i www80.baby.local 
       # 如果请求的域名满足www80.baby.local 返回true -i是忽略大小写 
       #acl baby    hdr(host) -i baby.local 
       # 如果请求的域名满足baby.local 返回true -i是忽略大小写 
       #acl file_req url_sub -i  killall= 
       # 在请求url中包含killall=，则此控制策略返回true,否则为false 
       #acl dir_req url_dir -i allow 
       # 在请求url中存在allow作为部分地址路径，则此控制策略返回true,否则返回false 
       #acl missing_cl hdr_cnt(Content-length) eq 0 
       # 当请求的header中Content-length等于0时返回true 

       #block if missing_cl 
       #当请求中header中Content-length等于0阻止请求返回403 
       #block if !file_req || dir_req 
       #block表示阻止请求，返回403错误，当前表示如果不满足策略file_req，或者满足策略dir_req，则阻止请求 
       redirect prefix http://www80.baby.local code 301 if baby
       #当访问itnihao.cn的时候，用http的301挑转到http://10.0.0.103 
       reqisetbe       ^[^\]*\/(img|css)/       server_web 
       reqisetbe       ^[^\]*\/bbs/             server_blog 
       # reqisetbe 关键字定义,根据定义的关键字选择backend
       use_backend  server_web  if  baby_web
       当满足baby_web的策略时使用server_web的backend 
       use_backend  server_blog if baby_log 
       #当满足baby_log的策略时使用server_blog的backend 
       default_backend server_bbs 
       #以上都不满足的时候使用默认server_bbs的backend 

       # 注: redirect 和 reqisetbe 需要放置在 use_backend 之前

backend server_web 
       mode http            #http的7层模式 
       balance roundrobin   #负载均衡的方式，roundrobin平均方式 
       cookie SERVERID      #允许插入serverid到cookie中，serverid后面可以定义 
       option httpchk GET /index.html #心跳检测的文件 
       server web1 10.0.0.25:80 cookie web1 check inter 1500 rise 3 fall 3 weight 1  
       #服务器定义，cookie 1表示serverid为web1，check inter 1500是检测心跳频率rise 3是3次正确认为服务器可用， 
       #fall 3是3次失败认为服务器不可用，weight代表权重 
       server web2 10.0.0.103:80 cookie web2 check inter 1500 rise 3 fall 3 weight 2 
       #服务器定义，cookie 1表示serverid为web2，check inter 1500是检测心跳频率rise 3是3次正确认为服务器可用， 
       #fall 3是3次失败认为服务器不可用，weight代表权重 

backend server_blog 
       mode http 
       balance roundrobin
       cookie SERVERID 
       option httpchk GET /index.html 
       server blog1 10.0.0.25:80 cookie blog1 check inter 1500 rise 3 fall 3 weight 1  
       server blog2 10.0.0.103:80 cookie blog2 check inter 1500 rise 3 fall 3 weight 2 

backend server_bbs 
       mode http     
       balance roundrobin 
       cookie SERVERID  
       option httpchk GET /index.html 
       server bbs1 10.0.0.25:80 cookie bbs1 check inter 1500 rise 3 fall 3 weight 1  
       server bbs2 10.0.0.103:80 cookie bbs2 check inter 1500 rise 3 fall 3 weight 2 

listen blog80.baby.local 0.0.0.0:80 
       mode http     
       balance roundrobin 
       cookie SERVERID  
       option httpchk GET /index.html 
       server bbs1 10.0.0.25:80 cookie bbs1 check inter 1500 rise 3 fall 3 weight 1  
       server bbs2 10.0.0.103:80 cookie bbs2 check inter 1500 rise 3 fall 3 weight 2 

listen bbs.baby.local 0.0.0.0:80 
       mode http     
       balance roundrobin 
       cookie SERVERID  
       option httpchk GET /index.html 
       server bbs1 10.0.0.25:80 cookie bbs1 check inter 1500 rise 3 fall 3 weight 1  
       server bbs2 10.0.0.103:80 cookie bbs2 check inter 1500 rise 3 fall 3 weight 2

十五：Haproxy相关启动参数

# 十四：Haproxy相关启动参数
# /usr/local/haproxy/sbin/haproxy –help 
haproxy -f < 配置文件> 
[-n 最大并发连接总数] [-N 每个侦听的最大并发数] [-d] [-D] [-q] [-V] [-c] [-p ] [-s] [-l] [-dk] 
[-ds] [-de] [-dp] [-db] [-m < 内存限制M>] [{-sf|-st} pidlist...] 
-d  前台，debug模式
-D  daemon模式启动 
-q  安静模式,不输出信息 
-V  详细模式 
-c 对配置文件进行语法检查 
-s  显示统计数据 
-l  显示详细统计数据 
-dk 不使用kqueue 
-ds 不使用speculative epoll 
-de 不使用epoll 
-dp 不使用poll 
-db 禁用后台模式，程序跑在前台 
-sf 程序启动后向pidlist里的进程发送FINISH信号，这个参数放在命令行的最后 
-st 程序启动后向pidlist里的进程发送TERMINATE信号，这个参数放在命令行的最后

一：全局配置信息

二：默认的全局设置

三：监控页面的设置

四：网站监测listen配置

五：frontend配置

六：设置haproxy 错误页面

七：HAProxy的日志记录内容设置

八：acl策略配置

九：acl策略匹配相应

十：backend的设置

十一：backend server_blog

十二：backend server_bbs

十三：虚拟主机的配置支持

十四：完整配置文件

十五：Haproxy相关启动参数

推荐文章

SSR客户端详细使用教程以及下载地址

一款功能强大的ShadowSocks面板：SSRPanel

如何在Ubuntu 16.04.3 LTS ISO上安装EVE NG（一）

2024年 4月
一	二	三	四	五	六	日
1	2	3	4	5	6	7
8	9	10	11	12	13	14
15	16	17	18	19	20	21
22	23	24	25	26	27	28
29	30