Deeplink happ://: что это

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

Коротко

Диплинк — ссылка, по которой операционная система открывает не браузер, а сразу приложение Happ и передаёт ему данные: адрес подписки, конфигурацию сервера или профиль маршрутизации. У Happ есть собственная схема happ://, а также поддержка протокольных ссылок вроде vless:// и vmess:// тем же способом.

Диплинк (deeplink) — общий механизм, которым операционная система связывает префикс ссылки с конкретным установленным приложением вместо браузера. Happ регистрирует несколько таких префиксов: happ://crypto для зашифрованной подписки, happ://routing/add и happ://routing/onadd для профилей маршрутизации, happ://routing/off для их отключения. Кроме собственной схемы, Happ понимает диплинки с префиксами поддерживаемых протоколов — vless://, vmess://, trojan://, ss://, socks://, hysteria2:// и hy2://, а также обычные ссылки на подписку. Если система не может сопоставить диплинк ни одному действию, Happ показывает ошибку и ссылку игнорирует.

Диплинк happ:// — ссылка, по префиксу которой операционная система открывает приложение Happ и передаёт ему данные напрямую, минуя браузер. Помимо собственной схемы happ:// приложение так же обрабатывает диплинки протоколов вроде vless:// и обычные адреса подписки.

Суть термина

Диплинк — ссылка, у которой вместо привычного https:// стоит префикс, зарегистрированный конкретным приложением. Когда система видит такой префикс, она открывает не браузер, а приложение, которое умеет его обрабатывать, — в данном случае Happ.

У Happ есть собственная схема happ://, под которой скрывается несколько разных действий: добавление зашифрованной подписки через happ://crypto, добавление и включение профиля маршрутизации через happ://routing/add и happ://routing/onadd, отключение маршрутизации через happ://routing/off.

Кроме собственной схемы, Happ регистрирует и префиксы поддерживаемых протоколов: vless://, vmess://, trojan://, ss://, socks://, hysteria2:// и hy2://. Ссылка на обычную подписку тоже открывается через тот же механизм, даже если начинается с обычного https://.

Как это выглядит в Happ

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

Диплинк — один из трёх способов добавить подписку или отдельный сервер в Happ, наравне с буфером обмена и QR-кодом. Провайдеры, у которых есть Provider ID или которые используют лимитированные и HWID-ссылки, обычно раздают их пользователю именно диплинком — это быстрее, чем просить скопировать текст вручную.

Если ссылка повреждена или содержит действие, которое текущая версия Happ не поддерживает, приложение покажет сообщение «Неизвестное действие DeepLink» и не добавит ничего — разбор этой ошибки и способов проверки ссылки вынесен на отдельную страницу.

Пример: диплинк профиля маршрутизации

Профиль маршрутизации превращается в диплинк так: JSON-описание правил кодируется в base64 и подставляется после префикса.

Текст

happ://routing/onadd/eyJOYW1lIjoiRXhhbXBsZSIsIkdsb2JhbFByb3h5IjoidHJ1ZSJ9

При переходе по такой ссылке Happ раскодирует base64 обратно в JSON, добавит профиль в список профилей маршрутизации и сразу сделает его активным — этим и отличается routing/onadd от routing/add, который только добавляет профиль, не включая его.

Чем отличается от похожих терминов

Термин	Что это
Диплинк	способ доставки ссылки — открытие приложения напрямую вместо браузера
happ://crypto	конкретная схема диплинка для зашифрованной подписки
Ключ доступа	сама ссылка на сервер (vless://, vmess:// и другие), которую можно передать диплинком, QR-кодом или буфером обмена
QR-код	другой способ доставки той же ссылки, без перехода по диплинку

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

Главное

Диплинк открывает сразу приложение Happ вместо браузера — операционная система сама решает это по префиксу ссылки.
Схема happ:// используется для нескольких действий: happ://crypto для зашифрованной подписки, happ://routing/add, happ://routing/onadd и happ://routing/off для профилей маршрутизации.
Ссылки протоколов vless://, vmess://, trojan://, ss://, socks://, hysteria2:// и hy2://, а также обычные адреса подписки Happ тоже открывает как диплинки.
Профиль маршрутизации в диплинке передаётся в виде JSON, закодированного в base64, — того же формата, что и при передаче через HTTP-заголовок routing.
Если приложение не узнаёт действие диплинка, оно показывает ошибку «Неизвестное действие DeepLink» и ничего не добавляет.

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

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

Обычная ссылка вида https:// операционная система открывает в браузере. Диплинк использует другой префикс, например happ:// или vless://, и система сопоставляет его с приложением, которое зарегистрировало этот префикс при установке — в данном случае с Happ. Приложение получает содержимое ссылки напрямую и сразу выполняет нужное действие: добавляет подписку, сервер или профиль маршрутизации.

Какие действия можно вызвать диплинками схемы happ:// в Happ?

Три вида: happ://crypto добавляет зашифрованную подписку, happ://routing/add и happ://routing/onadd добавляют профиль маршрутизации — второй ещё и сразу активирует его, а happ://routing/off отключает функцию маршрутизации целиком. Все, кроме отключения, несут в себе данные в виде base64 после префикса.

Работают ли ссылки vless:// или vmess:// как диплинки так же, как happ://?

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

Что означает ошибка «Неизвестное действие DeepLink» в Happ?

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

Как провайдеру передать пользователю диплинк для быстрого добавления подписки?

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

Можно ли передать профиль маршрутизации не диплинком, а другим способом?

Да, тот же JSON-профиль в base64 можно передать HTTP-заголовком routing в ответе сервера подписки или строкой в её теле — тогда профиль применится при следующем обновлении подписки без отдельного диплинка. Диплинк удобен, когда профиль нужно передать разово и вне контекста подписки, например ссылкой из чата поддержки.

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

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

Источники

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