Начните с точного сообщения мастера: одинаково выглядящая проблема может быть связана с адресом, доступом, настройками хостинга или связью с KEHR. До результата «Защита подключена» не считайте первую установку завершённой.
Установщик не открывается#
- Убедитесь, что открываете свой домен и распаковали комплект, а не просто загрузили ZIP на хостинг.
- Для обычного сайта файлы распаковываются рядом с
index.phpилиindex.html; адрес мастера —https://example.com/ys-install.php. - Для проекта с отдельной папкой
public/файлы распаковываются в корень проекта рядом с ней; адрес мастера —https://example.com/ys-installer.php, без/public/в адресе. Подставьте свой домен. Схемы расположения файлов есть в инструкции установки.
Если браузер показывает «страница не найдена», проверьте расположение нужного файла с администратором хостинга. Если проблема в HTTPS или не открывается сам сайт, сначала исправьте доступность домена и сертификата. Если PHP-файл скачивается вместо открытия страницы, попросите хостинг проверить выполнение PHP для сайта.
«Установщик закрыт» — отдельное состояние. После успешной первой установки это ожидаемо: первоначальный доступ закрывается. Новый ZIP сам по себе не открывает обслуживание активного модуля. Для изменений используйте инструкцию обслуживания и согласуйте доступ с администратором или поддержкой. При первой установке такого сообщения быть не должно: проверьте, что комплект относится к этому сайту.


Код не подходит#
Сообщение «Не удалось принять код установки» не подтверждает успешное подключение. Поле остаётся на странице, чтобы можно было исправить ввод.


- Сверьте домен, выбранный сайт в «Сайты» и комплект, распакованный на хостинге. Код должен относиться именно к этому комплекту и сайту.
- Скопируйте полный код без добавленных пробелов. Используйте новый код вместе с соответствующим новым ZIP; код от другого сайта или перевыпущенного комплекта не подходит.
- Убедитесь, что не истёк срок: комплект действует два часа, и установку нужно закончить в это время. Если код потерян, комплект просрочен или уже перевыпущен, получите новую совпадающую пару по инструкции. Для уже активного модуля этот способ не заменяет доступ к обслуживанию.
Не пытайтесь угадать код и не отправляйте его в обращение. Если свежая совпадающая пара не принимается, сохраните текст ошибки и обратитесь в поддержку.
Мастер не прошёл проверки#
- Раскройте «Технические подробности» внизу мастера и найдите проверку, которая не выполнена. Передайте хостингу её название и пояснение, а не только общий текст ошибки.
- Попросите проверить PHP именно вашего сайта: нужен PHP 8.0 или новее и расширение cURL для сетевых запросов. На снимке эти условия выполнены; это пример расположения проверок, а не ошибка.
- Если сообщение касается чтения или записи файлов, попросите администратора проверить права только для указанной папки и выбранного способа подключения. Не делайте весь сайт доступным для записи.


Технические названия могут быть английскими: PHP version — версия PHP, cURL extension — расширение cURL, readable — файл доступен для чтения, writable — разрешена запись. Требования относятся к модулю на вашем хостинге. При проблеме с методом подключения используйте инструкцию выбора способа.
Ошибка связи или остался шаг на хостинге#
Ошибка связи#
Проверьте активность тарифа и разрешённые адреса сайта в KEHR. Если сообщение упоминает HTTPS, сертификат, сеть или время ожидания, передайте его хостингу для проверки исходящих соединений и доступности сайта. Не отключайте проверку сертификатов. За прокси или CDN следуйте отдельной инструкции.
«Остался шаг на хостинге»#
Файлы подготовлены, но защита ещё не включена. Передайте администратору инструкцию под сообщением. Путь на снимке учебный; для вашего сайта нужен его фактический путь. После выполнения нажмите «Проверить подключение снова» и дождитесь «Защита подключена». Если сообщение осталось, сохраните подробности вместо повторной распаковки комплекта.


Если нужна помощь#
В обращении укажите домен и адрес страницы мастера, шаг установки, точный текст ошибки, время её появления, версию PHP и уже выполненные действия. Отдельно скажите, это первая установка или обслуживание действующего модуля. Перед отправкой снимка скройте код установки, ключи и личные данные.
После исправления повторите проверку активации и важных страниц. «Работает» в карточке KEHR подтверждает связь с модулем, а не защиту всех страниц вашего сайта.