worker_processes и worker_connections в nginx: сколько процессов и соединений

Что значат эти настройки

«По умолчанию» — значение, если строки в файле нет. Значения по умолчанию на этой странице — для nginx 1.24 из Ubuntu 24.04. Версию на сервере покажет nginx -v.

worker_processes: сколько процессов

nginx работает несколькими процессами. Главный (master process) читает и проверяет настройки и управляет остальными, он запущен от root. Запросы посетителей обрабатывают рабочие процессы (worker process) — в Ubuntu они работают от пользователя www-data.

Со значением auto nginx запускает столько рабочих процессов, сколько у сервера ядер процессора. Справка nginx советует: если не знаете, какое число выбрать, начните с числа ядер — auto определяет его само. Сколько ядер у сервера, покажет команда nproc.

Проверить, сколько процессов запущено: ps -C nginx -o user,args. В ответе есть строка со словами master process от root и по строке worker process от www-data на каждый рабочий процесс.

worker_connections: сколько соединений

worker_connections — сколько соединений одновременно может держать один рабочий процесс. В это число входят не только посетители, но и соединения nginx с приложением или PHP-FPM, а также открытые соединения браузеров, которые ждут следующего запроса.

Всего nginx удержит до worker_processes × worker_connections соединений. На сервере с двумя ядрами и настройками Ubuntu: 2 × 768 = 1536. Если сайт передаёт запросы приложению или PHP-FPM, каждый такой запрос занимает два соединения: от посетителя к nginx и от nginx к приложению.

Когда свободных соединений остаётся мало, nginx закрывает те, что простаивают. Если свободных не осталось совсем, новое соединение nginx сразу закрывает, а в журнал ошибок пишет строку worker_connections are not enough.

Как увеличить worker_connections

1. Откройте главный файл настроек: sudo nano /etc/nginx/nginx.conf. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter.
2. В блоке events поменяйте число в строке worker_connections, например на 2048.
3. После строки worker_processes добавьте строку worker_rlimit_nofile 4096; — зачем она.
4. Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их: sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены.
5. Проверьте лимит рабочего процесса: grep 'open files' /proc/$(pgrep -u www-data -n nginx)/limits. В строке Max open files первые два числа — текущий и предельный лимит: оба должны стать 4096.

Начало файла после правки:

user www-data;
worker_processes auto;
worker_rlimit_nofile 4096;
pid /run/nginx.pid;
error_log /var/log/nginx/error.log;
include /etc/nginx/modules-enabled/*.conf;

events {
    worker_connections 2048;
    # multi_accept on;
}

worker_rlimit_nofile берите с запасом, например вдвое больше worker_connections: рабочему процессу нужны не только соединения, но и открытые файлы — страницы, картинки, журналы.

Лимит открытых файлов

Для Linux каждое соединение — открытый файл. Сколько файлов может открыть процесс, задаёт лимит открытых файлов. nginx в Ubuntu запускает systemd, а в файле службы nginx.service свой лимит не задан. Поэтому действует лимит systemd по умолчанию — 1024 открытых файла на процесс.

Если worker_connections больше этого лимита, nginx упрётся в лимит файлов раньше, чем в число соединений. В журнале ошибок появятся строки accept4() failed (24: Too many open files), и nginx ненадолго перестанет принимать новые соединения.

Строка worker_rlimit_nofile поднимает этот лимит для рабочих процессов nginx. Перезапускать nginx не нужно, хватит reload: рабочие процессы запустятся заново уже с новым лимитом.

Где писать эти строки

В файлах сайтов и в блоках http и server эти строки писать нельзя: nginx -t ответит, что директива здесь не разрешена, — разбор ошибки.

Ошибки и как их исправить