Happ VPN
Тарифы

Импорт конфигурации в Happ по QR-коду

Автор
Дмитрий Соколов, ведущий технический автор
Проверил:
Артём Волков
Проверено:
Опубликовано:
, обновлено
Версия гайда:
1.0

Коротко

Чтобы импортировать по QR-коду в Happ, откройте добавление по кнопке «+», выберите сканирование камерой и наведите её на код — конфигурация или подписка добавится автоматически. На телевизоре QR-код обычно сканируют не пультом, а камерой другого устройства с уже настроенным Happ.

QR-код в Happ — это просто другой способ передать ту же ссылку, что и через буфер обмена: приложение считывает изображение камерой и распознаёт схему протокола или подписки внутри. Импорт занимает несколько секунд и не требует набора текста, поэтому особенно полезен там, где неудобно вставлять длинную строку — на телевизоре или при переносе конфигурации между двумя своими устройствами. Для сканирования Happ запрашивает разрешение на камеру: без него распознавание не начнётся. На Android TV и Apple TV процесс устроен немного иначе — код часто показывает сам телевизор, а сканирует его камера телефона с уже добавленной конфигурацией.

Когда QR-код удобнее ссылки

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

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

Как импортировать по QR-коду на телефоне и компьютере

  1. Откройте добавление в Happ

    Результат: Открыто меню способа импорта по кнопке «+» на главном экране.

  2. Выберите сканирование камерой

    Результат: Открылся экран камеры внутри приложения.

  3. Разрешите доступ к камере, если система спрашивает

    Разрешение запрашивается один раз при первом использовании сканера в приложении.

    Результат: Экран камеры показывает изображение, а не заглушку с просьбой дать разрешение.

  4. Наведите камеру на QR-код

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

    Результат: Код распознан, и Happ показывает, что добавляет конфигурацию или подписку.

  5. Дождитесь добавления

    Результат: Сервер или подписка появились в списке на главном экране.

  6. Проверьте пинг и подключение

    Результат: У сервера есть пинг в миллисекундах, а «Проверить текущее соединение» показывает задержку.

Как перенести конфигурацию на телевизор

На Android TV и Apple TV направление обычно обратное: не телевизор сканирует чужой код, а телефон сканирует код с экрана телевизора.

УстройствоКак проходит перенос по QR-коду
Android TVПри первом запуске телевизор показывает QR-код; отсканируйте его камерой Happ на телефоне или Android, чтобы передать подписку по локальной сети.
Apple TVНа экране импорта Apple TV показывается код; отсканируйте его из Happ на iPhone или Android в той же сети Wi-Fi, затем выберите, что отправить.
Если локальная сеть не сработалаИспользуйте Web Import: на экране импорта телевизора откройте раздел с сайтом tv.happ.su и введите временный код или отсканируйте показанный там QR-код через интернет.

Экран импорта на Apple TV не стоит закрывать до завершения переноса — код на нём обновляется автоматически, пока сессия активна.

Отличия по платформам

ПлатформаОсобенность работы с QR-кодом
Android, iOSСканирование встроено в экран добавления; для показа своего QR-кода используйте функцию «Поделиться» у нужного сервера.
Windows, macOS, LinuxПоказать конфигурацию QR-кодом можно, а вот сканирование камерой для импорта обычно не требуется — проще вставить ссылку из буфера обмена.
Android TV, Apple TVОсновной способ импорта — считать код с экрана телевизора камерой другого устройства, а не наоборот.

Проверка результата

  • Камера получила разрешение и открывает изображение при сканировании.
  • После наведения на код Happ показал, что распознал конфигурацию или подписку, а не ошибку.
  • Сервер или подписка появились в списке на главном экране.
  • У добавленного сервера отображается пинг в миллисекундах.
  • Подключение проходит, «Проверить текущее соединение» показывает задержку, а не тайм-аут.

Если сканирование не помогло

Что видно в HappВозможная причинаГде разбор
Камера не реагирует на кодНе выдано разрешение на камеру или мешает блик, засветкапроверьте разрешения устройства в системных настройках
Конфигурация {config type} не валиднаяВ QR-коде повреждённая или устаревшая ссылкаКонфигурация не валидная
«Неизвестный тип контента»В коде не ссылка Happ, а посторонний текст или сайтНеизвестный тип контента
Телевизор не видит QR-код по локальной сетиТелефон и телевизор в разных сетях Wi-Fiподключите оба устройства к одной сети или используйте Web Import

Если код распознаётся, но приложение сразу показывает ошибку формата, дело не в сканировании, а в самой ссылке — уточните у того, кто выдал QR-код, актуальна ли она ещё.

Главное

  • QR-код в Happ кодирует обычную ссылку — конфигурации, подписки или happ://crypto, а не отдельный формат данных.
  • Для сканирования приложению нужно разрешение на камеру устройства — без него распознавание не запускается.
  • На Android TV и Apple TV чаще сканируют наоборот: телевизор показывает код, а считывает его камера телефона с уже настроенным Happ.
  • Если провайдер прислал QR-код образом, а не ссылкой текстом, распознать его тоже можно — было бы на что навести камеру.
  • Неудачное сканирование обычно связано с камерой или освещением, а не с содержимым самого кода.

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

Что делать, если камера в Happ не распознаёт QR-код?

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

Нужно ли отдельное разрешение на камеру для импорта по QR-коду в Happ?

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

Можно ли создать QR-код конфигурации на компьютере, если там нет камеры для сканирования?

Да, создание и сканирование — разные операции. На Windows, macOS и Linux конфигурацию можно показать в виде QR-кода функцией «Поделиться» и отсканировать его камерой телефона или другого устройства. А для импорта на сам компьютер обычно проще воспользоваться буфером обмена, а не искать способ подключить камеру к приложению.

Почему QR-код для Android TV не сработал по локальной сети?

Чаще всего телефон и телевизор оказываются в разных сетях — например, в разных диапазонах Wi-Fi 2,4 и 5 ГГц одного роутера, или гостевая сеть изолирует устройства друг от друга. Подключите оба устройства к одной и той же сети и повторите попытку; если не поможет, на телевизоре есть запасной способ — Web Import через сайт tv.happ.su.

Можно ли отсканировать один и тот же QR-код конфигурации на нескольких устройствах?

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

Что означает сообщение о нераспознанном содержимом после сканирования QR-кода?

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

Упомянутые темы

Похожие материалы

Разделы по теме

Источники

  1. Документация Happ: поделиться конфигурацией — обращение 28 сентября 2026
  2. Документация Happ: добавление конфигурации и подписки — обращение 28 сентября 2026
  3. Документация Happ: Android TV — обращение 28 сентября 2026
  4. Документация Happ: Apple TV (tvOS) — обращение 28 сентября 2026