Таймауты в nginx: сколько ждать посетителя, PHP и приложение
Таймаут в nginx — это время, которое сервер ждёт: посетителя, пока тот присылает запрос, или PHP и приложение, пока они готовят ответ. Если время вышло, nginx закрывает соединение или отвечает ошибкой 504.
Содержание 10
Что сделать прямо сейчас
- Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Посмотрите, какие таймауты заданы на сервере:
sudo nginx -T | grep timeout. Если команда ничего не вывела, действуют значения по умолчанию из таблиц ниже. - Найдите в журнале ошибок, что случилось:
sudo tail -n 50 /var/log/nginx/error.log. Строки с timed out ищите в таблице ошибок. - Меняйте только тот таймаут, который сработал, и только для адреса, где он нужен — где писать.
Таймауты для посетителя
| Директива | По умолчанию | Что ограничивает | Что будет |
|---|---|---|---|
client_header_timeout | 60 секунд | время на весь заголовок запроса | код 408 в журнале |
client_body_timeout | 60 секунд | паузу между двумя порциями тела запроса — формы или файла | код 408 в журнале |
send_timeout | 60 секунд | паузу между двумя порциями ответа посетителю | nginx закроет соединение |
keepalive_timeout | 75 секунд | сколько держать открытым соединение после ответа | nginx закроет соединение |
Первые три таймаута считают не всю передачу, а паузу. Файл может загружаться полчаса, и 408 не будет, пока данные идут без остановок дольше минуты. Подробнее — ошибка 408.
Через одно открытое соединение браузер загружает страницу, картинки и стили. keepalive_timeout задаёт, сколько ждать следующего запроса по нему. 0 выключает такие соединения. В nginx.conf из пакета Ubuntu 24.04 строки keepalive_timeout нет, поэтому действуют 75 секунд. Ещё два ограничения: не больше 1000 запросов и не дольше часа на одно соединение — директивы keepalive_requests и keepalive_time.
Таймауты для PHP и приложений
| Директива | По умолчанию | Что ограничивает |
|---|---|---|
fastcgi_connect_timeout | 60 секунд | подключение к PHP-FPM |
fastcgi_read_timeout | 60 секунд | паузу между двумя порциями ответа PHP-FPM |
fastcgi_send_timeout | 60 секунд | паузу при передаче запроса в PHP-FPM |
proxy_connect_timeout | 60 секунд | подключение к приложению из proxy_pass |
proxy_read_timeout | 60 секунд | паузу между двумя порциями ответа приложения |
proxy_send_timeout | 60 секунд | паузу при передаче запроса приложению |
Если таймаут вышел, посетитель получит ошибку 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 — часы.
Чтобы изменить таймаут:
- Откройте файл сайта:
sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажетls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter. - Вставьте строку в нужный блок, перед его закрывающей скобкой «}».
- Сохраните файл — 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 upstream | PHP или приложение не ответили за 60 секунд — ускорьте запрос или поднимите таймаут |
504, в журнале … while connecting to upstream | не удалось подключиться к PHP-FPM или приложению: поднимать таймаут бесполезно — проверьте, что оно запущено |
| 408 в журнале доступа на адресе загрузки | посетитель передаёт файл с паузами дольше минуты — разбор |
| 499 в журнале доступа | посетитель не дождался ответа — разбор |
nginx -t: directive is not allowed here | строка стоит не в том блоке — разбор |
| после правки ничего не изменилось | строка в другом блоке location или не выполнен reload — как проверить |
Источники
- Документация nginx: директивы keepalive_timeout, client_header_timeout, client_body_timeout и send_timeout — что каждая ограничивает и где её писать.
- Исходный код nginx 1.24.0: ngx_http_core_module.c — значения по умолчанию в 1.24: client_header_timeout, client_body_timeout и send_timeout 60 секунд, keepalive_timeout 75 секунд, keepalive_requests 1000, keepalive_time 1 час.
- Документация nginx: директивы fastcgi_connect_timeout, fastcgi_send_timeout и fastcgi_read_timeout — по 60 секунд, считаются между двумя операциями чтения или записи.
- Документация nginx: директивы proxy_connect_timeout, proxy_send_timeout и proxy_read_timeout — по 60 секунд, считаются между двумя операциями чтения или записи.
- Файл nginx.conf из пакета nginx в Ubuntu 24.04 — строки keepalive_timeout и других таймаутов в файле нет.
Сверено 23 октября 2026 года.
Что почитать дальше
- Ошибка 504 Gateway Timeoutвсе причины по строкам журнала.
- Ошибка 408 Request Timeoutкогда посетитель не успел.
- Код 499 в nginxпосетитель закрыл соединение.
- proxy_pass в nginxпередача запросов приложению.
- nginx и PHP-FPMблок для PHP.
- Настройки nginxкак устроены файлы и блоки, главные директивы.