# Коды ошибок HTTP на KapsuleHost

Source: https://support.kapsulehost.com/ru-ru/http-error-codes

Что на самом деле означают 403, 404, 500, 502, 503 и 504 на этой платформе и что конкретно делать в каждом случае.

Код ошибки это не общее сообщение о сбое. Он показывает, какой уровень стека дал сбой, и это сильно сужает причину. 502 и 504 выглядят для посетителя одинаково, но имеют совершенно разные причины и способы устранения.

## Как узнать настоящий код

Прежде чем начинать диагностику, узнайте реальный номер. Красивая страница ошибки может говорить одно, а сервер возвращать другое.

В браузере откройте инструменты разработчика, перейдите на вкладку Network, перезагрузите страницу и щёлкните по первому запросу. Статус указан в верхней части панели Headers.

В терминале:

```sh
curl -sSI https://yourdomain.com/
```

Это выводит строку статуса и заголовки ответа без загрузки самой страницы. Заголовки важны: несколько случаев ниже определяются именно по заголовку, а не только по коду.

![Просмотр статуса ответа в инструментах разработчика браузера](https://support.kapsulehost.com/help/screenshots/http-error-codes.fdd177cf.webp)

## Краткая версия

| Код | Значение | Чья это проблема |
|---|---|---|
| 401 | Требуется аутентификация | Включена Защита паролем |
| 403 | Запрос намеренно отклонён | Правило безопасности заблокировало запрос |
| 404 | Не найдено | Ваш сайт, обычно маршрутизация |
| 500 | Ваше приложение упало | Ваш код или плагин |
| 502 | Сервер за веб-сервером не ответил | Обычно ваше приложение |
| 503 | Сервер намеренно не обслуживает запросы прямо сейчас | Приостановка, пауза или обслуживание |
| 504 | Запрос выполнялся слишком долго | Что-то в вашем коде работает медленно |

## 401 Unauthorized

Вы увидите окно браузера с запросом имени пользователя и пароля вместо страницы. Это значит, что на сайте или на этом пути включена базовая защита паролем.

Отключите её или получите учётные данные в разделе **Веб-сайты**, выберите сайт, **Параметры**, затем **Защита паролем**. См. [Защита паролем](https://support.kapsulehost.com/ru-ru/site-password-protect).

Продление сертификата продолжает работать, пока включена защита паролем, так что это не нарушит работу вашего HTTPS.

## 403 Forbidden

403 означает, что что-то намеренно отклонило запрос. На этой платформе есть четыре отдельных источника такого поведения.

**Межсетевой экран веб-приложений (WAF).** Каждый сайт работает за движком правил, который проверяет входящие запросы и блокирует те, что соответствуют известным шаблонам атак. Это самый частый источник неожиданного 403, и почти всегда это ложное срабатывание на легитимный, но нестандартный запрос: длинная отправка формы, конструктор страниц, сохраняющий сложный контент, плагин, отправляющий необработанный код.

Признаки блокировки межсетевым экраном: одно конкретное действие каждый раз завершается ошибкой 403, при этом остальной сайт работает нормально, и та же ошибка воспроизводится одинаково в другом браузере и в другой сети.

Решение, это точечное исключение из правил, которое может добавить поддержка. Не ищите переключатель, чтобы отключить межсетевой экран целиком: для общего хостинга такого переключателя нет, да и это было бы неверным решением. Откройте тикет с точным URL, точным временем и описанием того, что вы делали. См. [Как открыть тикет в службу поддержки](https://support.kapsulehost.com/ru-ru/opening-a-support-ticket).

**Геоблокировка.** Если вы ограничили доступ к сайту определёнными странами, все остальные получат 403. Проверьте **Параметры**, затем **Безопасность**. См. [Геоблокировка](https://support.kapsulehost.com/ru-ru/site-geo-blocking).

**Блокировка IP.** Либо та, что вы сами добавили в разделе Security, либо блокировка на уровне платформы из-за злоупотреблений.

**Проблема с правами доступа к файлам или символическими ссылками.** Встречается реже и обычно проявляется после ручной операции с файлами через SSH.

## 404 Not Found

Сервер ответил, но по этому адресу ничего нет.

**Ошибка 404 на одной странице.** Файла или записи действительно не существует, либо URL указан неверно.

**Ошибка 404 на всех страницах, кроме главной.** Это проблема маршрутизации, и в WordPress это почти всегда постоянные ссылки (permalinks). Важно: веб-хостинг KapsuleHost работает на nginx, а не на Apache, поэтому правила переписывания `.htaccess` здесь ничего не делают. Если вы переехали с хостинга, который их использовал, вот в чём причина. См. [Проблемы с постоянными ссылками](https://support.kapsulehost.com/ru-ru/wordpress-permalink-issues) и [WordPress и .htaccess](https://support.kapsulehost.com/ru-ru/wordpress-htaccess).

**Ошибка 404 на всём сайте.** Проверьте, что сайт указывает на правильный корневой каталог документов и что ваш домен привязан к нужному сайту. См. [Пользовательский домен для сайта](https://support.kapsulehost.com/ru-ru/custom-domain-for-website).

**Работает на вашем компьютере, но выдаёт 404 на сервере.** В Linux регистр букв в именах файлов имеет значение. `Logo.PNG` и `logo.png` это два разных файла.

## 500 Internal Server Error

Ваше приложение запустилось и упало. С веб-сервером всё в порядке, дело в коде.

Это как раз тот случай, когда логи почти сразу дают ответ, потому что фатальная ошибка PHP записывает файл и номер строки, где произошёл сбой, и обычно это прямо указывает на конкретный плагин.

1. Перейдите в **Веб-сайты**, выберите сайт, **Параметры**, затем **Логи**.
2. Посмотрите самые свежие записи.
3. Сопоставьте метку времени со временем, когда вы увидели ошибку.

См. [Логи ошибок](https://support.kapsulehost.com/ru-ru/error-logs). Для специфичного для WordPress варианта, когда вместо ошибки отображается пустая страница, см. [Белый экран WordPress](https://support.kapsulehost.com/ru-ru/wordpress-white-screen).

Самые частые причины: несовместимость плагина или темы с вашей версией PHP, достижение лимита памяти и сбой подключения к базе данных. См. [Расширения и настройки PHP](https://support.kapsulehost.com/ru-ru/php-extensions-and-ini) и [Лимит памяти WordPress](https://support.kapsulehost.com/ru-ru/wordpress-memory-limit).

## 502 Bad Gateway

Веб-сервер попытался передать запрос вашему приложению и не получил ничего пригодного в ответ. Процесс приложения отказал в соединении или завершился посреди обработки запроса.

Частые причины:

- Процесс PHP упал, часто из-за нехватки памяти на одном запросе.
- Приложение на Node.js не запущено или упало при старте.
- Всплеск трафика исчерпал доступные рабочие процессы.

Что делать: сначала проверьте логи, как описано выше. Если это приложение на Node, проверьте, действительно ли процесс запущен, и посмотрите вывод при его старте. Если ошибки 502 появляются только в часы пиковой нагрузки, это проблема нехватки ресурсов, а не ошибка в коде. См. [Медленная работа сайта и ограничения ресурсов](https://support.kapsulehost.com/ru-ru/site-slow-resource-limits).

> **Note:** Ошибка 502 от самой KPanel при сохранении настройки означает нечто иное. Это значит, что панель не смогла применить изменение конфигурации к веб-серверу и откатила изменение, вместо того чтобы оставить ваш сайт наполовину настроенным. Ваш сайт при этом не пострадал. Попробуйте ещё раз, и если ошибка повторяется, откройте тикет.

## 503 Service Unavailable

503 означает, что сервер намеренно не обслуживает запросы прямо сейчас. На этой платформе есть три конкретные причины, и по ответу можно определить, какая именно.

**Ваш сайт приостановлен.** Вы увидите страницу с заголовком "This site is paused". Это связано с биллингом или состоянием аккаунта, а не с технической неисправностью, и сайт возобновит работу сразу же, как только это состояние будет устранено. Проверьте раздел **Биллинг**. См. [Неудачный платёж](https://support.kapsulehost.com/ru-ru/billing-failed-payment) и [Аккаунт приостановлен](https://support.kapsulehost.com/ru-ru/account-suspended).

**Обслуживание платформы.** Страница обслуживания для всей платформы, что случается редко и всегда анонсируется заранее. Проверьте [Статус и доступность](https://support.kapsulehost.com/ru-ru/status-and-uptime).

## 504 Gateway Timeout

Ваше приложение всё ещё работало, когда у веб-сервера закончилось терпение. Ничего не упало. Просто всё происходило слишком медленно.

Типичные причины:

- Долгий импорт, экспорт, резервное копирование или массовая операция, запущенные через браузер.
- Плагин, обращающийся к медленному внешнему API при каждой загрузке страницы.
- Ресурсоёмкий запрос к базе данных без индекса.
- Задача cron, запускаемая просмотром страницы, а не настоящим cron.

Что делать:

1. Определите, какой запрос выполняется медленно. Вкладка APM на сайтах WordPress покажет это. См. [Производительность сайта](https://support.kapsulehost.com/ru-ru/site-performance).
2. Для длительных операций используйте командную строку, а не браузер. См. [WP-CLI](https://support.kapsulehost.com/ru-ru/wordpress-wp-cli).
3. Перенесите запланированную работу на настоящий cron. См. [Задачи cron](https://support.kapsulehost.com/ru-ru/cron-jobs).
4. Увеличьте `max_execution_time`, если работе действительно требуется больше времени, хотя это скорее обходное решение, чем исправление. См. [Расширения и настройки PHP](https://support.kapsulehost.com/ru-ru/php-extensions-and-ini).

Обратите внимание на разницу: если PHP первым достигает собственного лимита времени выполнения, вы получите 500, а не 504. Оба кода означают "слишком медленно", но на разных уровнях.

## Полное отсутствие ответа

Иногда кода ошибки нет вовсе, потому что нет и самого ответа. Соединение просто зависает и в итоге обрывается по тайм-ауту.

Если это происходит из одной сети, но сайт работает из другой, и особенно если это телефон на мобильном интернете, наиболее вероятная причина, это автоматическая блокировка за злоупотребления: всплеск ошибок или неудачных попыток входа с вашего адреса вызвал временный запрет на уровне сети. Такие блокировки снимаются сами, обычно в течение часа. Если нужно снять её раньше, свяжитесь с поддержкой и укажите IP-адрес, с которого вы подключаетесь.

## Пользовательские страницы ошибок

Вы можете заменить стандартную страницу ошибки для 400, 401, 403, 404, 500, 502, 503 и 504 на собственный HTML в разделе **Веб-сайты**, выберите сайт, **Параметры**, затем **Страницы ошибок**. KapsuleHost предоставляет фирменные страницы по умолчанию для 404, 500, 502, 503 и 504, если вы не настроили свои.

Стоит знать одну вещь: пользовательская страница ошибки сохраняет настоящий код статуса. Пользовательская страница 404 всё равно возвращает 404. Отдача вашей страницы ошибки со статусом 200, это классический способ разрушить позиции сайта в поиске, и здесь это намеренно невозможно. См. [Пользовательские страницы ошибок](https://support.kapsulehost.com/ru-ru/site-error-pages).

## Похожие материалы

- [Сайт не загружается](https://support.kapsulehost.com/ru-ru/website-not-loading)
- [Логи ошибок](https://support.kapsulehost.com/ru-ru/error-logs)
- [Медленная работа сайта и ограничения ресурсов](https://support.kapsulehost.com/ru-ru/site-slow-resource-limits)
- [Статус и доступность](https://support.kapsulehost.com/ru-ru/status-and-uptime)
- [Websites](https://support.kapsulehost.com/ru-ru/sites-overview)
- [Глоссарий хостинга](https://support.kapsulehost.com/ru-ru/glossary)