Как добавить конфигурацию в Happ: ссылка, QR, happ://crypto
- Автор
- Екатерина Лебедева, редактор раздела knowledge base
- Проверил:
- Артём Волков
- Проверено:
- Опубликовано:
- , обновлено
- Версия гайда:
- 1.0
Коротко
Добавить в Happ конфигурацию или подписку можно четырьмя способами: вставить ссылку из буфера обмена, отсканировать QR-код, открыть зашифрованную ссылку happ://crypto или импортировать JSON-конфигурацию. Способ выбирают по тому, что именно передал провайдер или администратор сервера.
Happ принимает данные тремя путями — ручной ввод по кнопке «+», ссылка протокола и подписка, — а технически они попадают в приложение одним из четырёх способов: через буфер обмена, сканированием QR-кода, диплинком happ://crypto или как JSON-конфигурация, которую ядро Xray-core использует без изменений. Буфер обмена и QR-код подходят почти всегда, диплинк работает при переходе по ссылке на самом устройстве, а JSON — отдельный формат для тех, кому нужны параметры, недоступные в коротких ссылках вида vless://. Каждый способ решает свою ситуацию, и разница между ними — не в надёжности, а в удобстве под конкретный случай.
Способы импорта
- Ссылки happ://crypto: как импортировать зашифрованную подпискуЧтобы импортировать ссылку happ://crypto, добавьте её в Happ через буфер обмена, сканирование QR-кода или диплинк — так…
- Импорт конфигурации в Happ по QR-кодуЧтобы импортировать по QR-коду в Happ, откройте добавление по кнопке «+», выберите сканирование камерой и наведите её…
- Импорт по ссылке и из буфера обменаЧтобы добавить ссылку в Happ, скопируйте её целиком и откройте импорт по кнопке «+» на главном экране — приложение само…
- Импорт JSON-конфигурации в HappЧтобы импортировать JSON-конфигурацию в Happ, скопируйте весь текст файла целиком в буфер обмена и откройте импорт по…
Что значит «импорт» в 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-код остаётся основным способом для телевизоров и передачи между устройствами.
Разделы по теме
Источники
- Документация Happ: добавление конфигурации и подписки — обращение 28 сентября 2026
- Документация Happ: ошибки — обращение 28 сентября 2026