Как читать сообщение
| Что в строке | Что это значит | Что делать |
|---|---|---|
| failed to start | Ядро не смогло запуститься с текущей конфигурацией | Проверить порт и настройки: порт занят |
| address already in use | Локальный порт занят другой программой | Освободить или сменить порт |
| invalid config / ошибка разбора | Конфигурация повреждена или несовместима | Обновить подписку, при необходимости добавить заново |
| connection refused | Сервер отказал в соединении | Сменить сервер, проверить срок доступа |
| context deadline exceeded | Истекло время ожидания | Тайм-аут подключения |
| tls: handshake failure | Не согласовалось шифрование | Ошибка TLS |
Смысл в том, что «ошибка ядра» - это не диагноз, а название источника сообщения. Полезная часть всегда идёт после двоеточия, и почти всегда сводится к одной из строк выше.
Порядок действий
- Откройте журнал и найдите первую ошибку. Важна именно первая: дальше идут её последствия. Где журнал - интерфейс на Windows.
- Обновите подписку. Значительная часть ошибок конфигурации лечится обновлением списка серверов: подписка.
- Попробуйте другой сервер. Если ошибка привязана к конкретному серверу, соседний заработает сразу.
- Проверьте локальный порт: netstat -ano | findstr:<порт>: порт занят.
- Обновите или откатите приложение. Версия ядра идёт вместе со сборкой: обновление, откат.
Когда виновата не программа
Ошибки ядра часто появляются, когда доступ закончился или ссылка отозвана: сервер перестаёт принимать соединения, и ядро сообщает об этом на своём языке. Признак - ошибки на всех серверах сразу, при том что приложение не обновлялось и настройки не менялись.
Проверка простая: вставьте в тот же клиент заведомо рабочую ссылку. Подключилось - дело было в подписке, а не в Windows. Не подключилось - продолжайте разбор по системным причинам.
Можно ли обновить ядро отдельно от приложения?
Обычно нет: оно поставляется вместе со сборкой. Поэтому обновление приложения - штатный способ обновить и ядро.
В журнале много строк с ошибками - на какую смотреть?
На первую по времени. Последующие обычно описывают последствия: неудачные повторные попытки.
Ошибка появляется только на одном сервере
Тогда дело в сервере или его настройках на стороне сервиса. Пользуйтесь другим и напишите в поддержку сервиса.
Сообщение выглядит пугающе, но означает обычно простое: внутренний компонент не смог запуститься с теми параметрами, которые пришли из подписки.
Что это за ядро
Внутри клиента работает компонент, который и занимается собственно подключением, - его обычно называют ядром. Приложение передаёт ему параметры из подписки и запускает. Если параметры некорректны или не поддерживаются, ядро останавливается и сообщает об ошибке.
Это почти всегда вопрос к конфигурации, а не к телефону
Ошибка ядра означает, что запуск не удался с текущими параметрами. Само устройство при этом исправно.
Что делать по порядку
- Обновите подписку в приложении. Кнопка обновления рядом со списком серверов. Часто параметры на сервере уже исправлены, а у вас закэширован старый набор.
- Попробуйте другой сервер. Ошибка может касаться одного конкретного сервера с необычными параметрами - как переключаться.
- Проверьте версию приложения. Старая сборка может не понимать новые параметры. Обновите приложение - как.
- Посмотрите журнал. В журнале обычно есть строка с деталями: какой параметр не принят. По ней проще искать решение или обращаться в поддержку - где журнал.
- Проверьте на другой ссылке. Подставьте заведомо рабочую подписку. Если с ней ядро запускается - дело в вашей подписке, а не в приложении.
Частые причины
| Причина | Признак |
|---|---|
| Устаревшая версия клиента | ошибка появилась после смены подписки или сервера |
| Неподдерживаемый протокол | ошибка на одном сервере, на других всё работает |
| Повреждённая подписка | ошибка на всех серверах сразу |
| Конфликт с другим профилем | ошибка появляется, когда активен другой клиент - подробнее |
| Старая iOS | ошибка на устройстве, которое давно не обновлялось - про версии |
Параметры описаны в статье разбор ссылки доступа. Это полезно, если хочется понять, какой именно параметр не принят.
Это опасно для телефона?
Нет. Ядро - часть приложения; его остановка не влияет на систему.
Помогает ли переустановка?
Иногда, если повреждены данные приложения. Но сначала обновите подписку - это быстрее и безопаснее.
Ошибка появляется только на одном сервере
Значит, дело в его параметрах. Пользуйтесь другими и сообщите сервису доступа.
Xray - это движок внутри приложения, который и устанавливает соединение. Сообщение о его ошибке означает: движок получил параметры подключения и не смог с ними работать.
Чаще всего виноваты не файлы приложения, а строка доступа: движок читает её и получает набор параметров, который не складывается в рабочее соединение. Поэтому начинать надо со строки, а не с переустановки.
- Проверьте строку доступа. Скопирована ли она целиком, нет ли пробелов и переносов. Быстрая проверка - разбор ссылки: он покажет тип строки и параметры, которые в ней есть.
- Обновите подписку. Если сервис поменял параметры серверов, старый список может быть несовместим с текущей сборкой - как обновить.
- Проверьте версию приложения. Старая сборка может не понимать новые параметры. Обновление помогает именно в этом случае - версии и обновление.
- Сбросьте свои правки в настройках. Ручные правила маршрутизации и DNS - частая причина: движок получает противоречивую конфигурацию и останавливается.
Реже, но бывает
- Повреждённая установка. Если приложение обновлялось поверх много раз, помогает переустановка начисто (строку доступа сохраните заранее).
- Антивирус. Он может блокировать компонент движка. Проверяется временным отключением защиты на минуту.
- Нехватка прав. В системном режиме движку нужны повышенные права - про TUN.
Это вирус?
Нет. Xray - штатный компонент приложения, отвечающий за соединение. Сообщение о его ошибке - обычная диагностика.
Ошибка появилась после смены сервиса доступа
Вероятно, новый сервис использует параметры, которых не понимает ваша сборка. Обновите приложение.
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 последней версии с.
Что уже сделали
Другой сервер, переустановка, отключение антивируса.
Частые вопросы
Что такое Xray core?
Ядро, которое устанавливает соединение с сервером. Happ - интерфейс к нему. Ошибка ядра означает, что соединение не поднялось, а не что приложение сломано.
Нужно ли переустанавливать при ошибке импорта?
Нет. Ошибки импорта - про данные, которые вы вставляете. Скопируйте ссылку заново.
Поможет ли смена сервера?
При сбое ядра - часто да: попробуйте два-три сервера из списка, прежде чем искать причину на устройстве.
Ошибка запуска ядра и EOF
Запишите первую содержательную строку ошибки и проверьте, возникает ли она на другой конфигурации. Перезапустите клиент и установите актуальную совместимую версию из официального источника. EOF сам по себе не указывает на единственную причину; если ошибка остаётся, отправьте в поддержку обезличенный фрагмент журнала, скрыв адреса и ключи.