HAProxy 是高效能、支援 TCP/HTTP (Layer 4/7) 的負載平衡器與反向代理,廣泛用於高流量網站架構。本文記錄在 CentOS 環境下,從原始碼編譯安裝 HAProxy 1.4.24,撰寫 haproxy.cfg 核心配置 (global、defaults、frontend/backend/listen)、建立 System V 啟動腳本並整合 chkconfig,至 rsyslog 日誌整合的完整流程。
# 1. 取得原始碼
tar zxvf haproxy-1.4.24.tar.gz
mv haproxy-1.4.24 haproxy
cd haproxy
# 2. 確認核心版本 (決定 TARGET)
uname -a
# Linux node3 2.6.18-164.el5 ... i686 → TARGET=linux24
# 3. 編譯與安裝
make TARGET=linux24 PREFIX=/usr/local/haproxy
make install PREFIX=/usr/local/haproxy
安裝完成後,執行檔位於 /usr/local/haproxy/sbin/haproxy,文件在 /usr/local/haproxy/share/man/man1。
haproxy.cfg 詳細解析配置結構分五大區塊 (非皆必需):
global
maxconn 51200
chroot /usr/local/haproxy
uid 99
gid 99
daemon
nbproc 1
pidfile /usr/local/haproxy/logs/haproxy.pid
defaults
mode http
option redispatch
option abortonclose
timeout connect 5000ms
timeout client 30000ms
timeout server 30000ms
log 127.0.0.1 local0 err
balance roundrobin
# 統計頁面
listen admin_stats
bind 0.0.0.0:8888
option httplog
stats refresh 30s
stats uri /stats
stats realm Haproxy Manager
stats auth admin:admin
# TCP 模式範例
listen test1
bind :12345
mode tcp
server t1 192.168.1.101:8881
server t2 192.168.1.102:8881
# HTTP 模式範例 (含健檢、權重、連線限制)
listen test2 :80
option httpclose
option forwardfor
server s1 192.168.1.101:8080 check weight 1 minconn 1 maxconn 3 inter 40000
server s2 192.168.1.102:8080 check weight 1 minconn 1 maxconn 3 inter 40000
# 前景測試
/usr/local/haproxy/sbin/haproxy -f /usr/local/haproxy/haproxy.cfg -c # 語法檢查
/usr/local/haproxy/sbin/haproxy -f /usr/local/haproxy/haproxy.cfg # 啟動
# 查看進程
ps -ef | grep haproxy | grep -v grep
/etc/rc.d/init.d/haproxy#!/bin/bash
#chkconfig: 2345 10 90
#description: HAProxy Load Balancer
BASE_DIR="/usr/local/haproxy"
PID_FILE="$BASE_DIR/logs/haproxy.pid"
CONFIG_FILE="$BASE_DIR/haproxy.cfg"
start() {
echo "Starting HAProxy..."
$BASE_DIR/sbin/haproxy -f $CONFIG_FILE
}
stop() {
echo "Stopping HAProxy..."
# 優雅關閉:先停止接收新連線,再終止進程
kill -TTOU $(cat $PID_FILE 2>/dev/null) 2>/dev/null
kill -USR1 $(cat $PID_FILE 2>/dev/null) 2>/dev/null
}
case "$1" in
start) start ;;
stop) stop ;;
restart) stop; start ;;
*) echo "Usage: $0 {start|stop|restart}"; exit 1 ;;
esac
chmod +x /etc/rc.d/init.d/haproxy
chkconfig --add haproxy
chkconfig haproxy on
service haproxy start
關鍵點:腳本開頭必須包含 #chkconfig: 2345 10 90 (啟動等級 2/3/4/5,啟動優先序 10,關機優先序 90),否則 chkconfig --add 會報錯 service haproxy does not support chkconfig。
# /etc/haproxy/haproxy.conf
global
log 127.0.0.1 local3
...
defaults
log global
option httplog
option dontlognull
...
/etc/rsyslog.d/haproxy.conf$ModLoad imudp
$UDPServerRun 514
local3.* /var/log/haproxy.log
&~ # 停止後續處理,避免重複寫入 /var/log/messages
# /etc/sysconfig/rsyslog
SYSLOGD_OPTIONS="-c 2 -r -m 0"
# -c 2 相容模式,-r 開啟 UDP 514,-m 0 關閉時間標記
/etc/init.d/rsyslog restart
/etc/init.d/haproxy restart
舊版 /etc/rsyslog.conf 不支援 $IncludeConfig,需直接編輯主檔:
*.info;mail.none;authpriv.none;cron.none;local3.none /var/log/messages
local3.* /var/log/haproxy.log
完成上述步驟,即擁有一套具備統計監控、健康檢查、HTTP/TCP 多模式代理、完整日誌記錄且可隨系統啟動的 HAProxy 叢集入口。後續可依業務擴充 ACL 規則、SSL 卸載、Sticky Session 等進階功能。