Ошибка Xray core и сообщения при импорте в Happ

Happ работает на ядре Xray. Когда ядро не может запуститься или приложение не понимает вставленные данные, оно показывает короткое сообщение. Ниже они собраны в одну таблицу.

Сообщения при импорте

Формулировки — из официального списка ошибок Happ.

СообщениеПричинаЧто сделать
Буффер обмена пустПеред импортом ничего не скопировано или копирование не сработало.Скопируйте ссылку ещё раз и сразу вернитесь в Happ.
Url подписки не валиднаВ адресе ошибка или недопустимые символы: обрезан, с пробелом, с лишними знаками.Скопируйте ссылку целиком из письма или кабинета, не с фотографии экрана.
Конфигурация … не валиднаяСтрока vless://, vmess://, trojan:// и другие содержит ошибку.Проверьте, что скопирована вся строка. Для подписки используйте её ссылку, а не отдельный сервер.
Невалидная (массив) конфигурация JSONВ JSON-данных синтаксическая ошибка.Запросите данные заново у того, кто их выдал.
Неизвестное действие DeepLinkСсылка happ:// содержит действие, которого приложение не знает.Приложение просто её пропускает. Используйте ссылку подписки.
Неизвестный тип контентаВставленные данные не похожи ни на подписку, ни на конфигурацию.Убедитесь, что вставляете именно ссылку подписки, а не текст письма целиком.
Неправильные данные для импортирования профиля маршрутизацииВ профиле маршрутизации ошибка или недопустимые параметры.Запросите ссылку профиля заново или продолжайте без профиля.
Timeout при добавлении подпискиСервер подписки не ответил за 9 секунд.Проверьте интернет без Happ, отключите другие VPN-клиенты и повторите.

Ядро не запускается

Если серверы добавились, а при подключении приложение сообщает о сбое ядра, причины обычно такие.

Другое приложение занимает сетевой адаптер

Второй VPN-клиент, работающий одновременно, не даёт ядру поднять соединение. Закройте его и подключитесь снова.

Антивирус или брандмауэр блокирует ядро

На Windows добавьте Happ в исключения и разрешите ему сетевой доступ. После обновления системы разрешение иногда сбрасывается.

Устаревшая система

Ядро требует Windows 10 сборки 1809+, macOS 13+ (dmg) или современный Linux. На старых системах запуск невозможен.

Не скачались гео-файлы

Профили маршрутизации ссылаются на списки доменов и адресов. Если их не удалось загрузить, вернитесь к профилю по умолчанию и переподключитесь.

Повреждена установка

Переустановите Happ с официальной страницы и импортируйте подписку заново. Ссылка не меняется.

Перед обращением в поддержку

Если сообщение осталось после всех действий, соберите три вещи — так ответ будет быстрее.

Точный текст сообщения

Скриншот или дословная копия.

Система и версия Happ

Например: Windows 11, Happ последней версии с happ.info.

Что уже сделали

Другой сервер, переустановка, отключение антивируса.

Частые вопросы

Что такое Xray core?

Ядро, которое устанавливает соединение с сервером. Happ — интерфейс к нему. Ошибка ядра означает, что соединение не поднялось, а не что приложение сломано.

Нужно ли переустанавливать при ошибке импорта?

Нет. Ошибки импорта — про данные, которые вы вставляете. Скопируйте ссылку заново.

Поможет ли смена сервера?

При сбое ядра — часто да: попробуйте два-три сервера из списка, прежде чем искать причину на устройстве.

Проверьте срок подписки

Истёкший доступ выглядит как ошибка подключения. Срок и продление — в кабинете.