Happ VPN

Как добавить конфигурацию в Happ: ссылка, QR, happ://crypto

Автор
Екатерина Лебедева, редактор раздела knowledge base
Проверил:
Артём Волков
Проверено:
Опубликовано:
, обновлено
Версия гайда:
1.0

Коротко

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

Happ принимает данные тремя путями — ручной ввод по кнопке «+», ссылка протокола и подписка, — а технически они попадают в приложение одним из четырёх способов: через буфер обмена, сканированием QR-кода, диплинком happ://crypto или как JSON-конфигурация, которую ядро Xray-core использует без изменений. Буфер обмена и QR-код подходят почти всегда, диплинк работает при переходе по ссылке на самом устройстве, а JSON — отдельный формат для тех, кому нужны параметры, недоступные в коротких ссылках вида vless://. Каждый способ решает свою ситуацию, и разница между ними — не в надёжности, а в удобстве под конкретный случай.

Способы импорта

Что значит «импорт» в Happ

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

Все четыре пути равнозначны для итогового результата: сервер появится в общем «Списке серверов» независимо от того, как он туда попал. Разница — в том, что удобнее в конкретной ситуации: у компьютера под рукой обычно есть буфер обмена, у телевизора — только камера для QR-кода.

Четыре способа технически

СпособЧто нужноКогда удобен
Буфер обменаСкопированная ссылка целикомОсновной способ на телефоне и компьютере — быстрее прочих
QR-кодКамера устройства и изображение кодаТелевизоры, передача между двумя устройствами, если текст набрать неудобно
Диплинк happ://…Переход по ссылке на самом устройстве, где установлен HappКнопка на сайте провайдера или в сообщении открывает Happ напрямую
JSON-конфигурацияФайл или текст в формате Xray-coreПараметры, которых нет в короткой ссылке протокола

Подробный разбор каждого способа — на отдельных страницах: ссылка и буфер обмена, QR-код, happ://crypto, JSON-конфигурация.

Ручной ввод, когда готовой ссылки нет

Если есть только отдельные параметры — адрес, порт, ключ доступа — подойдёт ручной ввод: кнопка «+» в правом верхнем углу главного экрана → «Ручной ввод» → выбор протокола из списка (VLESS, VMess, Socks5, Trojan, Shadowsocks или Hysteria2) → заполнение полей → «Готово». Сервер появится в «Списке серверов» так же, как при импорте ссылкой.

Этот способ медленнее остальных, поэтому его стоит выбирать, только если готовой ссылки, QR-кода или подписки действительно нет.

Что делать, если импорт не сработал

У каждого способа своя точка отказа. Ссылка может быть скопирована с обрывом, буфер обмена — оказаться пустым в момент нажатия «+», а сервер подписки — не ответить за отведённое время. Happ в таких случаях показывает конкретный текст, а не общее «ошибка»:

  • «Буфер обмена пуст» — забыли скопировать данные перед импортом;
  • «Url подписки не валидна» — адрес содержит ошибки или недопустимые символы;
  • «Конфигурация {config type} не валидная» — ссылка сервера повреждена;
  • «Неизвестное действие DeepLink» — диплинк не распознан приложением.

Разбор причин и решений по каждому сообщению — на страницах раздела errors, а если непонятно, что именно пошло не так, — на странице «Не удаётся добавить ключ или подписку в Happ».

Связь с другими разделами

Импорт — техническая сторона добавления; о том, что вообще такое ключ, конфигурация и подписка и где их взять, — раздел «Ключи для Happ». После того как сервер добавлен, выбор конкретного узла по протоколу, локации и пингу — задача раздела «Серверы». Если импортированная ссылка привела к ошибке, а не к рабочему серверу, следующий шаг — раздел errors или общая диагностика в troubleshooting.

Главное

  • Happ поддерживает четыре технических способа добавления: буфер обмена, QR-код, диплинк happ://crypto и JSON-конфигурацию.
  • Ссылку протокола — vless://, vmess://, trojan://, ss://, socks:// или hysteria2:// — можно вставить из буфера обмена, отсканировать QR-кодом или открыть диплинком.
  • Зашифрованная ссылка happ://crypto добавляется так же, как обычная, но скрывает адрес подписки и параметры серверов от пользователя.
  • JSON-конфигурацию Happ передаёт ядру Xray-core без изменений, поэтому часть настроек маршрутизации приложения к ней не применяется.
  • Если импорт не удался, Happ показывает конкретный текст ошибки — «Буфер обмена пуст», «Url подписки не валидна» и другие — с собственным разбором на сайте.

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

Какой способ добавления в Happ проще для новичка?

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

Чем зашифрованная ссылка happ://crypto отличается от обычной по способу добавления?

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

Когда для Happ нужна именно JSON-конфигурация, а не короткая ссылка?

Когда параметры сервера не укладываются в формат ссылки протокола или администратор сервера сразу выдал готовый файл настроек Xray-core. JSON Happ передаёт ядру без изменений, поэтому в нём можно описать то, чего нет в коротких ссылках. За это приходится платить тем, что часть маршрутизации приложения к такому серверу не применяется.

Можно ли добавить сразу несколько серверов одним действием?

Да, если это подписка: один адрес отдаёт список конфигураций целиком, и Happ добавляет их все разом, а затем обновляет при следующем запросе. Ссылка протокола и JSON-конфигурация обычно описывают один сервер за раз, поэтому для нескольких серверов без подписки их добавляют по очереди.

Почему импорт в Happ иногда завершается ошибкой?

Чаще всего ссылка скопирована не полностью, буфер обмена оказался пуст в момент нажатия «+», или сервер подписки не ответил за отведённое время. Приложение показывает конкретный текст: например, «Буфер обмена пуст» или «Url подписки не валидна». У самых частых сообщений есть отдельный разбор причин и решения на этом сайте.

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

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

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

Источники

  1. Документация Happ: добавление конфигурации и подписки — обращение 28 сентября 2026
  2. Документация Happ: ошибки — обращение 28 сентября 2026