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

error_page в nginx: своя страница 404 и страница для ошибок 500–504

Когда nginx отвечает ошибкой, он показывает свою короткую страницу с кодом. Директива error_page подставляет вместо неё вашу страницу в оформлении сайта: файл лежит в папке сайта, а код ответа остаётся прежним.

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

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

  1. Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
  2. Создайте страницу ошибки в папке сайта — той, что в строке root: sudo nano /var/www/example.com/404.html. Напишите в ней, что страницы нет, и дайте ссылки на главную и основные разделы. Сохраните: Ctrl+O, Enter, Ctrl+X.
  3. Откройте файл сайта: sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажет ls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter.
  4. Внутри блока server добавьте строки из раздела ниже.
  5. Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их: sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены.
  6. Проверьте — как проверить.

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

Своя страница 404

error_page 404 /404.html;

location = /404.html {
    internal;
}

Первая строка говорит nginx: при ошибке 404 показать адрес /404.html. nginx берёт файл внутри сервера — адрес в браузере не меняется, а код ответа остаётся 404.

Блок location со словом internal закрывает прямой вход: страница открывается только как страница ошибки, а на запрос example.com/404.html nginx ответит 404. Файл nginx ищет по строке root, так же как остальные файлы сайта.

Страница для ошибок 500–504

error_page 500 502 503 504 /50x.html;

location = /50x.html {
    internal;
}

Коды пишут через пробел. Сделайте эту страницу простым файлом HTML, без PHP: ошибка 502 бывает, когда PHP не работает, и страница на PHP тоже не откроется. Если при показе страницы ошибки случилась новая ошибка, nginx отдаст свою стандартную страницу с кодом последней ошибки.

Стили и картинки на странице ошибки подключайте полными путями от корня сайта: /style.css, а не style.css. Страница показывается по любому адресу, например /a/b/c, и путь без косой черты в начале браузер будет искать в папке /a/b/.

Как устроена строка error_page

СтрокаЧто получится
error_page 404 /404.htmlстраница /404.html, код 404
error_page 404 =200 /empty.gifфайл /empty.gif с кодом 200: после знака = пишут новый код
error_page 404 = /404.phpкод ответа вернёт сам скрипт
error_page 404 = @fallbackпередать запрос в блок location @fallback, адрес и метод не меняются
error_page 404 https://example.com/переадресация с кодом 302
error_page 404 =301 https://example.com/переадресация с кодом 301: для полного адреса можно указать 301, 302, 303, 307 или 308

Страницу ошибки nginx запрашивает методом GET, даже если посетитель отправлял форму методом POST. Поэтому страницей ошибки может быть простой файл.

Не отправляйте все 404 на главную

Строки error_page 404 =301 / или error_page 404 https://example.com/ отправляют посетителя с несуществующего адреса на главную. Посетитель не понимает, что страницы нет, а в журнале доступа вместо 404 будет переадресация, и битые ссылки трудно найти. Поисковому роботу код 404 сообщает, что адреса нет, — подробнее в разделе 404 и поиск Яндекса.

Если страница переехала, поставьте переадресацию 301 для её старого адреса — 301 Moved Permanently.

Ошибки от PHP и приложений

error_page срабатывает на ошибки, которые выдал сам nginx: файла нет, доступ запрещён, PHP-FPM не отвечает. Если PHP или приложение за proxy_pass ответили кодом 404 или 500, nginx передаст их страницу как есть.

Чтобы показать вместо неё вашу страницу, добавьте строку в блок, который передаёт запросы:

КудаСтрока
блок для PHP, где есть fastcgi_passfastcgi_intercept_errors on;
блок с proxy_passproxy_intercept_errors on;

nginx подменит только ответы с кодами, которые перечислены в error_page; остальные пройдут как есть. Учтите: у WordPress и других CMS есть своя страница 404 в оформлении темы, и после этой строки её заменит ваш файл. Блок для PHP — nginx и PHP-FPM.

Где писать и как наследуется

error_page пишут в блоках http, server, location и в if внутри location. Блок location получает строки error_page из блока server, только если в нём нет своих. Одна строка error_page в location отменяет там все строки уровня server:

server {
    error_page 404 /404.html;
    error_page 500 502 503 504 /50x.html;

    location /shop/ {
        error_page 404 /shop/404.html;
        # здесь страница 50x.html уже не работает
    }
}

Если в блоке location нужна своя строка, повторите в нём и остальные.

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

Страница 404:

curl -I https://example.com/takoj-stranicy-net/

В первой строке ответа должен быть код 404. Откройте этот адрес в браузере — должна быть ваша страница.

Страницу 50x.html проверяют временным блоком. Добавьте его в блок server, проверьте и примените настройки:

location = /test-502 {
    return 502;
}

Откройте example.com/test-502: должна быть ваша страница, а curl -I покажет код 502. После проверки удалите блок и снова примените настройки.

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

Что видитеЧто делать
стандартная страница nginx вместо вашейфайла нет по пути из root: проверьте имя и папку. Если ошибку выдал PHP — строка fastcgi_intercept_errors
в одном разделе страница своя, в другом — стандартнаяв блоке location есть своя строка error_page — как наследуется
страница без стилей и картинокпути без косой черты в начале — пишите /style.css
код 200 вместо 404в строке стоит =200 или = со скриптом: уберите знак =
переадресация вместо 404в строке полный адрес с https:// — укажите путь от корня сайта, например /404.html
запрос example.com/404.html отвечает 404так работает internal: страница открывается только при ошибке

Источники

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

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

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