БАЗА ЗНАНИЙ
Ошибка 504 Gateway Time-out: причины и как исправить
Что означает ошибка 504 Gateway Time-out и как её исправить: кто её выдаёт, чей таймаут истёк, что проверить посетителю и владельцу сайта, где смотреть логи и какие лимиты хостинга её вызывают.

Ошибка 504 означает, что сервер не ответил вовремя. Её показывает не сам сайт, а узел перед ним: веб-сервер, прокси или CDN. Поэтому искать причину приходится не там, где кажется на первый взгляд. Ниже разберём, чей именно таймаут истёк, что может сделать посетитель, что владелец сайта, где смотреть логи и почему на дешёвом тарифе такая ошибка появляется чаще.
Что означает ошибка 504
Полное название — 504 Gateway Time-out, по-русски «тайм-аут шлюза». В панелях и браузерах формулировка бывает другой: «время ответа сервера истекло», «сервер не отвечает», «превышено время ожидания». Это одно и то же состояние.
Шлюз здесь — промежуточный узел. Он принял запрос, передал его обработчику и не получил ответ за отведённое время, после чего сообщил об этом посетителю.
Код начинается с пятёрки, значит проблема на стороне сервера: браузер, интернет и настройки устройства посетителя здесь ни при чём. Этим 504 и отличается от ситуации, когда сайт не открывается вообще. Соединение установилось, имя домена разрешилось в адрес, запрос дошёл до сервера — иначе вместо аккуратной страницы с кодом посетитель увидел бы сообщение о недоступности узла. Если вы видите http 504, сеть и DNS свою работу уже сделали, и разбираться нужно внутри сервера.
Где именно рвётся путь запроса и чей таймаут истёк
Между браузером и базой данных стоит несколько узлов, и у каждого свой запас терпения.

Браузер обращается к CDN, если сайт за ним спрятан, CDN передаёт запрос веб-серверу, обычно это Nginx — как он устроен, разобрано в статье что такое Nginx. Страницы Nginx не считает: он отдаёт запрос обработчику PHP, а тот обращается к базе данных. Ответ возвращается обратно по той же цепочке.
| Узел | Параметр ожидания | Обычное значение | Что делает при истечении |
|---|---|---|---|
| CDN (Cloudflare) | внутренний таймаут | 100 с | отдаёт свой код 524 |
| Прокси или балансировщик | proxy_read_timeout |
60 с | отдаёт 504 |
| Nginx перед PHP | fastcgi_read_timeout |
60 с | отдаёт 504 |
| Обработчик php-fpm | request_terminate_timeout |
60–180 с | убивает процесс, посетитель получает 502 |
| PHP | max_execution_time |
30–180 с | прерывает скрипт, страница отдаётся с кодом 500 |
| MySQL | wait_timeout |
28 800 с | закрывает простаивающее соединение |
Время на скрипт и время ожидания ответа — два разных лимита, и живут они в разных местах. Ошибку 504 отдаёт второй: веб-сервер перестал ждать. Когда PHP успевает прервать скрипт сам, посетитель получает пустую страницу или код 500.
Поэтому тариф может обещать 90 секунд на скрипт, а посетитель получит ошибку 504 на шестидесятой: веб-сервер готов ждать только минуту. Из-за этого строка «ошибка 504 время ответа сервера истекло» в логе и настройка времени выполнения в панели часто показывают разные числа.
Что делать посетителю сайта
Обновите страницу через минуту: таймаут часто разовый, сервер был занят тяжёлым запросом, который уже закончился. Если ошибка держится, проверьте, открываются ли другие сайты — так вы отделите проблему конкретного ресурса от проблемы своего канала. Зайдите с мобильного интернета или попросите открыть страницу знакомого: если у него тот же результат, сайт лежит для всех.
Советы из интернета здесь в основном бесполезны. Кеш браузера чистить незачем: ошибку сформировал сервер. Менять DNS-серверы и перезагружать роутер тоже смысла нет — имя домена уже разрешилось в адрес.
Если страница нужна срочно, напишите владельцу сайта или в поддержку сервиса: со стороны посетителя ошибка 504 на сайте не исправляется.
Виноват сайт или канал связи
Владельцу сайта первым делом нужно сузить область поиска. Четыре проверки занимают несколько минут.

Посмотрите, кто отдал страницу. Строгая надпись «504 Gateway Time-out» с подписью nginx внизу — это веб-сервер. Страница с логотипом CDN и кодом 524 говорит, что до сервера запрос не дошёл. Фирменная заглушка провайдера означает, что отвечает его балансировщик.
Проверьте, на всех страницах ошибка или на одной. Если главная открывается, а выгрузка отчёта висит, дело в конкретном скрипте. Если лежит весь сайт, смотрите на сервер и базу данных целиком.
Откройте сайт по IP-адресу сервера, минуя домен. Так вы поймёте, что означает ошибка 504 на сайте в вашем случае: сервер жив, но не успевает, или дело в маршруте до него.
Убедитесь, что домен ведёт на тот сервер, который вы чините. После переезда это самая частая ошибка: правки вносят на новом сервере, а посетители идут на старый. Как проверить, куда смотрит домен, описано в статье что такое DNS.
Девять причин ошибки 504 и как их отличить
Причина почти всегда одна из девяти, и отличают их по обстоятельствам: на каких страницах ошибка появляется и в какое время.

| Когда появляется | Причина | Что проверить |
|---|---|---|
| На одной странице, остальные быстрые | долгий скрипт | slowlog обработчика: он покажет, где скрипт застрял |
| В часы пик, по вечерам | не хватает обработчиков, запросы встают в очередь | число одновременных запросов в тарифе |
| Сразу после запуска импорта или пересчёта | длинная операция идёт через браузер | чем занят сайт в момент ошибки |
| Только на страницах с внешними данными | сторонний сервис не отвечает | таймаут исходящих запросов в коде |
| Вместе с медленной админкой | тяжёлые запросы к базе | лог медленных запросов, план запроса через EXPLAIN |
| Внезапно и на всём сайте | рост нагрузки или атака | лог доступа: сколько запросов и с каких адресов |
| Сразу после правки конфигурации | неверный адрес обработчика или сокета | nginx -t и блок upstream |
| Посетитель видит 524, а не 504 | CDN ждёт меньше, чем работает сайт | настройки таймаута у CDN |
| После переезда на новый сервер | домен ведёт на старый адрес | A-запись домена |
Резкий рост запросов даёт одинаковую картину и при наплыве посетителей, и при атаке, когда сервер занят мусорным трафиком. Как отличить одно от другого, разобрано в статье что такое DDoS-атака.
Лимиты хостинга: сколько времени тариф даёт скрипту
На общем хостинге сайт живёт не один, и ресурсы между аккаунтами разделены. Делается это пулом обработчиков: сайту выделено столько процессов, сколько указано в тарифе как число одновременных запросов. Пока все заняты, следующий запрос ждёт в очереди, и если он прождёт дольше таймаута веб-сервера, посетитель получит 504.

В ZION эти границы опубликованы в тарифах, так что их видно до покупки.
| Тариф | Время на скрипт | Память на запрос | Одновременных запросов | SSH | Цена за месяц |
|---|---|---|---|---|---|
| Старт | 60 с | 256 МБ | 5 | нет | 199 ₽ |
| Проект | 90 с | 384 МБ | 10 | есть | 399 ₽ |
| Бизнес | 120 с | 512 МБ | 20 | есть | 790 ₽ |
| Студия | 180 с | 768 МБ | 30 | есть | 1290 ₽ |
Такие лимиты есть у любого провайдера, просто не все их публикуют. Ограничение времени защищает соседние сайты от одного зависшего скрипта, поэтому совсем без него хостинга не бывает. Зато по таблице видно, в какой именно лимит вы упёрлись: магазин с импортом каталога на «Старте» будет ловить таймауты регулярно, а на «Студии» та же выгрузка уложится в отведённое время. Что такое общий хостинг и откуда берутся эти рамки, объясняет статья что такое хостинг простыми словами.
Где смотреть логи и что в них искать
Диагностика начинается с одной строки в журнале ошибок веб-сервера.

2026/11/18 14:22:07 [error] 2841#0: *17 upstream timed out
(110: Connection timed out) while reading response header from upstream,
client: 203.0.113.25, server: example.ru,
request: "GET /catalog/export HTTP/1.1",
upstream: "fastcgi://unix:/var/run/php-fpm/example.sock"
upstream timed out подтверждает, что обработчик был жив и просто не успел: при падении запись была бы другой. Поле request называет страницу, которая не отработала, — по нему сразу понятно, какой код смотреть. Время в начале строки сравните с временем жалобы посетителя.
Второй источник — slowlog обработчика PHP. С параметром request_slowlog_timeout php-fpm сбрасывает в файл стек зависшего скрипта с именами функций и номерами строк: это самый короткий путь к участку кода, который висит.
Третий — лог медленных запросов базы. Порог задаёт long_query_time, и всё, что длиннее, попадает в файл. Чаще всего там находится выборка без индекса по таблице заказов.
Читать журналы удобнее с сервера по SSH: как подключиться, описано в статье что такое SSH. Но на дешёвых тарифах доступа к консоли нет — в ZION он открыт начиная с «Проекта». Без SSH логи сайта доступны через панель: в ispmanager 6 они лежат в журналах сайта, а сами файлы видно в менеджере файлов. Если нужного файла там нет, его присылает поддержка по запросу.
Как исправить на своём сервере
Первое желание — поднять таймаут. В Nginx это fastcgi_read_timeout для PHP и proxy_read_timeout для проксируемых приложений:
location ~ \.php$ {
fastcgi_pass unix:/var/run/php-fpm/example.sock;
fastcgi_read_timeout 180s;
}
После правки проверьте конфигурацию и перечитайте её без остановки сервера:
nginx -t && systemctl reload nginx
Способ рабочий, но граница просто уезжает дальше: посетитель ждёт три минуты вместо одной, и всё это время обработчик занят. Так делают, пока ищут причину.
Дальше лечится сама медлительность. Тяжёлый запрос к базе разбирают через EXPLAIN и закрывают индексом: на таблице в сотни тысяч строк это даёт разницу в десятки раз. Страницы, которые пересчитываются при каждом открытии, уводят в кеш. Исходящим запросам к сторонним сервисам задают свой таймаут в три-пять секунд, иначе чужая недоступность превращается в вашу ошибку 504.
Если причина не в коде, а в том, что сайту тесно, помогает переход на отдельный сервер: там и обработчиков больше, и таймауты настраиваются под себя. Чем VPS отличается от общего хостинга, разобрано в статье что такое VPS.
Долгие операции в CMS
Самая частая причина таймаутов у магазинов — операции, которые запускают кнопкой в админке.

Импорт каталога на десять тысяч товаров, пересчёт цен и скидок, обмен с 1С, поиск и замена по базе, пересборка кеша, обновление миграций — любая из этих задач легко выходит за минуту. Через браузер она выполняется в том же процессе, который обслуживает обычные страницы, и попадает под тот же таймаут.
Операцию длиннее минуты через браузер не запускают: для этого есть планировщик и консоль, где ограничения на время выполнения нет. В тарифах ZION число заданий cron указано там же, где остальные лимиты: от пяти на «Старте» до шестидесяти на «Студии».
У WordPress для этого есть wp-cli, у Битрикса консольные скрипты, в самописных проектах пишут команду для cron. Если запуска из консоли нет, операцию делят на порции: импорт по пятьсот товаров за проход с сохранением позиции.
Чем 504 отличается от 502, 503, 408 и 524
Эти коды приходят от одних и тех же узлов, а означают разное, и лечатся тоже по-разному.

| Код | Что произошло | Кто отдаёт | С чего начинать |
|---|---|---|---|
| 504 | обработчик не ответил вовремя | веб-сервер или прокси | искать, что именно работает долго |
| 502 | обработчик не ответил вообще или ответил неразборчиво | веб-сервер или прокси | проверить, жив ли php-fpm и верен ли сокет |
| 503 | сервер жив, но обслуживать отказывается: перегрузка или техработы | сам сервер приложения | посмотреть нагрузку и заголовок Retry-After |
| 408 | клиент не дослал запрос за отведённое время | веб-сервер | смотреть на канал клиента, а не на сервер |
| 524 | тот же таймаут, но зафиксированный CDN | Cloudflare | сравнить лимит CDN со временем ответа сайта |
Иногда на одном сайте за день приходит и 502, и 504 ошибка. Обычно это значит, что обработчик сначала долго думал, а потом был убит по своему лимиту: до какого-то момента приходил таймаут, дальше пошёл обрыв.
Код 524 стоит запомнить отдельно: Cloudflare ждёт сто секунд и показывает свою страницу. Сайт при этом может быть настроен на три минуты работы скрипта, и в его логах никакой ошибки не окажется.
Как 504 влияет на поиск
Поисковые системы относятся к пятисотым кодам как к временной неполадке. Один-два случая ничего не меняют: робот вернётся позже и получит страницу.
Затяжная история выглядит иначе. Когда ошибки повторяются неделями, робот снижает частоту обхода, новые страницы попадают в индекс медленнее, а те, что давно не удалось получить, со временем выпадают. Отслеживать это удобно в Яндекс.Вебмастере: в разделе диагностики видно, сколько ответов сервера оказались ошибочными и когда. В Search Console есть похожий отчёт.
На время плановых работ не отдавайте 404, иначе робот решит, что страницы удалены. Правильный ответ при остановке сайта — 503 с заголовком Retry-After: он прямо говорит, когда возвращаться.
Профилактика: как не допускать 504

Поставьте мониторинг доступности с уведомлением в мессенджер: разница между «узнал через минуту» и «узнал от клиента на следующий день» измеряется заказами. Следите заодно за временем ответа страниц, а не только за самим фактом доступности. Страница, которая отвечает двадцать секунд, до таймаута пока не доросла, но стоит от него в одном шаге.
Задайте таймауты всем исходящим запросам: к платёжному шлюзу, к службе доставки, к сервису рассылок. Долгие операции переведите на расписание и запускайте ночью. И держите запас по тарифу: если сайт постоянно работает на границе лимита, любой пик превращается в ошибку 504 для части посетителей.


