Сайты
Пользовательские страницы ошибок
A custom error page replaces the plain server default with your own branded HTML, while keeping the true error status so search engines still see a real 404. This guide covers adding a page for each…
Пользовательские страницы ошибок заменяют простую страницу сервера по умолчанию на вашу собственную фирменную HTML-страницу, при этом сохраняя истинный статус ошибки, чтобы поисковые системы по-прежнему видели реальную 404. Это руководство охватывает добавление страницы для каждого поддерживаемого кода, что удаляется в целях безопасности и как работает значок проверки.
Где находятся страницы ошибок в KPanel
- Войдите в KPanel.
- Нажмите Websites на левой боковой панели, затем нажмите на сайт.
- На вкладке сайта откройте Advanced, затем Error pages.
Прямой адрес: /websites/<site-id>/error-pages.
Зачем это нужно
Страница ошибки сервера по умолчанию - это тупик. На ней нет фирменного стиля, навигации и объяснения, поэтому посетитель, попавший на неё, обычно уходит.
Пользовательская страница превращает это в маршрут, возвращающий в сайт: ваш логотип, ваша типография, предложение в вашем стиле и ссылка на главную или поисковую строку. На большом сайте опечатанные и устаревшие URL-адреса - это постоянный поток трафика, а страница 404 - это самое дешевое восстановление, которое вы когда-либо будете создавать.
Поддерживаемые коды
Вы можете установить пользовательскую страницу для восьми кодов, одна страница на код:
| Code | Meaning | Typical cause |
|---|---|---|
| 400 | Bad Request | Неправильно сформированный запрос |
| 401 | Unauthorized | Требуется проверка подлинности или она не прошла |
| 403 | Forbidden | Правило доступа блокировало запрос |
| 404 | Not Found | На этом URL ничего не существует |
| 500 | Internal Server Error | Ваше приложение завершилось с ошибкой |
| 502 | Bad Gateway | Приложение ответило неправильно |
| 503 | Service Unavailable | Приложение недоступно или перегружено |
| 504 | Gateway Timeout | Приложение отвечало слишком долго |
Начните с 404. Это наиболее распространённая ошибка, и это единственная, с которой посетитель сталкивается при обычном просмотре, а не из-за ошибки.
Семейство 5xx стоит обрабатывать в следующий раз, поскольку это страницы, которые люди видят в ваш худший день. Спокойная фирменная страница, в которой говорится, что что-то пошло не так, и указан адрес электронной почты, намного лучше, чем пустая ошибка сервера.
Добавление страницы
- Нажмите Add error page.
- Выберите код ошибки из раскрывающегося списка. Коды, которые уже используются, не указаны.
- Замените образец HTML в поле HTML body своим собственным.
- Нажмите Add error page.
Редактор начинает с рабочего документа 404, который вы можете отредактировать, что является хорошей отправной точкой, если вы просто хотите что-то аккуратное и быстрое.
Написание HTML
Укажите полный HTML-документ, начиная с doctype. Он подается как есть, поэтому должен быть самодостаточным.
Некоторый HTML удаляется перед сохранением страницы в целях безопасности:
<script>tags- встроенные обработчики событий, такие как
onclick - iframes
- удаленные таблицы стилей
Если что-то было удалено, после сохранения появляется предупреждение.
Поскольку удаленные таблицы стилей удаляются, страница ошибки не может подтягивать основной файл CSS вашего сайта. Стилизуйте его с помощью встроенного CSS или блока <style> в head документа. Это сделано намеренно: страница ошибки должна отображаться, когда остальная часть сайта сломана, а страница, которая зависит от загрузки активов с неработающего сервера, будет отображаться как нестилизированный текст в самый неудачный момент.
Практические рекомендации:
- Сделайте его компактным и автономным. Встраивайте всё. Избегайте внешних изображений. В списке страниц отображается размер каждой страницы в КБ.
- Объясните, что произошло простыми словами. "Мы не смогли найти эту страницу" лучше, чем "404 Not Found".
- Предложите выход. Ссылка на главную, ссылка на основные разделы или поисковая строка.
- Включите контактный маршрут на страницы 5xx, поскольку посетитель не может использовать сайт для связи с вами.
- Не используйте его для перенаправления. Если URL изменился, правильно перенаправьте его вместо этого. См. Site Redirects.
Код статуса сохраняется
Ваша пользовательская страница подается с реальным кодом ошибки, а не 200. 404 остаётся 404 на протяжении всего пути к клиенту.
Это важнее, чем кажется. Фирменная страница, возвращённая как 200, это мягкая 404: поисковые системы индексируют её как реальную страницу, ваша аналитика считает её успешным просмотром, и сломанные ссылки никогда не отмечаются никаким инструментом. Поскольку Kapsule сохраняет истинный статус, всё это продолжает работать правильно.
Чтение значка статуса
Столбец Status сообщает, что на самом деле можно было проверить, и он намеренно честен о своих ограничениях.
| Badge | Meaning |
|---|---|
| Verified: branded page served (true 404) | Мы принудительно создали 404 извне и получили вашу страницу с правильным статусом |
| Configured (not externally tested) | Страница применена. Этот код не может быть вызван извне по требованию |
| Not yet verified | Проверка ещё не прошла |
| Applied, live test inconclusive | Проверка получила что-то кроме чистой 404, часто потому, что перенаправление перехватило её |
| Got a 404 but the branded page was not served | Правило на месте, но ваша страница не вернулась. Попробуйте пересохранить |
Только 404 может быть принудительно вызвана извне. Запрос URL, который не существует, надёжно производит 404, но нет способа заставить здоровый сервер выдать настоящую 500 по требованию без его повреждения. Поэтому другие коды сообщают Configured вместо того, чтобы претендовать на проверку, которая никогда не произойдёт. Они по-прежнему работают, когда ошибка действительно происходит.
Вы также можете увидеть предупреждение о том, что другая конфигурация на сервере претендует на тот же домен. До тех пор, пока это не будет разрешено, страница ошибки может не применяться. Если вы это видите, свяжитесь со службой поддержки.
Устранение неполадок сайта, который действительно выдаёт ошибки
Если вы здесь потому, что ваш сайт выдаёт ошибки, а не потому, что вы хотите более красивые страницы, на странице есть ярлык: кнопка Troubleshoot with Kora в баннере вверху.
Она просит Kora, помощника внутри KPanel, прочитать ваши журналы ошибок и недавние сбои для этого сайта и подсказать вероятную причину и способ исправления. Это гораздо более быстрый первый шаг, чем чтение сырых журналов.
Для общей картины производительности см. Site Performance and APM, а для темпа ошибок во времени см. Site Traffic Analytics.
Редактирование и удаление
Каждая строка имеет кнопку редактирования, которая открывает тот же редактор с фиксированным кодом и загруженным HTML, и кнопку удаления.
Удаление требует подтверждения и объясняет результат: запросы, которые попадают на этот код, возвращаются к странице сервера по умолчанию.
Устранение неполадок
Моя страница не отображается. Убедитесь, что вы вызываете правильный код. Путь, который перенаправляется, никогда не достигает 404. Протестируйте с URL, который действительно не существует, в приватном окне, чтобы кэш не был задействован.
Страница отображается, но выглядит нестилизированной. Ваша таблица стилей была удалена как удаленный актив. Встройте CSS.
Мой скрипт отслеживания отсутствует. Скрипты удаляются намеренно. Нет способа запустить JavaScript со страницы пользовательской ошибки здесь.
Все коды уже имеют страницу. Все восемь используются. Вместо добавления другого отредактируйте существующую страницу.
Значок говорит, что фирменная страница не была подана. Пересохраните страницу. Если это продолжается, и не появилось предупреждение о конфликте домена, откройте тикет.
Связанные страницы
- Site Redirects для предотвращения появления 404.
- Site Traffic Analytics для просмотра количества фактически обслуживаемых ответов 4xx и 5xx.
- Password-Protecting a Site, которая по назначению выдаёт ответы 401.