Ошибки в Happ и что с ними делать

Если сообщение появляется после вставки ссылки, начните с данных подключения. Если при обновлении — проверьте получение списка. Если после кнопки соединения — смотрите выбранный сервер, разрешения и состояние клиента. Сбой отдельного сайта при активном статусе требует ещё одного сравнения: другая страница может работать.

У Happ разные платформы и версии, поэтому формулировки могут отличаться. Не заменяйте текст с экрана пересказом «критическая ошибка». Важны контекст, действие перед сообщением и то, что остаётся доступным. Например, существующий список серверов и неудавшееся обновление — не то же самое, что полностью пустое приложение.

В справке разработчика об ошибках описаны сообщения импорта и обновления подписки. Для сообщений ядра, TLS и сетевых сбоев такой таблицы нет. Ниже формулировки из справки отделены от описаний: так мы не приписываем Happ придуманные строки и коды.

В справке есть и ещё два сообщения: о неизвестном действии DeepLink (приложение проигнорировало ссылку) и о неправильных данных профиля маршрутизации. Как устроены такие профили, объясняет статья маршрутизация Happ.

Happ построен на ядре Xray: так написано в описании приложения. В настольной версии режим TUN может работать и через другие компоненты, например sing-box; выбор зависит от настроек и подписки. Поэтому сообщение об ошибке ядра или ошибке запуска ядра говорит о компоненте, но не называет причину.

В релизах Desktop разработчик описывает такие случаи: TUN не запускался в Windows с выключенным IPv6 (исправлено в 4.6.0), зависшее ядро теперь перезапускается само (4.5.2), а профили с шифрами, которые новое ядро не поддерживает, отсекаются до подключения с понятным сообщением (4.1.1). Если у вас старая сборка, начните с обновления. Подробный порядок — в статье ошибка Xray core в Happ.

1. Сохраните наблюдение

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

2. Проверьте обычную сеть

   Отключите соединение Happ и откройте несколько привычных сайтов. Если не работает ничего, сначала разберитесь с передачей данных. Если проблема только через SIM-карту, используйте диагностику мобильного интернета. Не пытайтесь исправлять формат ссылки, когда устройству вообще недоступна сеть.

3. Сверьте данные доступа

   Получите исходную ссылку из кабинета своего сервиса. Не заменяйте её адресом оплаты или приглашением. Проверьте срок и разрешённое число устройств. Различия форматов разобраны в статье ключ для Happ. Ожидаемый результат — понятный источник данных и действующий доступ по условиям сервиса.

4. Сравните одну переменную

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

5. Проверьте версию клиента

   Сверьте установленную сборку с той, что предлагает страница скачать Happ. Для Windows разработчик держит в разделе ошибок отдельную инструкцию по обновлению системы: настольной версии нужна Windows 10 сборки 1809 и новее. Обновление может быть уместным, но не означает, что любая ошибка вызвана старой версией. Перед ним сохраните доступ к исходной ссылке.

Подготовьте систему и её версию, версию Happ, время попытки, тип сети и оператора. Добавьте выбранный сервер, действие перед ошибкой и точный текст. Укажите, работает ли другой сервер и получилось ли повторить проверку через другую сеть. Не пишите только «всё сломалось»: из такого сообщения нельзя выбрать следующий шаг.

Если сбой связан с оплатой или выдачей адреса, обращайтесь к сервису. Если приложение не запускается на совместимой системе и проблема воспроизводится независимо от вашей подписки, может понадобиться обращение к разработчику. Справочник не может проверить ваш аккаунт или сервер изнутри. Для Maxima (MXMA) начните со страницы подписки и кабинета.

Не отправляйте полный ключ в публичную задачу на GitHub. Журналы тоже могут содержать чувствительные данные. Передайте небольшой фрагмент вокруг ошибки, если его запросили, и сначала проверьте содержимое. Общие принципы сравнения описаны в статье Happ не работает.

• Пустой список после импорта. Начните с в Happ нет серверов, не переходите сразу к настройке ядра.
• Кнопка подключения заканчивается ошибкой. Продолжайте по Happ не подключается, сохранив точное сообщение.
• Статус включён, сайт не отвечает. Откройте подключено без доступа к сайтам и сравните другой ресурс.
• Через SIM доступны лишь отдельные страницы. После проверки сети прочитайте про белые списки в Happ.