Поиск
Справочник

Таймауты в nginx: сколько ждать посетителя, PHP и приложение

Таймаут в nginx — это время, которое сервер ждёт: посетителя, пока тот присылает запрос, или PHP и приложение, пока они готовят ответ. Если время вышло, nginx закрывает соединение или отвечает ошибкой 504.

≈ 7 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
  2. Посмотрите, какие таймауты заданы на сервере: sudo nginx -T | grep timeout. Если команда ничего не вывела, действуют значения по умолчанию из таблиц ниже.
  3. Найдите в журнале ошибок, что случилось: sudo tail -n 50 /var/log/nginx/error.log. Строки с timed out ищите в таблице ошибок.
  4. Меняйте только тот таймаут, который сработал, и только для адреса, где он нужен — где писать.

Таймауты для посетителя

ДирективаПо умолчаниюЧто ограничиваетЧто будет
client_header_timeout60 секундвремя на весь заголовок запросакод 408 в журнале
client_body_timeout60 секундпаузу между двумя порциями тела запроса — формы или файлакод 408 в журнале
send_timeout60 секундпаузу между двумя порциями ответа посетителюnginx закроет соединение
keepalive_timeout75 секундсколько держать открытым соединение после ответаnginx закроет соединение

Первые три таймаута считают не всю передачу, а паузу. Файл может загружаться полчаса, и 408 не будет, пока данные идут без остановок дольше минуты. Подробнее — ошибка 408.

Через одно открытое соединение браузер загружает страницу, картинки и стили. keepalive_timeout задаёт, сколько ждать следующего запроса по нему. 0 выключает такие соединения. В nginx.conf из пакета Ubuntu 24.04 строки keepalive_timeout нет, поэтому действуют 75 секунд. Ещё два ограничения: не больше 1000 запросов и не дольше часа на одно соединение — директивы keepalive_requests и keepalive_time.

Таймауты для PHP и приложений

ДирективаПо умолчаниюЧто ограничивает
fastcgi_connect_timeout60 секундподключение к PHP-FPM
fastcgi_read_timeout60 секундпаузу между двумя порциями ответа PHP-FPM
fastcgi_send_timeout60 секундпаузу при передаче запроса в PHP-FPM
proxy_connect_timeout60 секундподключение к приложению из proxy_pass
proxy_read_timeout60 секундпаузу между двумя порциями ответа приложения
proxy_send_timeout60 секундпаузу при передаче запроса приложению

Если таймаут вышел, посетитель получит ошибку 504. Скрипт, который думает дольше минуты и ничего не отдаёт, упрётся в fastcgi_read_timeout или proxy_read_timeout. Сначала найдите, почему он медленный, — как найти медленные скрипты PHP.

Где писать

Все таймауты из таблиц, кроме client_header_timeout, можно писать в блоках http, server и location. client_header_timeout — только в http и server. Задавайте таймаут там, где он нужен:

location /admin/export {
    proxy_pass http://127.0.0.1:3000;
    proxy_read_timeout 300s;
}

Здесь пять минут ждут только адрес выгрузки, остальные адреса — 60 секунд. Для PHP строка fastcgi_read_timeout 120s; пишется в блок location ~ \.php$ — пример по шагам. Единицы: s — секунды, m — минуты, h — часы.

Чтобы изменить таймаут:

  1. Откройте файл сайта: sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажет ls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter.
  2. Вставьте строку в нужный блок, перед его закрывающей скобкой «}».
  3. Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их: sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены.

Если проверка нашла ошибку, nginx назовёт файл и номер строки, а сайт продолжит работать на старых настройках. Что значит сообщение — Все ошибки nginx.

Если ответ ждёт ещё и PHP, его время ограничивает max_execution_time в настройках PHP-FPM — почему PHP не останавливает скрипт сам.

Загрузка больших файлов

Для загрузки важны две настройки: размер — client_max_body_size, по умолчанию 1 МБ, и пауза — client_body_timeout. Больше размера — ошибка 413: как поднять лимит. Связь замирает дольше минуты — 408: что делать.

Посетитель не дождался: 499

Код 499 в журнале доступа — посетитель закрыл вкладку или программа оборвала запрос раньше, чем nginx получил ответ от PHP или приложения. Таймауты nginx тут ни при чём: ответ готовится дольше, чем посетитель готов ждать — откуда берутся 499.

Как проверить

После reload посмотрите, какое значение действует:

sudo nginx -T | grep -n timeout

Команда покажет строки из всех файлов настроек. Если одна директива встречается в nginx.conf и в файле сайта, для адресов сайта действует строка из файла сайта, а из блока location — сильнее, чем из блока server. Затем откройте долгий адрес и посмотрите журнал ошибок: записи timed out для него быть не должно.

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

Что видитеЧто делать
504, в журнале upstream timed out (110: Connection timed out) while reading response header from upstreamPHP или приложение не ответили за 60 секунд — ускорьте запрос или поднимите таймаут
504, в журнале … while connecting to upstreamне удалось подключиться к PHP-FPM или приложению: поднимать таймаут бесполезно — проверьте, что оно запущено
408 в журнале доступа на адресе загрузкипосетитель передаёт файл с паузами дольше минуты — разбор
499 в журнале доступапосетитель не дождался ответа — разбор
nginx -t: directive is not allowed hereстрока стоит не в том блоке — разбор
после правки ничего не изменилосьстрока в другом блоке location или не выполнен reload — как проверить

Источники

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше