企业级HAProxy高可用离线部署实战（附Kubernetes APIServer负载均衡配置）

摘要：本文深入讲解在离线环境下部署HAProxy 3.1.1的全流程，涵盖源码编译、系统服务封装、K8S APIServer四层负载配置等核心环节，并提供生产级高可用方案。适用于金融、政务等隔离网络的负载均衡场景。

一、环境规划与架构设计

1.1 节点信息

节点IP	角色	服务组件
192.167.14.119	主负载节点	HAProxy + Keepalived
192.167.14.223	备负载节点	HAProxy + Keepalived
192.167.14.226	备负载节点	HAProxy + Keepalived

1.2 服务端口规划

服务	端口	协议	用途
HAProxy Admin	33305	HTTP	监控接口
K8S APIServer	16443	TCP	Kubernetes API入口

二、离线安装HAProxy

2.1 源码编译安装

# 在有网环境下载源码包
wget https://www.haproxy.org/download/3.1/src/haproxy-3.1.1.tar.gz# 传输到离线环境后解压编译
tar -zxvf haproxy-3.1.1.tar.gz -C /usr/local
cd /usr/local/haproxy-3.1.1# 指定目标系统和安装路径
make TARGET=linux31 PREFIX=/usr/local/haproxy
make install PREFIX=/usr/local/haproxy# 创建日志目录
mkdir -p /usr/local/haproxy/logs

关键参数解析：

TARGET=linux31：指定内核版本兼容性
PREFIX：定义安装根目录，便于集中管理

三、系统服务封装

3.1 创建SystemV服务脚本

vi /etc/rc.d/init.d/haproxy#!/bin/bash
# chkconfig: 2345 10 90
# description: HAProxy ServiceBASE_DIR="/usr/local/haproxy"
CONFIG_FILE="$BASE_DIR/haproxy.cfg"
PID_FILE="$BASE_DIR/logs/haproxy.pid"start() {echo "Starting HAProxy..."$BASE_DIR/sbin/haproxy -f $CONFIG_FILE -p $PID_FILE[ $? -eq 0 ] && echo "Success" || echo "Failed"
}stop() {echo "Stopping HAProxy..."[ -f $PID_FILE ] && kill -USR1 $(cat $PID_FILE) || pkill haproxy
}restart() {stopsleep 2start
}case "$1" instart)   start ;;stop)    stop ;;restart) restart ;;*) echo "Usage: $0 {start|stop|restart}" ;;
esac

3.2 配置服务自启动

chmod +x /etc/rc.d/init.d/haproxy
chkconfig --add haproxy
chkconfig haproxy on

四、K8S APIServer负载配置

4.1 主配置文件`haproxy.cfg`

cat > /usr/local/haproxy/haproxy.cfg <<EOF
globalmaxconn  4000            # 最大连接数log /dev/log local0      # 日志输出stats timeout 30s        # 统计接口超时defaultsmode tcp                 # 四层代理模式timeout connect 5s       # 后端连接超时timeout client 30s       # 客户端超时timeout server 30s       # 服务端超时frontend k8s-apiserverbind *:16443             # 监听所有IP的16443端口default_backend apiserver-nodesbackend apiserver-nodesbalance roundrobin       # 轮询负载策略option tcp-check         # TCP健康检查default-server inter 10s fall 2 rise 2server master119 192.167.14.119:6443 checkserver master223 192.167.14.223:6443 checkserver master226 192.167.14.226:6443 checklisten stats               # 监控页面配置bind *:33305mode httpstats enablestats uri /monitorstats auth admin:HAProxy@2023
EOF

4.2 配置解析

配置项	说明
`balance roundrobin`	轮询策略，均匀分配请求
`inter 10s`	健康检查间隔
`fall 2`	连续失败2次标记节点不可用
`stats uri`	监控页面路径，用于实时查看状态

五、服务管理与验证

5.1 服务控制命令

# 启动服务
systemctl start haproxy# 查看状态
systemctl status haproxy# 检查端口监听
ss -lntp | grep 16443# 强制终止进程
killall -9 haproxy

5.2 监控页面访问

访问地址：http://<节点IP>:33305/monitor
认证信息：admin / HAProxy@2023

六、生产级优化方案

6.1 内核参数调优

# 增加文件描述符限制
echo "net.core.somaxconn = 65535" >> /etc/sysctl.conf
echo "net.ipv4.tcp_max_syn_backlog = 65535" >> /etc/sysctl.conf
sysctl -p

6.2 日志切割配置

# 安装logrotate
cat > /etc/logrotate.d/haproxy <<EOF
/usr/local/haproxy/logs/*.log {dailyrotate 7missingoknotifemptycompressdelaycompresssharedscriptspostrotate/bin/kill -USR1 $(cat /usr/local/haproxy/logs/haproxy.pid 2>/dev/null) 2>/dev/null || trueendscript
}
EOF

七、高可用联动Keepalived

7.1 VIP漂移验证

# 查看当前VIP绑定
ip addr show | grep 192.167.14.205# 模拟主节点故障
systemctl stop haproxy
tail -f /var/log/messages  # 观察切换日志

八、故障排查指南

现象	排查命令	解决方案
端口未监听	`netstat -lntp	grep haproxy`
健康检查失败	`telnet <后端IP> 6443`	验证APIServer服务状态
负载不均衡	监控页面查看后端节点状态	调整balance策略为leastconn
内存占用过高	`top -p $(pgrep haproxy)`	优化maxconn参数，增加系统内存