Ошибки Happ: TLS-рукопожатие, ошибка запуска ядра, Xray core, туннель и тайм-аут — что значат и как исправить

Тексты ошибок ниже — такие, как их показывает Happ. Одна и та же беда на телефоне и компьютере называется чуть по-разному, а на iPhone часто по-английски, поэтому ищите свою формулировку по смыслу. Сначала — что делать с любой ошибкой, потом — разбор по каждой.

Что сделать с любой ошибкой

1. Выключите VPN и обновите подписку кнопкой ⟳ на её карточке. Сервис мог заменить серверы, а с выключенным VPN подписка скачивается надёжнее.
2. Выберите другой сервер. Ошибка на одном сервере — дело в нём, на всех сразу — в подписке, сети или устройстве.
3. Проверьте другую сеть: Wi-Fi вместо мобильного интернета или наоборот.
4. Включите автоматические дату и время. Happ сам проверяет часы и при сбое пишет: «Обнаружена проблема: дата и время установлены неверно».
5. Обновите Happ и перезагрузите устройство.

По какой ошибке что чинить

Сервер не отвечает

«Ошибка TLS рукопожатия»

Когда Happ проверяет сервер, он сначала устанавливает соединение, а потом — шифрованное рукопожатие TLS: клиент и сервер договариваются о ключах. Ошибка значит, что до сервера Happ достучался, а договориться не вышло. Причины по убыванию частоты:

• Сервер не работает или недоступен из вашей сети — перегружен, выключен, его адрес блокирует провайдер. Самый частый случай, особенно с бесплатными ключами.
• Устарели параметры сервера. Сервис поменял настройки, а в Happ осталась старая подписка — обновите её.
• Сеть вмешивается в соединение — гостиничный или рабочий Wi-Fi, антивирус с проверкой зашифрованного трафика.
• Неверные дата и время на устройстве: без точных часов проверка шифрования не проходит.

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

«Ошибка: Сервер закрыл соединение», «н/д», «Тайм-аут» в пинге

Сервер оборвал соединение или не ответил вовремя — «н/д» значит «нет данных». Лечится так же: обновить подписку и выбрать другой сервер. Если серверы показывают «н/д» только при включённом VPN — выключите его и проверьте пинг заново: TCP- и ICMP-пинг на компьютере при активном TUN не работают, это нормально.

Подписка не скачивается

«Тайм-аут», «Данные подписки не были получены — превышен таймаут»

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

1. Выключите VPN и обновите подписку ещё раз.
2. Попробуйте другую сеть — часто помогает мобильный интернет.
3. Если сеть медленная — увеличьте ожидание: в настройках подписки есть «Тайм-аут запроса подписки», от 5 до 15 секунд.

«Получена ошибка от сервера при получении данных: HTTP 502» (а также 404, 403, 429)

Сервер подписки ответил, но кодом ошибки. Это ответ сервиса, а не сбой Happ:

• 502 — у сервиса сломался или перегружен сервер. Подождите и повторите; долго не проходит — напишите в поддержку сервиса.
• 404 — по этой ссылке ничего нет: ссылку отозвали, перевыпустили или скопировали с ошибкой. Возьмите актуальную у сервиса.
• 403 — доступ запрещён: например, подписка истекла или заблокирована. Проверьте срок в кабинете сервиса.
• 429 — слишком много запросов. Подождите несколько минут и не жмите обновление подряд.

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

«Ошибка сертификата», «Ошибка при обмене данными», «Не удалось выполнить SSL/TLS рукопожатие»

Happ не смог установить защищённое соединение с сервером подписки. Причины те же, что у TLS-ошибки выше: неверное время на устройстве, сеть, которая подменяет соединение (страница входа в гостиничный Wi-Fi, антивирус с проверкой HTTPS), или адрес подписки недоступен из вашей сети. На Android Happ может спросить: «Хотите попробовать получить данные о подписке в небезопасном режиме?» В небезопасном режиме Happ не проверяет, с тем ли сервером говорит, — соглашайтесь, только если доверяете сети. Надёжнее сначала исправить время и сменить сеть.

Не запустилось приложение

«Ошибка запуска ядра», «Ошибка Xray ядра», «Критическая ошибка Xray core»

Happ работает на ядре Xray — отдельной программе внутри приложения. Ошибка значит, что ядро не стартовало, и до связи с сервером дело не дошло. Сеть тут обычно ни при чём. На компьютере сообщение звучит как «Ошибка запуска ядра», на Android — «Ошибка Xray ядра», на iPhone пользователи видят «Критическая ошибка Xray core». Приписка EOF («end of file») значит, что ответ ядра оборвался на старте — лечится так же.

• Испорчен один сервер в подписке. Выберите другой сервер и обновите подписку.
• Не хватает файлов маршрутизации. Happ пишет: «Ядро не может быть запущено, поскольку отсутствует секция … в подключенном файле …» и предлагает две кнопки: «Обновить» — скачать гео-файлы заново и включить VPN снова, «Запуск» — подключиться без маршрутизации.
• Порт занят. «Порт … уже используется другим приложением. Попробуйте перезагрузить устройство» — на компьютере это почти всегда зависший процесс Happ от прошлого запуска: Happ на компьютере не запускается или не обновляет подписку.
• На iPhone не хватает памяти. iOS выделяет VPN-приложению мало памяти — документация Happ называет 50 МБ, — и ядро падает на старте, если подписка или файлы маршрутизации слишком большие. Обновите подписку и Happ; повторяется — это вопрос к сервису.
• Мешает другой VPN или старая версия Happ — закройте другие VPN и обновите приложение.

«Ошибка: не удалось запустить туннель», «Failed to start TUN process via daemon», «Ядро завершило работу до создания TUN-интерфейса»

Это компьютер: не поднялся режим TUN, в котором через VPN идёт вся система. Чаще всего причина одна из этих:

• Завис фоновый процесс Happ. Перезагрузите компьютер или завершите Happ и Xray в Диспетчере задач: Happ на компьютере не запускается или не обновляет подписку.
• Мешает другая программа. Другой VPN, его виртуальный адаптер, антивирус с веб-фильтром. С версии 4.5.2 Happ сам предупреждает, если видит такие программы. Закройте их или добавьте Happ в исключения: Антивирус мешает VPN: добавьте sing-box и Happ в исключения.
• Старая версия. Разработчик много чинил запуск TUN — например, в версии 4.6.0 исправил запуск на Windows с выключенным IPv6. Поставьте свежую версию.
• «Служба Happ Client недоступна» — сломалась фоновая служба. Сообщение само советует переустановить Happ — так и сделайте.

Если TUN так и не запускается, можно временно переключиться в режим «Прокси»: браузер заработает, но часть программ пойдёт мимо VPN.

«Ошибка загрузки гео файлов», «Ошибка Geo файлов», «Ошибка: ссылки на геофайлы некорректны»

Гео-файлы — базы geoip и geosite, по которым работает маршрутизация. Happ скачивает их в фоне по ссылкам из профиля маршрутизации, и если загрузка не уложилась в 3 минуты, останавливает её: на главном экране появляется ошибка, у профиля — красный восклицательный знак. Ошибка уходит сама, когда файлы скачаются или проблемный профиль удалят. Что делать: повторите загрузку в другой сети или с выключенным VPN; срочно нужен интернет — подключитесь без маршрутизации (кнопка «Запуск»). «Ссылки некорректны» — ошибка в профиле, который прислал сервис: пишите ему.

«В соединении прокси-сервером отказано» и другие ошибки браузера

Это не Happ, а браузер на компьютере: он пытается идти через прокси, который Happ включил в режиме «Прокси», а прокси уже не работает — Happ закрылся или завис. Перезапустите Happ или выключите системный прокси вручную: Happ на компьютер с Windows.

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

«Буфер обмена пуст», «URL подписки не валидна», «Неизвестный тип контента», «Конфигурация … не валидная» — ссылку скопировали не целиком или это не подписка. Разбор — Как настроить Happ и добавить подписку.

Если подписка от Демьяныча

Наши серверы проверяются из обычных российских сетей каждые 2 минуты: перестал отвечать — автоматика ставит запасной, а приложение получает его при обновлении подписки. Поэтому почти любая серверная ошибка у нас лечится первым шагом — обновить подписку: Как обновить подписку в приложении. Проверить, загружается ли подписка из вашей сети и не мешает ли другой VPN, можно за 15 секунд: Проверка связи: какой у вас IP и работает ли VPN.

Ошибка не ушла — пришлите снимок экрана и лог в @demyan_support: Как отправить логи. Основное приложение у нас — sing-box: у него нет того, что бывает только у Happ на компьютере, — зависшего фонового процесса и режима «Прокси»: Перейти на sing-box с Karing, INCY или Happ.

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

Источники

• Happ — описание ошибок
• Happ — пинг: как проходит проверка сервера
• Happ — тайм-аут запроса подписки и режимы туннеля
• Happ — маршрутизация, гео-файлы и память iOS
• Happ для компьютера — примечания к версиям на GitHub
• MDN — коды состояния ответа HTTP