Ошибки Happ и их решение

Happ ошибка почти всегда сама подсказывает причину: в официальной документации разработчики разобрали все основные сообщения, и большинство из них связаны не с приложением, а с тем, что вы в него вставили. «Буфер обмена пуст» значит, что перед импортом ничего не скопировано, «Url подписки не валидна» и «Конфигурация не валидная» — что ссылка или ключ скопированы с ошибкой, «Неизвестный тип контента» — что в буфере не ссылка, а другой текст, а «Timeout при добавлении подписки» — что сервер подписки не ответил за 9 секунд. Отдельно стоит «Тайм-аут» при проверке пинга: так приложение показывает, что сервер недоступен. Почти все эти ошибки решаются повторным копированием ссылки, ожиданием, обновлением подписки или самого приложения. Ниже — где искать описание ошибок и разбор каждого сообщения: буфер обмена, невалидные ссылки, конфигурации и JSON, DeepLink, тип контента, маршрутизация, тайм-ауты, геофайлы, ошибки ядра и TLS, запуск на Windows, лимит устройств, разрешение VPN и как сообщить разработчикам о настоящей ошибке приложения.

Где искать описание ошибок

Официальная документация

На официальном сайте Happ есть раздел Errors с описанием основных сообщений приложения. Там коротко объяснено, что значит каждая ошибка. Мы разбираем их подробнее и добавляем решения. Если сообщение в приложении отличается от нашего, смотрите официальную документацию. Приложение обновляется, тексты могут меняться.

Текст сообщения

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

Приложение или подписка

Большинство ошибок связаны с подпиской, ссылкой или сервером, а не с самим Happ. Разработчики приложения не управляют серверами провайдеров. Поэтому многие проблемы решает провайдер. Если же приложение падает или не запускается, дело в Happ или устройстве. Это главное разделение. Подробнее — в статье о том, что делать, если Happ не работает.

Буфер обмена пуст

Что значит

Ошибка «Буфер обмена пуст» появляется, когда вы выбрали импорт из буфера, а там ничего нет. По документации, скорее всего, вы забыли скопировать данные перед импортом. Иногда копирование не срабатывает с первого раза. Бывает, что буфер очистился. Это самая простая ошибка.

Как исправить

Вернитесь в сообщение, кабинет или бот сервиса и скопируйте ссылку снова. Используйте кнопку «Копировать», если она есть. Затем откройте Happ, нажмите «+» и выберите вставку из буфера. Ссылка добавится. Если нет, проверьте, что именно скопировалось.

На iPhone

На iPhone при вставке система может спросить разрешение на вставку из другого приложения. Если нажать «Не разрешать», Happ не получит данные и покажет ошибку. Повторите и нажмите «Разрешить вставку». Можно разрешить всегда в настройках приложения. Тогда вопрос не будет появляться.

Url подписки не валидна

Что значит

Сообщение «Url подписки не валидна» значит, что переданный адрес содержит ошибки или недопустимые символы. Чаще всего ссылку скопировали не полностью: длинные ссылки легко обрезать. Бывает, что захвачены лишние пробелы или переносы строк. Иногда ссылка повреждена при пересылке. Разработчики советуют проверить содержимое буфера.

Как исправить

Скопируйте ссылку заново целиком, лучше кнопкой «Копировать» у сервиса. Не захватывайте пояснения рядом со ссылкой. Проверьте, что ссылка начинается с https:// или happ://. Добавьте снова. Подробнее о форматах — в статье про ссылки для Happ.

Если повторяется

Если ошибка повторяется с правильно скопированной ссылкой, возможно, ссылка устарела или повреждена у провайдера. Попросите новую ссылку в кабинете или поддержке сервиса. Например, свежую ссылку подписки можно получить в VPNType. Затем добавьте её. Обычно это решает проблему.

Конфигурация не валидная

Что значит

Сообщение «Конфигурация не валидная» с указанием типа — vless, vmess, trojan и других — значит, что ключ сервера содержит ошибки или недопустимые символы. По документации, нужно проверить ссылку в буфере обмена. Причина та же: неполное копирование или лишние символы. Иногда ключ повреждён при пересылке. Бывает и ошибка при ручном вводе.

Как исправить

Скопируйте ключ заново, от названия протокола до последнего символа. Проверьте, что в начале нет пробела. Если ключ пришёл картинкой, отсканируйте QR-код вместо ручного ввода. Добавьте снова. Обычно этого достаточно.

Ручной ввод

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

Невалидная JSON-конфигурация

Что значит

Ошибка «Невалидная (массив) конфигурация JSON» появляется, если переданный JSON содержит ошибки или недопустимые символы. JSON-конфигурациями пользуются в основном опытные пользователи и провайдеры. Обычному пользователю эта ошибка встречается редко. Причина обычно в повреждённом или неполном тексте. Иногда — в лишней запятой или скобке.

Как исправить

Скопируйте JSON заново целиком. Если вы редактировали его вручную, проверьте синтаксис в любом валидаторе JSON. Убедитесь, что все скобки закрыты и нет лишних запятых. Затем добавьте снова. Если JSON прислал провайдер, попросите исправленный.

Проще — ссылка

Если провайдер может выдать обычную ссылку подписки вместо JSON, используйте её. Ссылки проще и реже ломаются при копировании. JSON нужен для особых настроек. Новичкам он не обязателен. Выбирайте простой путь.

Неизвестное действие DeepLink

Что значит

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

Как исправить

Обновите Happ до последней версии из магазина или с GitHub. Затем нажмите кнопку «Добавить в Happ» снова. Если не помогло, скопируйте ссылку подписки и вставьте её из буфера. Это обходит проблему диплинка. Подписка добавится.

Сообщите сервису

Если диплинк сервиса не работает в свежей версии Happ, сообщите об этом в поддержку сервиса. Возможно, у них ошибка в формате ссылки. Пусть пришлют обычную ссылку подписки. Её можно добавить из буфера. Это решает вопрос.

Неизвестный тип контента

Что значит

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

Как исправить

Скопируйте только саму ссылку или ключ, без пояснений. Проверьте начало: https://, happ://, vless://, vmess://, trojan://, ss://, socks://, hysteria2:// или hy2://. Если начало другое, вы скопировали не то. Повторите копирование. Затем добавьте снова.

Ссылка для другой программы

Иногда сервисы выдают ссылки в форматах для других программ. Happ может их не понимать. Уточните у сервиса, есть ли ссылка для Happ. Большинство сервисов её дают. Используйте именно её.

Ошибка импорта маршрутизации

Что значит

Сообщение «Неправильные данные для импортирования профиля маршрутизации» значит, что профиль правил содержит ошибки или недопустимые параметры. Профили добавляют ссылками happ://routing или они приходят с подпиской. Если ссылка повреждена, импорт не удастся. Бывает и ошибка в самом профиле. Приложение откажется его добавить.

Как исправить

Скопируйте ссылку профиля заново целиком. Если создавали профиль на официальном сайте routing.happ.su, создайте его снова. Если профиль прислал провайдер, попросите исправленный. Добавьте профиль ещё раз. После добавления переподключитесь, чтобы правила применились.

Применение правил

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

Timeout при добавлении подписки

Что значит

При добавлении или обновлении подписки приложение отправляет запрос на сервер подписки. По документации, если в течение 9 секунд ответа нет, отображается ошибка Timeout. Значит, сервер провайдера недоступен, перегружен или медленно отвечает. Иногда виновата ваша сеть. Само приложение работает правильно.

Как исправить

Подождите несколько минут и попробуйте снова. Переключитесь между Wi-Fi и мобильным интернетом. Проверьте, есть ли интернет вообще. Если ошибка не проходит, напишите провайдеру подписки. Возможно, у них временные проблемы.

Обновление уже добавленной

Если ошибка появляется при обновлении уже добавленной подписки, серверы в списке остаются прежними. Ими можно пользоваться, если они рабочие. Обновите подписку позже. Если серверы тоже не работают, проблема на стороне провайдера. Обратитесь в поддержку.

Тайм-аут при проверке

Что значит

«Тайм-аут» рядом с сервером при проверке пинга значит, что сервер не ответил. Так же отображается результат функции «Проверить текущее соединение», если сервер недоступен. Это не сбой приложения, а сигнал, что сервер не работает. Причин несколько. Их легко проверить.

Причины

Самые частые причины: истёк срок подписки, провайдер сменил серверы, сервер выключен или перегружен, а протокол сервера не проходит в вашей сети. Иногда виноваты ограничения мобильного интернета. Если «Тайм-аут» у одного сервера, выберите другой. Если у всех, проверьте подписку. Это быстрая диагностика.

Как исправить

Проверьте срок подписки в кабинете сервиса и продлите при необходимости. Обновите подписку. Попробуйте серверы на другом протоколе. Смените сеть. Если ничего не помогло, обратитесь к провайдеру.

Ошибка загрузки геофайлов

Что значит

Профили маршрутизации используют геофайлы, которые приложение загружает в фоне. По документации, если загрузка не завершилась за 3 минуты, процесс останавливается. На главном экране появляется сообщение об ошибке. Рядом с проблемным профилем в списке — красный восклицательный знак. Это связано с сетью или источником файлов.

Как исправить

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

Встроенные файлы

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

Ошибка ядра

Что это

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

Общие шаги

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

Конфликты

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

Ошибка TLS

Что это

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

Общие шаги

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

Сеть

Некоторые сети вмешиваются в защищённые соединения: публичный Wi-Fi, корпоративные сети. Попробуйте мобильный интернет. Если там работает, проблема в сети. Используйте другую сеть. Или серверы на другом протоколе.

Не запускается на Windows

Требования

Современные версии Happ для компьютеров построены на Qt 6 и требуют Windows 10 начиная со сборки 1809 или Windows 11. На Windows 7 и 8 они не запустятся. Для старых систем есть Legacy-версия 1.0.2 на GitHub. Проверьте версию системы командой winver. Подробнее — в статье про Happ на ПК.

Обновление Windows

В официальной документации есть инструкция по обновлению Windows: «Параметры» → «Обновление и безопасность» → «Центр обновления Windows» → «Проверить наличие обновлений». Установите найденное и перезагрузите компьютер. Это часто решает проблему запуска. Если появится кнопка «Возобновить обновления», нажмите её. Затем запустите Happ снова.

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

Если приложение всё равно не запускается, удалите его и установите заново с GitHub Happ-proxy. Перед этим сохраните ссылки подписок. Проверьте, что скачали установщик нужной архитектуры: x64 или arm64. Антивирус может мешать установке. Добавьте официальный файл в исключения.

Подписка не добавляется на устройство

Лимит устройств

Если подписка добавляется на одном устройстве и не добавляется на другом, возможно, исчерпан лимит устройств. Провайдеры создают ссылки с ограничением числа установок. Это не ошибка приложения. Освободите место в кабинете сервиса. Или выберите тариф на несколько устройств.

Привязка к устройству

Есть ссылки, привязанные к одному конкретному устройству. Приложение проверяет совпадение идентификатора. На другом устройстве такая ссылка не добавится. Попросите у провайдера ссылку для нового устройства. Это нормальная процедура.

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

Иногда подписка не добавляется из-за старой версии Happ, которая не поддерживает новый формат, например зашифрованные ссылки crypt5. Обновите приложение. Затем добавьте подписку снова. Это частая причина. Держите автообновления включёнными.

Ошибки разрешения VPN

Отказали в разрешении

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

Другой VPN активен

Одновременно может работать только одно VPN-подключение. Если активен другой VPN или прокси-клиент, Happ не подключится. Отключите другое приложение. Подключитесь снова. Это ограничение системы.

Постоянная VPN другого приложения

На Android, если для другого приложения включена «Постоянная VPN», Happ не сможет подключиться. Отключите эту настройку для другого приложения в сетевых настройках VPN. Затем подключите Happ. При желании включите постоянную VPN для Happ. Тогда подключение будет восстанавливаться само.

Как сообщить об ошибке

Баг-трекер

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

Что не отправлять разработчикам

Не пишите разработчикам о проблемах с подпиской, оплатой, скоростью и серверами. Они не видят ваших подписок. Такие вопросы решает провайдер. Сначала проверьте документацию. Многие ошибки там уже разобраны.

Провайдеру

Провайдеру сообщайте о тайм-аутах при добавлении подписки, недоступных серверах, лимитах устройств и неработающих диплинках. Опишите сообщение об ошибке и что уже пробовали. Укажите устройство и сеть. Так поддержка поможет быстрее. Это экономит время всем.

Пример 1: ошибка URL

Артур получил ссылку подписки в письме и скопировал её вручную. Happ показал «Url подписки не валидна».

Он открыл письмо снова и увидел, что выделение обрезало конец ссылки. Артур нажал кнопку «Копировать» в кабинете сервиса и вставил ссылку.

Подписка добавилась. Артур понял, что ошибки URL почти всегда из-за копирования. Теперь он использует только кнопку копирования.

Пример 2: тайм-аут при добавлении

Мила добавляла подписку вечером и получила «Timeout при добавлении подписки». Она несколько раз переустановила приложение, но ошибка не уходила.

Потом Мила прочитала в документации, что это значит: сервер подписки не ответил за 9 секунд. Она написала в поддержку сервиса.

Сервис подтвердил временный сбой и через полчаса всё исправил. Подписка добавилась с первого раза. Переустанавливать приложение было не нужно.

Итог

Ссылки

«Буфер пуст», «Url не валидна», «Неизвестный тип контента» — скопируйте ссылку заново целиком.

Серверы

Timeout и «Тайм-аут» — сервер или подписка недоступны: подождите, обновите подписку, смените сервер.

Приложение

DeepLink, crypt5 и запуск — обновите Happ; настоящие сбои — в баг-трекер.

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

Что значит «Url подписки не валидна» в Happ?

Ссылка скопирована с ошибкой — скопируйте её заново целиком.

Почему Happ пишет Timeout при добавлении подписки?

Сервер подписки не ответил за 9 секунд — подождите или напишите провайдеру.

Что значит «Тайм-аут» у сервера?

Сервер недоступен: истекла подписка, сервер сменился или протокол не проходит в сети.