萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

HAProxy 完整部署指南:從原始碼編譯、核心配置到日誌與啟動腳本實作

前言

HAProxy 是高效能、支援 TCP/HTTP (Layer 4/7) 的負載平衡器與反向代理,廣泛用於高流量網站架構。本文記錄在 CentOS 環境下,從原始碼編譯安裝 HAProxy 1.4.24,撰寫 haproxy.cfg 核心配置 (global、defaults、frontend/backend/listen)、建立 System V 啟動腳本並整合 chkconfig,至 rsyslog 日誌整合的完整流程。

一、HAProxy 核心概念

  • 高可用性:健康檢查、自動故障轉移
  • 負載均衡演算法:Round Robin、Leastconn、Source IP Hash 等
  • Layer 4 (TCP) / Layer 7 (HTTP) 代理:可依 HTTP Header、URL、Cookie 導流
  • 虛擬主機支援:單一 IP 承載多域名
  • 輕量高併發:單機輕鬆支撐萬級並發連線

二、原始碼編譯安裝

# 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 詳細解析

配置結構分五大區塊 (非皆必需):

  1. global:進程級參數 (chroot、uid/gid、daemon、pidfile、nbproc 等)
  2. defaults:預設值繼承給 frontend/backend/listen
  3. frontend:前端接收請求,可依 ACL 動態選擇 backend
  4. backend:後端真實伺服器叢集定義
  5. listen:frontend + backend 合體,簡單場景適用

範例配置 (關鍵段落)

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

五、建立 System V 啟動腳本 /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。

六、rsyslog 日誌整合 (CentOS 6.x 範例)

1. HAProxy 端開啟日誌

# /etc/haproxy/haproxy.conf
global
    log 127.0.0.1 local3
    ...
defaults
    log global
    option httplog
    option dontlognull
    ...

2. 建立 rsyslog 專屬規則 /etc/rsyslog.d/haproxy.conf

$ModLoad imudp
$UDPServerRun 514
local3.* /var/log/haproxy.log
&~  # 停止後續處理,避免重複寫入 /var/log/messages

3. 啟用 rsyslog 遠端接收

# /etc/sysconfig/rsyslog
SYSLOGD_OPTIONS="-c 2 -r -m 0"
# -c 2 相容模式,-r 開啟 UDP 514,-m 0 關閉時間標記

4. 重啟服務

/etc/init.d/rsyslog restart
/etc/init.d/haproxy restart

CentOS 5.x 差異

舊版 /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 等進階功能。

copyright © 萬盛學電腦網 all rights reserved