KeepAlive и Timeout в Apache: сколько сервер ждёт посетителя
Четыре строки в apache2.conf решают, сколько Apache ждёт посетителя: следующего запроса по тому же соединению, данных от него и подтверждения, что ответ дошёл. Ещё один модуль, reqtimeout, ограничивает время на присылку самого запроса. Здесь — что значат эти числа после установки и когда их менять.
Содержание 11
- Что сделать прямо сейчас
- Что значат строки
- KeepAlive: одно соединение на несколько запросов
- KeepAliveTimeout: сколько ждать следующего запроса
- Timeout: сколько ждать данных
- RequestReadTimeout: время на присылку запроса
- Если файлы не загружаются по медленной сети
- Как увидеть, что сработал reqtimeout
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите текущие значения:
grep -n -E '^(Timeout|KeepAlive|MaxKeepAliveRequests|KeepAliveTimeout)' /etc/apache2/apache2.confПосле установки ответ — четыре строки с номерами:
Timeout 300,KeepAlive On,MaxKeepAliveRequests 100,KeepAliveTimeout 5. - Проверьте, что Apache держит соединение:
curl -sI -H 'Connection: keep-alive' http://localhost/ | grep -i keep-aliveВ ответе есть строка
Keep-Alive: timeout=5, max=100.
Что значат строки
| Строка | Что значит |
|---|---|
Timeout 300 | сколько секунд Apache ждёт данных от посетителя или подтверждения, что ответ дошёл; в Ubuntu — 300, у самого Apache — 60 |
KeepAlive On | не закрывать соединение после ответа: следующий запрос придёт по нему же |
MaxKeepAliveRequests 100 | сколько запросов принять по одному соединению, потом закрыть его; 0 — без предела |
KeepAliveTimeout 5 | сколько секунд ждать следующего запроса по открытому соединению |
Все четыре можно записать и внутри <VirtualHost> — тогда они действуют для этого сайта (VirtualHost).
KeepAlive: одно соединение на несколько запросов
Страница сайта — это сам HTML, стили, скрипты и картинки. С KeepAlive On браузер получает их по одному соединению и не открывает новое на каждый файл, поэтому страница грузится быстрее. Оставьте KeepAlive On.
Заголовок Keep-Alive в ответе Apache отправляет, только если посетитель сам прислал Connection: keep-alive. Браузеры его присылают, а curl -I без -H 'Connection: keep-alive' — нет, поэтому без этой части строки Keep-Alive в ответе не будет. Соединение при этом всё равно остаётся открытым.
В заголовке Keep-Alive: timeout=5, max=100: timeout — значение KeepAliveTimeout, max — сколько запросов ещё можно прислать по этому соединению.
KeepAliveTimeout: сколько ждать следующего запроса
Пока соединение открыто и ждёт, оно занимает место в Apache:
| MPM | Что занято, пока соединение ждёт |
|---|---|
event | ничего: ожидающие соединения держит отдельный поток |
prefork | целый процесс — он не может принять другой запрос |
Какой MPM у вас — a2query -M (MPM в Apache).
С prefork и большим KeepAliveTimeout процессы заняты ожиданием, а новые посетители ждут в очереди. Если в журнале ошибок есть AH00161 (что это), уменьшите KeepAliveTimeout:
- Откройте файл:
sudo nano /etc/apache2/apache2.conf - Найдите строку
KeepAliveTimeout 5(Ctrl+W, введитеKeepAliveTimeout, Enter) и поменяйте число, например на2. Сохраните:Ctrl+O, Enter,Ctrl+X. - Проверьте и примените:
sudo apache2ctl configtest sudo systemctl reload apache2 - Проверьте командой из шага 3 в начале страницы: в ответе
timeout=2.
Можно писать и миллисекунды: KeepAliveTimeout 1500ms — полторы секунды.
Timeout: сколько ждать данных
Timeout — время ожидания одной порции данных, а не всего запроса:
- посетитель присылает запрос или файл, а данные перестали приходить — Apache ждёт столько секунд, потом закрывает соединение;
- Apache отдаёт ответ, а посетитель перестал его принимать — Apache ждёт столько же.
Пока данные идут, Timeout не срабатывает, даже если загрузка большого файла длится дольше 300 секунд.
Сколько может выполняться сам PHP-скрипт, задаёт не Timeout, а max_execution_time в настройках PHP (php_value).
Менять Timeout 300 не нужно, пока нет ошибок, которые к нему ведут.
RequestReadTimeout: время на присылку запроса
Модуль reqtimeout ограничивает, сколько времени посетитель может присылать заголовки и тело запроса. Он включён после установки Apache. Проверить:
ls /etc/apache2/mods-enabled/ | grep reqtimeoutОтвет — reqtimeout.conf и reqtimeout.load.
В файле /etc/apache2/mods-available/reqtimeout.conf:
| Строка | Что значит |
|---|---|
RequestReadTimeout header=20-40,minrate=500 | на заголовки запроса 20 секунд; пока данные идут не медленнее 500 байт в секунду, срок растёт, но не дольше 40 секунд |
RequestReadTimeout body=10,minrate=500 | на тело запроса, например загружаемый файл, 10 секунд; пока данные идут не медленнее 500 байт в секунду, срок растёт без предела |
Если посетитель не уложился, Apache отвечает кодом 408 и закрывает соединение. Так модуль не даёт медленным запросам надолго занимать процессы и потоки Apache.
Если файлы не загружаются по медленной сети
Если файл на сайт загружают медленнее 500 байт в секунду, срок из body=10 растёт медленнее, чем идёт время, и reqtimeout оборвёт загрузку. Дайте больше времени:
- Откройте файл:
sudo nano /etc/apache2/mods-available/reqtimeout.conf - В строке
RequestReadTimeout body=10,minrate=500поменяйте10, например на30. - Проверьте и примените:
sudo apache2ctl configtest sudo systemctl reload apache2
Размер файла, который принимает PHP, задают upload_max_filesize и post_max_size (php_value).
Как увидеть, что сработал reqtimeout
Строки модуля Apache пишет на уровне info, а после установки стоит LogLevel warn — их не видно. Включите их только для этого модуля:
- В
/etc/apache2/apache2.confпоменяйтеLogLevel warnна:LogLevel warn reqtimeout:info sudo apache2ctl configtestиsudo systemctl reload apache2.- Смотрите:
sudo grep AH01382 /var/log/apache2/error.log | tail -n 5
| Строка | Что значит |
|---|---|
AH01382: Request header read timeout | заголовки не пришли вовремя |
AH01382: Request body read timeout | тело запроса, например файл, не пришло вовремя |
Когда разберётесь, верните LogLevel warn (уровни журнала).
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
curl -I не показывает Keep-Alive | запрос без Connection: keep-alive | добавьте -H 'Connection: keep-alive'; соединение открыто и без этого |
после правки KeepAliveTimeout в ответе старое число | не было reload или настройка записана в файле сайта | grep -rn KeepAliveTimeout /etc/apache2/, reload |
AH00161 в журнале, сервер с prefork | процессы заняты ожиданием | уменьшите KeepAliveTimeout и проверьте MaxRequestWorkers (MPM) |
AH01382: Request body read timeout | файл загружали медленно | поднимите body= в reqtimeout.conf |
в журнале запросов строки с кодом 408 | соединение открыли, но не прислали запрос вовремя | для сайта это не ошибка, менять ничего не нужно |
AH01382 не появляется в журнале | LogLevel warn | LogLevel warn reqtimeout:info и reload |
Всё сверено с Apache 2.4.58 из пакета Ubuntu 24.04.
Источники
- Директива TimeOut — на английском: чего ждёт Apache.
- Директива KeepAlive — на английском: долгие соединения.
- Директива KeepAliveTimeout — на английском: ожидание следующего запроса.
- Директива MaxKeepAliveRequests — на английском: запросы на одно соединение.
- Модуль mod_reqtimeout — на английском: RequestReadTimeout и MinRate.
- Пакет apache2 в Debian: reqtimeout.conf — значения после установки.
- Пакет apache2 в Debian: apache2.conf — Timeout и KeepAlive.
Сверено 9 ноября 2026 года.
Что почитать дальше
- MPM в Apacheevent, prefork и MaxRequestWorkers.
- Журналы Apacheгде искать строки AH01382.
- Настройки Apacheвсе настройки на одной странице.