QR-код конфигурации: что это
- Автор
- Екатерина Лебедева, редактор раздела knowledge base
- Проверил:
- Артём Волков
- Проверено:
- Опубликовано:
- , обновлено
- Версия гайда:
- 1.0
Коротко
QR-код конфигурации в Happ — это изображение, в которое зашифрована ссылка сервера, подписки или профиля маршрутизации. Его сканирует камера устройства, что удобнее, чем набирать длинную ссылку вручную, особенно на телевизоре.
Happ превращает ссылку конфигурации, подписки или маршрутизации в QR-код и умеет сканировать такие коды камерой устройства. Это нужно там, где неудобно набирать или копировать текст: при импорте на Android TV и Apple TV, при передаче сервера с телефона на телефон и при обмене конфигурацией через функцию «Поделиться». Внутри QR-кода — обычная ссылка вида vless:// или happ://, только в графическом виде. Если подписка зашифрована, в QR-код попадает зашифрованная ссылка целиком, и распознать за ней исходный адрес нельзя.
QR-код конфигурации — изображение, в которое Happ кодирует ссылку сервера, подписки или профиля маршрутизации, чтобы передать её между устройствами через камеру вместо ручного набора или копирования текста.
Что кодирует QR-код в Happ
QR-код в Happ никогда не бывает сам по себе: за ним всегда стоит обычная ссылка — конфигурации, подписки или профиля маршрутизации. Камера считывает изображение, распознаёт зашифрованный в нём текст и передаёт его тому же обработчику ссылок, что принимает vless://, happ:// и другие схемы.
Разница с обычной ссылкой — только в способе передачи. Текст ссылки можно скопировать в буфер обмена или открыть диплинком, а QR-код достаточно показать камере другого устройства, даже без общей сети или интернета в момент показа.
Где Happ использует QR-код
QR-код в приложении встречается в нескольких ролях.
| Сценарий | Что кодирует QR-код |
|---|---|
| Добавление конфигурации или подписки | ссылку сервера или адрес подписки |
| Функция «Поделиться» | ссылку выбранного сервера из списка |
| Импорт на Android TV | подписку, переданную с телефона по локальной сети |
| Импорт на Apple TV | выбранные данные, переданные с iPhone или Android |
| Web Import через tv.happ.su | временный код сессии, а не саму ссылку |
На телевизорах QR-код особенно полезен: набрать длинную ссылку пультом неудобно, а камера телефона считывает код с экрана телевизора за секунду. На Apple TV нужно не закрывать экран импорта до конца передачи — код там обновляется автоматически, пока сессия активна.
Пример
QR-код визуально представляет собой картинку, но логически — это та же строка, что и в обычной ссылке. Если навести на QR-код camера-декодер, а не Happ, она вернёт исходный текст, например:
vless://00000000-0000-0000-0000-000000000000@example.com:443?type=tcp&security=reality#ExampleДля зашифрованной подписки декодер вернёт не исходный адрес, а строку вида happ://crypto... — она защищена так же, как и при обычном копировании, и без ключей приложения бесполезна.
Отличия от похожих терминов
| Термин | Что это | Отличие от QR-кода |
|---|---|---|
| Конфигурация | данные одного сервера | то, что закодировано внутри QR-кода |
| Диплинк | ссылка, открывающая Happ напрямую | передаётся переходом по ссылке, а не через камеру |
| JSON-конфигурация | конфигурация в формате Xray-core | текстовый файл, а не изображение; в QR не кодируется целиком |
| Ключ доступа | секрет для подключения к серверу | часть содержимого ссылки, которая попадает в QR-код |
На практике выбор между способами передачи зависит от ситуации: ссылка из буфера обмена быстрее внутри одного устройства, диплинк удобен из чата или почты, а QR-код незаменим, когда между устройствами нет общего текстового канала — например, при переносе подписки на телевизор.
Главное
- QR-код в Happ — это способ передать ссылку конфигурации, подписки или маршрутизации, а не отдельный вид данных.
- Приложение и сканирует QR-коды камерой, и создаёт их для любого сервера через функцию «Поделиться».
- На Android TV и Apple TV QR-код — основной способ передать подписку с телефона, где её проще скопировать.
- QR-код зашифрованной подписки содержит саму зашифрованную ссылку, поэтому исходный адрес подписки из него не восстановить.
- Веб-сервисы tv.happ.su и routing.happ.su тоже используют QR-код и временный код для передачи данных на телевизор.
Частые вопросы
Как отсканировать QR-код конфигурации в Happ?
При добавлении конфигурации или подписки выберите способ импорта через камеру и наведите её на QR-код — приложение распознает ссылку автоматически. Тот же способ работает для подписки: код можно получить у провайдера или отсканировать на другом устройстве, где сервер уже добавлен. После распознавания сервер сразу появится в списке серверов Happ.
Как создать QR-код для своего сервера в Happ?
Если подписка не зашифрована и не скрыта, найдите сервер в списке, смахните его вправо и нажмите иконку со стрелкой. В открывшемся меню выберите «QR-код» — Happ покажет изображение, которое можно отсканировать другим устройством. Для зашифрованной подписки эта функция недоступна: узнать или передать её содержимое можно только у провайдера.
Зачем QR-код нужен при настройке Happ на телевизоре?
На Android TV и Apple TV неудобно набирать длинную ссылку пультом, поэтому Happ принимает подписку через QR-код с телефона. На Android TV приложение при первом запуске показывает код для сканирования из мобильного Happ по локальной сети. На Apple TV работает похожая схема: устройства должны быть в одной сети Wi-Fi, а экран импорта не стоит закрывать до завершения передачи.
Что делать, если телевизор не видит QR-код по локальной сети?
Убедитесь, что телефон и телевизор подключены к одной сети Wi-Fi, а не к разным диапазонам одного роутера. Если локальная передача не удаётся, воспользуйтесь Web Import: на экране импорта телевизора откройте раздел с сайтом, например tv.happ.su, и введите временный код или отсканируйте показанный там QR-код через интернет.
Безопасно ли пересылать QR-код своей подписки другим людям?
Нет, если ссылка внутри не зашифрована: тот, кто отсканирует такой QR-код, получит доступ к серверу и сможет использовать ваш ключ доступа. Обращайтесь с ним так же осторожно, как с самой ссылкой, и не выкладывайте его в открытые чаты. Для зашифрованной подписки риск ниже, но она не привязана к конкретному устройству, если провайдер отдельно не ограничил её HWID-ссылкой.
Чем QR-код отличается от диплинка happ://?
Диплинк — это ссылка, которая открывает Happ и сразу передаёт ему данные при переходе по ней, например из браузера или мессенджера. QR-код — способ передать ту же информацию через камеру, без интернета и без перехода по ссылке. Иногда они совмещаются: диплинк можно закодировать в QR-код для сканирования на устройстве, где его неудобно вставить текстом.
Упомянутые темы
Похожие материалы
Разделы по теме
Источники
- Документация Happ: поделиться конфигурацией — обращение 28 сентября 2026
- Документация Happ: добавление конфигурации и подписки — обращение 28 сентября 2026
- Документация Happ: Android TV — обращение 28 сентября 2026
- Документация Happ: Apple TV (tvOS) — обращение 28 сентября 2026