Не получается добавить ключ или подписку
- Автор
- Дмитрий Соколов, ведущий технический автор
- Проверил:
- Артём Волков
- Проверено:
- Опубликовано:
- , обновлено
- Версия гайда:
- 1.0
Коротко
Если Happ не добавляет ключ или подписку, определите, что вы вставляете — ссылку, обычную подписку или зашифрованную happ://crypt — и каким способом. Чаще всего причина в неполном копировании, неподходящем способе импорта или недоступном сервере подписки.
Добавление сервера в Happ — не одна операция, а несколько разных: ручной ввод, вставка ссылки из буфера обмена, сканирование QR-кода, переход по диплинку и добавление подписки по адресу. У каждого способа свои точки отказа. Ссылка может быть скопирована с обрывом или пробелом, буфер обмена может быть недоступен приложению, а сервер подписки может не ответить за отведённое время. Если Happ уже показал текст сообщения, у него есть отдельный разбор с точным решением; эта страница — про то, как найти причину, когда понятно только одно: импорт не сработал.
Что может пойти не так
Добавление сервера в Happ — это не одна операция. Приложение поддерживает ручной ввод, импорт ссылки и добавление подписки, и у каждого способа своя точка отказа: содержимое буфера обмена, качество копирования, доступность сервера провайдера.
Ниже — причины, из-за которых импорт не завершается, от самых частых к редким.
| Причина | Как проверить | Что сделать |
|---|---|---|
| Ссылка скопирована не полностью или с пробелом | Вставьте буфер обмена в заметки и сравните с оригиналом | Скопируйте ссылку заново целиком, лучше кнопкой копирования у провайдера |
| Способ импорта не подходит типу данных: пытаетесь вставить зашифрованную ссылку как обычный ключ | Посмотрите на начало ссылки: happ://crypt требует того же способа, что и обычная подписка | Используйте QR-код или диплинк вместо ручного разбора ссылки |
| Приложению не удаётся прочитать буфер обмена (частый случай — iOS, где нужно разрешение на вставку) | Откройте системные настройки и проверьте, разрешена ли вставка из других приложений | Разрешите вставку или воспользуйтесь QR-кодом и диплинком |
| Сервер подписки не отвечает за отведённое время | Подождите завершения индикатора загрузки и прочитайте текст ошибки | При «Timeout при добавлении подписки» см. разбор ошибки |
| Формат ссылки не распознан: опечатка в протоколе, обрезанные параметры | Сверьте начало ссылки с поддерживаемыми протоколами: vless, vmess, trojan, ss, socks, hysteria2/hy2 | Попросите провайдера выслать ссылку заново, лучше кнопкой копирования, а не текстом в чате |
| На Android TV в буфере обмена нет данных, потому что копировать длинную ссылку пультом неудобно | Проверьте, где лежит исходная ссылка — вероятно, на телефоне, а не на самом ТВ | Передайте подписку с телефона по QR-коду при первом запуске или через Web Import |
Диагностика по шагам
Определите тип данных
Посмотрите на начало строки. Протокол вида
vless://— это отдельный сервер. Веб-адрес — обычная подписка.happ://crypt— зашифрованная подписка, у которой скрыты и адрес, и параметры серверов.Результат: Вы точно знаете: это отдельный ключ, обычная подписка или зашифрованная ссылка happ://crypt.
Проверьте целостность данных
Вставьте буфер обмена в заметки или адресную строку браузера перед тем, как переключаться в Happ. Так вы отделите проблему с самими данными от проблемы с импортом.
Результат: Вставленный в заметки текст совпадает с оригиналом от начала до конца, без обрывов и лишних пробелов.
Выберите подходящий способ импорта
Для короткого ключа обычно проще буфер обмена или ручной ввод. Для длинной или зашифрованной ссылки надёжнее QR-код: он переносит данные без ручного копирования.
Результат: Happ предлагает нужный пункт: вставку из буфера, QR-код, ручной ввод или переход по диплинку.
Запустите импорт и дождитесь результата
Не запускайте импорт повторно, пока идёт предыдущая попытка: для подписки это лишний запрос к серверу провайдера, который может увеличить время ответа.
Результат: Индикатор загрузки исчезает, и появляется либо новый сервер в списке, либо текст ошибки.
Прочитайте точный текст сообщения
Если текст появился, найдите его разбор на странице конкретной ошибки — там подробно про причину и решение именно этого сообщения.
Результат: У вас есть формулировка ошибки Happ или уверенность, что сообщения не было вовсе.
Проверьте способ на другом устройстве или сети
Если та же ссылка добавляется на другом устройстве или в другой сети, причина не в самой ссылке, а в конкретном устройстве, буфере обмена или сети первого раза.
Результат: Понятно, воспроизводится ли проблема на другом телефоне, компьютере или Wi-Fi.
Импорт на Android TV и Apple TV
На телевизорах способ импорта отличается сильнее всего: пультом неудобно ни печатать, ни копировать длинные ссылки.
| Платформа | Как обычно передают подписку |
|---|---|
| Android TV | При первом запуске Happ предлагает принять подписку по QR-коду с телефона в локальной сети; удалённо — сайт tv.happ.su («Web Import», код или QR) или API-запрос от провайдера |
| Apple TV | На экране импорта телефон с Happ сканирует QR-код с экрана телевизора; альтернативный путь — тот же tv.happ.su |
Если на ТВ ссылка не добавляется, а на телефоне та же подписка работает, причина почти всегда в способе передачи, а не в самой подписке.
Проверка результата
- Тип данных определён: ключ, обычная подписка или зашифрованная ссылка.
- Вставленные данные при проверке в заметках совпадают с оригиналом целиком.
- Выбран способ импорта, подходящий типу данных и устройству.
- Получен либо новый сервер в списке серверов, либо точный текст сообщения об ошибке.
- Если сообщение было — оно проверено на отдельной странице разбора ошибки.
Когда обращаться к провайдеру
Если ссылка проверена по всем шагам выше, а сервер подписки всё равно не отвечает или отдаёт данные, которые Happ не может распознать, дело на стороне провайдера: адрес подписки, срок её действия или формат ссылки задаёт он.
Опишите провайдеру точный текст сообщения Happ, платформу и способ импорта, которым вы пользовались. Если он выдал ссылку на зашифрованную подписку, проверить её адрес самостоятельно нельзя — только провайдер знает, что за ней скрыто.
Общая диагностика подключения, если сервер уже добавлен, но не работает, — на странице VPN-подключение не работает.
Главное
- Happ поддерживает три способа добавления сервера: ручной ввод, импорт ссылки (из буфера обмена, по QR-коду или диплинком) и добавление подписки по адресу.
- Обычная подписка отдаёт конфигурации в открытом виде, а зашифрованная начинается с happ://crypt и скрывает адрес и параметры серверов даже от самого пользователя.
- Сервер подписки Happ ждёт по умолчанию 9 секунд; провайдер с Provider ID может задать своё значение от 5 до 15 секунд.
- На Android TV клавиатуры для копирования ссылки часто нет, поэтому подписку удобнее передавать с телефона по QR-коду или через Web Import на tv.happ.su.
- Если Happ показал точный текст сообщения об ошибке, разбор этого текста и решение — на отдельной странице ошибки, а не в общей диагностике импорта.
Частые вопросы
Как понять, что я пытаюсь добавить: ключ, подписку или зашифрованную ссылку?
Посмотрите на начало строки. Ключ отдельного сервера начинается с названия протокола: vless://, vmess://, trojan://, ss://, socks:// или hysteria2:// (hy2://). Обычная подписка — это веб-адрес вида https://…, который отдаёт список серверов. Зашифрованная подписка начинается с happ://crypt и не показывает ни адрес, ни параметры серверов, даже когда открыта в самом Happ.
Импорт зависает на одном месте — что это значит?
Если индикатор загрузки не пропадает дольше десяти секунд, скорее всего Happ ждёт ответа сервера подписки. По умолчанию на это отведено 9 секунд, у провайдеров с Provider ID — от 5 до 15. Дождитесь тайм-аута и посмотрите текст сообщения: если это «Timeout при добавлении подписки», причина разобрана на странице этой ошибки, а не в самой ссылке.
Можно ли добавить сервер без интернета?
Отдельный ключ — да: Happ разбирает такую ссылку локально и не обращается к серверу, пока вы не подключитесь. Подписке интернет нужен всегда, потому что список серверов приложение получает с сервера провайдера. Без сети попытка добавить подписку либо зависнет, либо сразу покажет ошибку о недоступности адреса.
Ссылка длинная и с непонятными символами — не повредилась ли она при копировании?
Длинные параметры вроде публичного ключа Reality или base64-строки в конце ссылки — это нормальная часть конфигурации, не повреждение. Проверить целостность ссылки просто: вставьте её в заметки и посмотрите, нет ли обрыва посередине, лишнего пробела в начале или переноса строки внутри. Само наличие символов вроде `%`, `+` или `=` ошибкой не является.
Почему на компьютере ссылка добавляется, а на телефоне та же самая — нет?
Если ссылка та же, разница обычно в способе передачи: скопировать длинную строку с экрана компьютера на телефон вручную неудобно, легко потерять символ. Отправьте ссылку себе в мессенджер и скопируйте её уже на телефоне, покажите QR-код с экрана компьютера, либо перешлите диплинк напрямую. Если ссылка — подписка, а не отдельный ключ, разница в результате может быть и в сети: сначала проверьте её на одном Wi-Fi с обоих устройств.
Кнопка «+» в Happ не даёт вставить ссылку — что не так?
Если пункт вставки из буфера обмена недоступен или неактивен, скорее всего в буфере в этот момент нет текста, который Happ распознаёт как ссылку. Вставьте буфер в заметки и убедитесь, что там именно ссылка, а не картинка и не старый текст. Если текст есть, но кнопка всё равно не работает, попробуйте ручной ввод: «+» → «Ручной ввод» → протокол → поля → «Готово».
Упомянутые темы
Похожие материалы
- Импорт ссылки в Happ: буфер обмена и диплинк
- «Буфер обмена пуст» в Happ: почему не видно ключа
- Неизвестный тип контента в Happ: что не так с данными
- Как поделиться подпиской или конфигурацией
- «Url подписки не валидна» в Happ: как проверить адрес
- Почему не работает VPN-подключение в Happ: диагностика
- Подписка Happ не обновляется автоматически
- Happ отключается сам: частые обрывы соединения
Разделы по теме
Источники
- Документация Happ: добавление конфигурации и подписки — обращение 28 сентября 2026
- Документация Happ: ошибки — обращение 28 сентября 2026
- Документация Happ: Android TV — обращение 28 сентября 2026
- Документация Happ: поделиться конфигурацией — обращение 28 сентября 2026