error_page в nginx: своя страница 404 и страница для ошибок 500–504
Когда nginx отвечает ошибкой, он показывает свою короткую страницу с кодом. Директива error_page подставляет вместо неё вашу страницу в оформлении сайта: файл лежит в папке сайта, а код ответа остаётся прежним.
Содержание 11
Что сделать прямо сейчас
- Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Создайте страницу ошибки в папке сайта — той, что в строке root:
sudo nano /var/www/example.com/404.html. Напишите в ней, что страницы нет, и дайте ссылки на главную и основные разделы. Сохраните: Ctrl+O, Enter, Ctrl+X. - Откройте файл сайта:
sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажетls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter. - Внутри блока server добавьте строки из раздела ниже.
- Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:
sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их:sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены. - Проверьте — как проверить.
Если проверка нашла ошибку, 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_pass | fastcgi_intercept_errors on; |
| блок с proxy_pass | proxy_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: страница открывается только при ошибке |
Источники
- Документация nginx: директива error_page — код, =ответ, адрес или именованный location, наследование и recursive_error_pages.
- Документация nginx: директива internal — location только для внутренних запросов, на прямой запрос — 404.
- Исходный код nginx 1.24.0: ngx_http_special_response.c — как nginx подставляет страницу из error_page и меняет метод запроса на GET.
- Исходный код nginx 1.24.0: ngx_http_upstream.c — при fastcgi_intercept_errors и proxy_intercept_errors nginx подменяет ответ только для кодов, перечисленных в error_page.
- Исходный код nginx 1.24.0: ngx_http_script.c — return с кодом от 400 и без текста отдаёт ответ через error_page.
Сверено 23 октября 2026 года.
Что почитать дальше
- Ошибка 404 Not Foundоткуда берутся 404 и как их найти.
- Ошибка 502 Bad Gatewayпочему PHP не отвечает.
- nginx и PHP-FPMблок для PHP и fastcgi_pass.
- 301 Moved Permanentlyпереадресация для переехавших страниц.
- Настройки nginxкак устроены файлы и блоки, главные директивы.