Как добавить ключ в Happ

Если ключа ещё нет

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

Сначала получите ссылку

У сервиса, где вы оформили подписку, ссылка лежит на главном экране кабинета или в боте — это то, зачем туда заходят чаще всего. Рядом с ней есть кнопка копирования.

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

Ссылка выглядит так: https://домен-сервиса/sub/длинный-идентификатор. Идентификатор и есть секрет — он отличает вашу подписку от чужой.

⚠️ Адрес страницы кабинета из строки браузера — это не ссылка-подписка. По нему приложение может получить форму входа вместо конфигурации и сообщить «Неизвестный тип контента».

Способ 1. Из буфера обмена

1. Скопируйте ссылку кнопкой в кабинете сервиса.
2. Откройте Happ, нажмите «+» в правом верхнем углу.
3. Выберите «Добавить из буфера обмена».
4. Приложение само обратится по ссылке и заполнит список серверов.

Если после этого список пуст — ссылка скопировалась не полностью либо сервис недоступен.

Способ 2. По QR-коду

Подходит, когда подписка открыта на компьютере, а подключить нужно телефон.

1. Откройте кабинет на компьютере и покажите QR-код подписки.
2. В Happ нажмите «+» → «Сканировать QR-код».
3. Наведите камеру.

Тот же путь работает для телевизора: код показывает телефон, сканирует приставка — если у неё есть камера. Если камеры нет, добавляйте ключ вручную.

Способ 3. Через deeplink

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

Способ 4. Вручную

Нужен, если у вас не ссылка-подписка, а одиночный конфиг vless://….

1. Скопируйте строку целиком, от vless:// до конца.
2. В Happ: «+» → «Вставить из буфера» или «Добавить вручную».
3. Проверьте, что в поле не осталось пробелов и переносов строки.

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

Как проверить, что всё получилось

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

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

Если ключ не принимается

Четыре частые причины, в порядке вероятности:

Скопировано не целиком

Самое частое. Скопируйте заново кнопкой.

В строке пробел или перенос

Бывает при пересылке через мессенджеры — они любят добавлять переносы в длинные ссылки.

Подписка истекла или отозвана

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

Сервер подписки не ответил за девять секунд

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