Weight, backup и down в upstream Nginx: настройка приоритетов бэкендов с примерами конфигов | AdminWiki

Weight, backup и down в upstream Nginx: настройка приоритетов бэкендов с примерами конфигов

08 ноября 2026 10 мин. чтения

weight в блоке upstream задаёт долю запросов, которую получает сервер. backup держит сервер вне ротации, пока живы основные, и включает его при отказе. down выводит сервер из балансировки, не удаляя строку из конфига. Три параметра решают три разные задачи, и на одной директиве server они спокойно уживаются: server 10.0.0.13:8080 weight=2 backup.

Дальше разбираем синтаксис и логику выбора сервера, пропорции весов под разную мощность железа, настройку горячего резерва, плановое обслуживание через down, сочетание весов с least_conn и проверку фактического распределения по логам через $upstream_addr.

ПараметрЧто делаетКогда использовать
weight=NЗадаёт долю запросов в ротацииСерверы разной мощности, плавное масштабирование
backupДержит сервер вне ротации до отказа основныхГорячий резерв, схема N+1
downПолностью исключает сервер из балансировкиПлановые работы, отладка нового бэкенда

Зачем управлять приоритетами бэкендов в upstream

По умолчанию Nginx раздаёт запросы по кругу равными долями. Три сервера в upstream получат примерно по трети трафика, даже если один из них вдвое слабее остальных. Слабый бэкенд первым упирается в лимиты по CPU и числу соединений, время ответа растёт, а балансировщик продолжает слать на него ту же долю. Так в пиковые часы появляются 502 и 504.

Приоритеты закрывают три практические задачи:

  • выровнять нагрузку под разную мощность железа, чтобы слабая машина не определяла скорость всего пула;
  • держать горячий резерв, который не расходует ресурсы в обычном режиме;
  • выводить сервер на обслуживание без переписывания location и без удаления строки из конфига.

Все три параметра записываются внутри блока upstream на директиве server. Их место именно там: в location или на строке proxy_pass они не работают.

Три параметра, три задачи

weight работает постоянно, на каждом цикле ротации. backup молчит до момента, когда основных серверов не осталось. down действует сразу и безусловно. Комбинировать их можно: резерв с весом 2 получит вдвое больше запросов, чем резерв с весом 1, если резервов несколько и они включились одновременно. Значение weight по умолчанию равно 1, поэтому у равноправных серверов параметр можно не писать.

Базовый синтаксис: блок upstream и параметры server

Минимальная рабочая конструкция выглядит так:

upstream backend {
    server 10.0.0.11:8080 weight=3 max_fails=3 fail_timeout=30s;
    server 10.0.0.12:8080 weight=2 max_fails=3 fail_timeout=30s;
    server 10.0.0.13:8080 backup;
}

server {
    listen 80;
    server_name app.example.com;

    location / {
        proxy_pass http://backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Имя блока (здесь backend) должно совпадать с именем в proxy_pass. Параметры директивы server: weight, backup, down, а также max_fails и fail_timeout, которые управляют тем, как быстро Nginx признает сервер недоступным. Перед применением всегда прогоняйте nginx -t: опечатка в имени параметра или лишняя точка с запятой валят конфиг целиком. Обзор proxy_pass и location есть в руководстве по маршрутизации трафика в Nginx.

Как Nginx читает веса и резерв

В режиме round-robin с весами Nginx не отправляет запросы пачками, а чередует их с учётом весов: сервер с weight=3 получает втрое больше запросов за цикл, чем сервер с weight=1. Точную последовательность выдачи на коротком отрезке лучше не предсказывать на бумаге — проверяйте фактическое распределение по логам.

Серверы с backup не участвуют в ротации, пока доступен хотя бы один основной: резерв получает запросы, когда основные серверы недоступны. Параметр down помечает сервер как постоянно недоступный и исключает его из балансировки сразу и без условий, при этом конфиг остаётся валидным, а все прочие параметры сервера сохраняются.

Распределение трафика под разную мощность серверов через weight

Типовая ситуация: два одинаковых сервера по 8 vCPU и один на 2 vCPU. Равная ротация отправит слабой машине треть трафика, и она станет узким местом. Веса выравнивают картину:

upstream backend {
    server 10.0.0.21:8080 weight=4 max_fails=3 fail_timeout=30s;
    server 10.0.0.22:8080 weight=4 max_fails=3 fail_timeout=30s;
    server 10.0.0.23:8080 weight=1 max_fails=3 fail_timeout=30s;
}

Пропорция 4/4/1 означает, что мощные серверы получают примерно по 44% запросов, а слабый около 11%. Консервативный вариант 3/3/1 даёт 43%, 43% и 14%, его удобно ставить первым шагом, если реальная ёмкость слабой машины ещё не измерена.

Как считать пропорцию весов

Правило простое: сумма весов это знаменатель, доля сервера равна его весу, делённому на сумму. Пять серверов с весами 3/2/2/1/1 дают сумму 9, то есть 33%, 22%, 22%, 11% и 11%.

Состав пулаВесаОжидаемые доли
8 vCPU, 8 vCPU, 2 vCPU4 / 4 / 144% / 44% / 11%
8 vCPU, 8 vCPU, 2 vCPU3 / 3 / 143% / 43% / 14%
Два одинаковых сервера1 / 150% / 50%

Веса задают относительные доли, а не жёсткие лимиты. Запросы разной стоимости (тяжёлый поиск и лёгкий health-эндпоинт) попадают в одну и ту же ротацию, поэтому фактическая нагрузка на CPU может отличаться от процентов в расчёте. Начинайте с консервативных значений, смотрите на CPU, latency и число активных соединений, корректируйте по метрикам. Частый подводный камень: после добавления или вывода сервера сумму весов никто не пересчитывает. Пул из 4/4/1 после удаления одного мощного сервера превращается в 4/1, и слабая машина внезапно получает 20% трафика вместо 11%.

Резервные серверы: backup включается только при отказе основных

Резерв нужен для схемы N+1: пул переживает отказ одного основного сервера без деградации. В обычном режиме backup-сервер не получает ни одного запроса.

upstream backend {
    server 10.0.0.31:8080 weight=3 max_fails=3 fail_timeout=30s;
    server 10.0.0.32:8080 weight=3 max_fails=3 fail_timeout=30s;
    server 10.0.0.33:8080 backup;
}

Трафик уйдёт на резерв только тогда, когда недоступны оба основных. Отказ одного из них просто перераспределит его долю на живого соседа. Скорость реакции определяют max_fails и fail_timeout: если за интервал fail_timeout по серверу набралось max_fails неудачных попыток, сервер помечается недоступным и возвращается в ротацию по истечении интервала. При max_fails=3 и fail_timeout=30s это означает три неудачные попытки в пределах 30 секунд и возврат не раньше чем через 30 секунд.

Важно понимать, что max_fails и fail_timeout — это пассивная реакция на ошибки при попытках проксирования, а не активный health check: open-source Nginx сам не ходит проверять /health, он делает выводы из реального трафика. Отказами обычно считаются ошибки соединения и ответа: не удалось подключиться, соединение сброшено, таймауты при чтении. HTTP-статусы приложения (например, 500) не всегда автоматически становятся «фейлами» для механизма исключения — поведение зависит от сценария и логики повторных попыток, которая настраивается через proxy_next_upstream. Как устроены пассивные и активные проверки, разбираем в материале про health checks и keepalive в upstream.

Сколько резервов держать и как их взвешивать

Резервов может быть несколько, между ними тоже работает ротация и тоже действуют веса. Ориентир по ёмкости: резерв должен выдержать нагрузку при отказе хотя бы одного основного сервера. Резерв на слабой машине приводит к тому, что failover превращается в деградацию: пул формально жив, время ответа выросло втрое.

Проверка включения резерва занимает пару минут. Остановите основной бэкенд, сделайте серию запросов и посмотрите в access.log значение $upstream_addr: там появится адрес резервного сервера. Если его нет, ищите ошибку в конфиге или в определении отказа.

Плановое обслуживание: выводим сервер через down

Порядок действий для вывода бэкенда на обновление:

  1. Добавьте down к нужной строке: server 10.0.0.41:8080 weight=3 down;
  2. Проверьте синтаксис: nginx -t;
  3. Примените конфиг: nginx -s reload;
  4. Убедитесь по логам, что запросы больше не идут на этот адрес;
  5. Проведите работы на сервере;
  6. Уберите down и снова выполните nginx -t и nginx -s reload.

Параметр down не требует удаления сервера из конфига, поэтому weight, backup и прочие настройки остаются на месте. При nginx -s reload мастер-процесс получает сигнал SIGHUP и не обрывает текущие соединения: запускается параллельный набор воркеров с новой конфигурацией, а старые воркеры продолжают работать с предыдущими настройками до завершения своих задач. Старые воркеры перестают принимать новые соединения и переходят в фазу graceful shutdown, ожидая естественного закрытия активных соединений; долгоживущие соединения (long-polling, WebSocket, стриминг) могут задержать этот процесс. Планируйте окно обслуживания с запасом. Механику управляемого завершения разбираем в статье про graceful shutdown и высокую доступность Nginx.

down против удаления из конфига

Удаление строки требует помнить все её параметры, чтобы вернуть сервер в исходном виде. В спешке легко забыть weight или потерять backup, и пул вернётся в прод с другой пропорцией. down это обратимый переключатель в одно слово: правка в две секунды, риск оставить конфиг в неверном состоянии минимален. Держите такие правки в git с комментарием и датой, тогда возврат к прошлому состоянию занимает один revert.

Веса вместе с least_conn: как не сломать балансировку

least_conn выбирает сервер с наименьшим числом активных соединений в момент прихода запроса. weight при этом алгоритме тоже учитывается, но источники расходятся в акцентах: по одной трактовке веса задают пропорцию соединений между адресами (при весах 1 и 5 на адрес с весом 5 попадёт примерно в пять раз больше соединений), по другой — weight влияет в основном на начальное распределение при старте или после восстановления сервера, а дальше выбор идёт по наименьшему числу активных соединений независимо от веса. Практический вывод один: не рассчитывайте картину на бумаге, проверяйте её по логам.

upstream backend {
    least_conn;
    server 10.0.0.51:8080 weight=3 max_fails=3 fail_timeout=30s;
    server 10.0.0.52:8080 weight=2 max_fails=3 fail_timeout=30s;
    server 10.0.0.53:8080 backup;
}

При долгих запросах и резко неравных весах фактическая картина может отличаться от round-robin с теми же цифрами. После любого пересчёта весов снимайте новую картину распределения: старые значения в голове быстро устаревают. Сравнение алгоритмов и готовые конфигурации собраны в материале про алгоритмы балансировки Nginx.

Когда least_conn лучше round-robin с весами

Профиль трафикаМетод
Короткие однородные запросы, стабильное время ответаround-robin с weight
Долгие запросы разной стоимости: отчёты, выгрузки, загрузка файловleast_conn с weight
Сессия хранится в памяти приложения, нужна привязка клиентаip_hash, но лучше вынести сессии в общее хранилище

Меняйте метод с проверкой по метрикам. Переключение least_conn и round-robin туда и обратно без замеров даёт ложное ощущение оптимизации: распределение меняется, а время ответа остаётся прежним.

Проверка результата: логи, upstream_addr и curl

Без логирования адреса апстрима проверить нечего. Добавьте в http-блок отдельный формат:

log_format upstream '$remote_addr [$time_local] "$request" '
                    '$status upstream=$upstream_addr '
                    'up_status=$upstream_status rt=$upstream_response_time';

access_log /var/log/nginx/upstream.log upstream;

Переменные $upstream_addr, $upstream_status, $upstream_response_time (а также $upstream_connect_time и $upstream_header_time) используются в логах Nginx для диагностики апстримов. Если Nginx в рамках одного запроса сходил к нескольким апстримам — из-за ретраев, нескольких upstream-серверов или failover, — значения таких переменных перечисляются через запятую. Серия из 50 запросов и подсчёт по адресам показывают фактическую пропорцию:

for i in $(seq 1 50); do curl -s -o /dev/null http://127.0.0.1/; done

awk '{for(i=1;i<=NF;i++) if ($i ~ /^upstream=/) print substr($i,10)}' /var/log/nginx/upstream.log | sort | uniq -c | sort -rn

Ожидаемая картина для весов 4/4/1 на 50 запросах: примерно 22, 22 и 6 попаданий. Небольшой разброс нормален, ровно 44% на короткой выборке не будет никогда. На результат влияют keepalive-соединения к апстриму и кеш DNS, если в upstream указаны имена хостов вместо IP: держите в конфиге IP-адреса и проверяйте то, что реально прописано.

Чек-лист перед выкладкой в прод

  • nginx -t проходит без ошибок и предупреждений.
  • Сумма весов пересчитана под текущий состав пула.
  • Резерв выдерживает нагрузку при отказе одного основного сервера.
  • down снят со всех серверов после завершения работ.
  • Логирование $upstream_addr включено и пишется в отдельный файл.
  • Распределение проверено серией запросов на стенде, а не только в теории.
  • Правки закоммичены в git с комментарием и датой.

Типичные ошибки и границы применимости

  • Веса не пересчитали после изменения состава пула: доли сместились, а никто этого не заметил.
  • Резерв поставлен на слабую машину: при отказе основного пул формально жив, но время ответа растёт в разы.
  • Ожидание, что down мгновенно оборвёт все соединения: reload оставляет работу старым процессам, а keepalive и WebSocket держат сессии до закрытия.
  • Расчёт на то, что любой ответ 500 гарантированно выведет сервер из ротации: отказом для пассивного механизма обычно служат ошибки соединения и таймауты, а обработка 5xx зависит от настройки proxy_next_upstream.
  • Отсутствие $upstream_addr в логах: результат настройки нельзя ни подтвердить, ни опровергнуть.
  • Один upstream на все location без учёта разной стоимости запросов: статика и тяжёлый API получают одинаковые доли.
  • Попытка решить через веса задачи, для которых есть другие инструменты: привязка сессий, проверка тела ответа, автоматическое восстановление сервера.

weight отвечает за доли, backup за резерв, down за обслуживание. Проверка у всех трёх одна: nginx -t, reload и подсчёт $upstream_addr в логах после серии запросов. Общую схему отказоустойчивого пула с таймаутами и проверками смотрите в материале про отказоустойчивую балансировку и проксирование на Nginx.

Поделиться: