HAProxy — эталонный балансировщик нагрузки с открытым кодом: он распределяет трафик между несколькими серверами, автоматически исключает упавшие бэкенды и выдерживает десятки тысяч соединений на скромном железе. Правильная настройка HAProxy превращает набор одиночных серверов в отказоустойчивый кластер, где выход одного узла из строя незаметен для пользователей. В этом руководстве пройдём путь от установки до боевого конфига: алгоритмы балансировки, проверки здоровья, липкие сессии, HTTPS и страница статистики. Все примеры — для Ubuntu 22.04/24.04.
Как работает балансировка нагрузки
Схема классическая: HAProxy принимает все входящие запросы на одном IP-адресе (frontend) и распределяет их по списку серверов (backend). Каждый бэкенд регулярно проверяется health check'ом; если сервер перестал отвечать, HAProxy молча выводит его из ротации и возвращает обратно после восстановления.
Балансировщик решает сразу три задачи:
- Масштабирование — нагрузка делится между узлами, и добавление сервера в пул увеличивает общую ёмкость.
- Отказоустойчивость — падение одного бэкенда не роняет сервис, трафик перетекает на живые узлы.
- Обслуживание без даунтайма — узлы можно по одному выводить из ротации, обновлять и возвращать.
HAProxy работает в двух режимах: mode http (разбирает HTTP, умеет маршрутизацию по заголовкам и путям) и mode tcp (прозрачно балансирует любой TCP-трафик — базы данных, брокеры сообщений, произвольные протоколы).
Установка HAProxy
В репозиториях Ubuntu лежит стабильная версия — для большинства задач её достаточно:
# Устанавливаем HAProxy из стандартного репозитория
sudo apt update && sudo apt install -y haproxy
# Проверяем версию и включаем автозапуск
haproxy -v
sudo systemctl enable --now haproxy
Откроем нужные порты в файрволе:
# 80/443 — трафик, 8404 — страница статистики (позже ограничим доступ)
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 8404/tcp
Весь конфиг живёт в одном файле — /etc/haproxy/haproxy.cfg. Перед каждым применением проверяйте синтаксис:
# Валидация конфига без запуска
sudo haproxy -c -f /etc/haproxy/haproxy.cfg
# Применение без обрыва существующих соединений
sudo systemctl reload haproxy
Базовый конфиг: frontend и backend
Допустим, у нас три сервера приложений — 10.0.0.11, 10.0.0.12 и 10.0.0.13, каждый слушает порт 8080. Балансируем HTTP-трафик между ними:
# /etc/haproxy/haproxy.cfg
global
log /dev/log local0
maxconn 20000
user haproxy
group haproxy
daemon
defaults
log global
mode http
option httplog
option dontlognull
timeout connect 5s
timeout client 30s
timeout server 30s
retries 3
frontend web_in
bind *:80
default_backend app_pool
backend app_pool
balance roundrobin
option httpchk GET /health
http-check expect status 200
server app1 10.0.0.11:8080 check inter 2s fall 3 rise 2
server app2 10.0.0.12:8080 check inter 2s fall 3 rise 2
server app3 10.0.0.13:8080 check inter 2s fall 3 rise 2
Разберём ключевые строки:
maxconn 20000— глобальный потолок одновременных соединений; страхует от исчерпания памяти при наплыве.option httpchk GET /health— вместо простой проверки TCP-порта HAProxy запрашивает у приложения эндпоинт/healthи ждёт ответ 200. Порт может быть открыт, а приложение — мертво; HTTP-проверка это ловит.check inter 2s fall 3 rise 2— проверка каждые 2 секунды; после 3 провалов сервер выводится из ротации, после 2 успехов — возвращается.retries 3— если соединение с бэкендом не удалось, HAProxy молча попробует другой узел, и клиент ошибки не увидит.
Алгоритмы балансировки
Директива balance определяет, как выбирается сервер для очередного запроса. Основные варианты:
| Алгоритм | Как работает | Когда выбирать |
|---|---|---|
roundrobin | По кругу, с учётом весов | Однотипные запросы и равные серверы — разумный дефолт |
leastconn | Серверу с наименьшим числом активных соединений | Долгие неравномерные запросы: API, отчёты, вебсокеты |
source | По хэшу IP клиента | Простейшая привязка клиента к серверу без cookie |
uri | По хэшу запрошенного URI | Кэширующие бэкенды: один URL всегда на одном узле |
Серверам можно задавать вес — полезно, когда узлы разной мощности:
backend app_pool
balance roundrobin
# app1 получит вдвое больше запросов, чем app2
server app1 10.0.0.11:8080 check weight 200
server app2 10.0.0.12:8080 check weight 100
# backup включается, только если все основные узлы упали
server spare 10.0.0.14:8080 check backup
Sticky sessions: привязка клиента к серверу
Если приложение хранит сессии в памяти процесса, запросы одного пользователя должны попадать на один и тот же узел. HAProxy решает это вставкой собственной cookie:
backend app_pool
balance roundrobin
cookie SRVID insert indirect nocache
server app1 10.0.0.11:8080 check cookie a1
server app2 10.0.0.12:8080 check cookie a2
server app3 10.0.0.13:8080 check cookie a3
При первом запросе HAProxy выберет сервер по алгоритму и выдаст клиенту cookie SRVID; все последующие запросы с этой cookie пойдут на тот же узел. Параметры indirect nocache не дают cookie утечь на бэкенд и закэшироваться по пути. Липкие сессии стоит рассматривать как временную меру: архитектурно правильнее вынести сессии в Redis и балансировать свободно.
HTTPS: терминирование TLS на балансировщике
Обычная схема — сертификат живёт на HAProxy, к бэкендам трафик идёт по HTTP во внутренней сети. HAProxy ждёт сертификат и ключ в одном PEM-файле:
# Получаем сертификат certbot'ом в standalone-режиме (порт 80 должен быть свободен)
sudo systemctl stop haproxy
sudo apt install -y certbot
sudo certbot certonly --standalone -d example.com
# Склеиваем полную цепочку и приватный ключ в формат HAProxy
sudo mkdir -p /etc/haproxy/certs
sudo bash -c 'cat /etc/letsencrypt/live/example.com/fullchain.pem \
/etc/letsencrypt/live/example.com/privkey.pem \
> /etc/haproxy/certs/example.com.pem'
sudo chmod 600 /etc/haproxy/certs/example.com.pem
sudo systemctl start haproxy
Как устроен выпуск и продление сертификатов Let's Encrypt, мы подробно разбирали в статье про SSL-сертификат Let's Encrypt — для HAProxy меняется только последний шаг со склейкой PEM. Обновляем frontend:
frontend web_in
bind *:80
bind *:443 ssl crt /etc/haproxy/certs/example.com.pem
# Принудительный редирект HTTP -> HTTPS
http-request redirect scheme https unless { ssl_fc }
# Передаём бэкенду реальный IP и протокол
http-request set-header X-Forwarded-For %[src]
http-request set-header X-Forwarded-Proto https if { ssl_fc }
default_backend app_pool
После продления сертификата не забывайте пересобирать PEM и делать systemctl reload haproxy — это удобно повесить в deploy-hook certbot'а.
Страница статистики и вывод узлов из ротации
Встроенный дашборд HAProxy показывает состояние каждого бэкенда, число соединений, ошибки и времена ответа:
listen stats
bind *:8404
mode http
stats enable
stats uri /stats
stats refresh 5s
stats auth admin:СЛОЖНЫЙ_ПАРОЛЬ
stats admin if TRUE
Открыв http://IP-сервера:8404/stats, вы увидите таблицу пулов; с stats admin узлы можно переводить в maintenance прямо из браузера — удобно для выкаток без даунтайма. Пароль обязателен, а ещё лучше дополнительно закрыть порт 8404 файрволом по IP:
# Доступ к статистике только с вашего IP
sudo ufw delete allow 8404/tcp
sudo ufw allow from 203.0.113.10 to any port 8404 proto tcp
TCP-режим: балансировка не-HTTP трафика
Для баз данных и других протоколов используется mode tcp — HAProxy не заглядывает внутрь трафика, а просто распределяет соединения:
listen postgres_pool
bind *:5432
mode tcp
balance leastconn
option tcp-check
server db1 10.0.0.21:5432 check inter 3s
server db2 10.0.0.22:5432 check inter 3s backup
Здесь второй узел помечен backup: трафик идёт на db1, а db2 подхватывает его только при падении основного — типовая схема для реплики.
Кстати, если балансировать нужно не серверы, а пару локальных приложений на одном VPS, полноценный HAProxy может быть избыточен — часто хватает связки из nginx в роли reverse proxy. HAProxy раскрывается, когда бэкендов несколько и важна отказоустойчивость. Сами бэкенды при этом удобно держать в контейнерах — см. статью про Docker на VPS.
Частые вопросы
Чем HAProxy отличается от балансировки в nginx?
Nginx — это в первую очередь веб-сервер, который умеет балансировать; HAProxy — специализированный балансировщик. У HAProxy богаче алгоритмы, точнее health checks, детальная страница статистики и возможность управлять узлами на лету через Runtime API. Если нужно раздавать статику и проксировать пару приложений — хватит nginx; если строится отказоустойчивый кластер — HAProxy на своём месте.
Что произойдёт, если один из бэкендов упадёт?
Health check провалится заданное число раз (fall 3), и HAProxy выведет узел из ротации — новые запросы пойдут на оставшиеся серверы. Благодаря retries даже запросы, попавшие на умирающий узел, будут прозрачно повторены на живом. После восстановления сервер вернётся в пул автоматически, когда наберёт rise 2 успешных проверок.
Какой алгоритм балансировки выбрать?
Начинайте с roundrobin — он предсказуем и подходит для однотипных запросов. Если запросы сильно различаются по длительности (тяжёлые API-вызовы, вебсокеты), переходите на leastconn, чтобы медленные запросы не скапливались на одном узле. source и cookie-привязку используйте только когда сессии нельзя вынести из памяти приложения.
Остаётся ли балансировщик единой точкой отказа?
Да, сам HAProxy тоже может упасть, поэтому в критичных системах ставят два балансировщика с общим виртуальным IP через keepalived (протокол VRRP): при падении основного IP-адрес за секунды переезжает на резервный. Для большинства проектов на старте достаточно одного HAProxy — он чрезвычайно стабилен, а аптайм площадки Cheap-Host составляет 99,9%.
Сколько ресурсов нужно HAProxy?
Сам по себе он очень лёгкий — тысячи соединений обрабатываются на одном ядре. Но балансировщик — это входная точка всего трафика проекта: запас по CPU и памяти нужен на пиковые наплывы, TLS-хендшейки и рост числа бэкендов, поэтому экономить на этой машине не стоит.
Вместо заключения
HAProxy закрывает вопрос балансировки нагрузки на годы вперёд: один конфиг — и ваш сервис переживает падения узлов, обновляется без даунтайма и масштабируется добавлением строчки server. Под входную точку кластера логично взять запас мощности — тариф Ultra от Cheap-Host даёт 20 vCPU, 32 ГБ RAM и 192 ГБ NVMe за 1500 ₽/мес на KVM в Москве: хватит и на TLS-терминирование под пиковым трафиком, и на соседние сервисы. Сервер выдаётся за 45–60 секунд — выбрать тариф можно здесь.