Документация Deploya

Решение частых проблем Deploya

# Решение частых проблем Deploya

Источник: https://docs.deploya.ru/troubleshooting

## Страница сайта открывает ошибку 404

Симптом: Главная страница работает, но вложенный адрес или ссылка внутри сайта не открывается.

Что проверить:

- Проверьте, что нужный HTML-файл действительно опубликован и виден в дереве Assets.
- Сверьте регистр букв в имени файла и в ссылке: `Page.html` и `page.html` — разные пути.
- Для адреса `/about` добавьте `about.html` или `about/index.html` либо укажите в ссылке фактическое имя файла.
- Убедитесь, что ссылка не ведёт на локальный путь вроде `C:\...` или `file://...`.

Подробнее: https://docs.deploya.ru/deploy#paths

## После обновления видна старая версия

Симптом: Деплой завершился, но в браузере остались прежний текст, стили или изображения.

Что проверить:

- Откройте страницу проекта и убедитесь, что последняя публикация завершилась без ошибки.
- Проверьте, что загружена готовая папка сборки, например `dist`, а не исходники проекта.
- Обновите страницу без кеша или откройте адрес в приватном окне.
- При частичном обновлении проверьте точные пути изменённых файлов; при сомнении выполните полную замену проекта.

Подробнее: https://docs.deploya.ru/deploy#update

## Открывается не та главная страница

Симптом: После загрузки проекта Deploya выбрал другой HTML-файл или просит указать главный файл.

Что проверить:

- Поместите `index.html` в корень загружаемой папки или ZIP-архива.
- Не архивируйте лишнюю внешнюю папку, если внутри неё находится весь сайт.
- Если `index.html` нет и HTML-файлов несколько, выберите нужный файл в диалоге Deploya.
- Для сборщиков сначала выполните production-сборку и загружайте её результат.

Подробнее: https://docs.deploya.ru/deploy#main-file

## Собственный домен не проходит DNS-проверку

Симптом: В панели Deploya статус DNS остаётся в ожидании или показывает ошибку.

Что проверить:

- Скопируйте тип, имя и значение записи точно из инструкции конкретного домена в панели.
- Удалите старые A- или CNAME-записи для того же имени, если они указывают на другой хостинг.
- Не добавляйте `https://` и путь страницы в значение DNS-записи.
- Подождите обновления DNS у провайдера и повторите проверку в Deploya: оно может занять до 24 часов, но обычно проходит заметно быстрее.

Подробнее: https://docs.deploya.ru/domains#troubleshooting

## HTTPS собственного домена ожидает выпуска

Симптом: DNS уже подтверждён, но защищённое соединение ещё не готово.

Что проверить:

- Сначала убедитесь, что статус DNS в Deploya успешный.
- Проверьте, что для домена не осталось конфликтующих DNS-записей.
- Подождите выпуск сертификата и повторите проверку — он начинается только после подтверждения DNS.
- Если статус долго не меняется, отправьте поддержке имя проекта, домен и скриншот статусов DNS и HTTPS.

Подробнее: https://docs.deploya.ru/domains#https

## Форма не обнаружена или заявка не появилась

Симптом: Deploya не показывает форму проекта либо отправка не создаёт заявку.

Что проверить:

- Убедитесь, что тег `<form>` присутствует в исходном опубликованном HTML, а не создаётся только JavaScript-кодом.
- Добавьте форме `data-deploya="true"`, уникальный `name` и `method="POST"`.
- Добавьте уникальный атрибут `name` каждому полю, которое должно попасть в заявку.
- После изменений заново опубликуйте проект и нажмите «Проверить подключение» в разделе «Формы».

Подробнее: https://docs.deploya.ru/forms#troubleshooting