«Неизвестное действие DeepLink»
- Автор
- Дмитрий Соколов, ведущий технический автор
- Проверил:
- Артём Волков
- Проверено:
- Опубликовано:
- Версия гайда:
- 1.0
Коротко
«Неизвестное действие DeepLink» значит, что Happ открылся по ссылке happ://, но не знает команду в ней и проигнорировал её. Обновите Happ до последней версии и проверьте, что ссылка скопирована полностью и без изменений.
Диплинк — ссылка, которая открывает Happ и сразу передаёт ему команду: добавить подписку, добавить или включить профиль маршрутизации, выключить маршрутизацию. Если действие в ссылке приложению неизвестно, Happ её игнорирует и показывает это сообщение. Обычно ссылка сделана под более новую версию приложения, повреждена при пересылке или содержит опечатку в названии действия. Конфигурации и профили при этом остаются прежними.
Неизвестное действие DeepLink — «Неизвестное действие DeepLink» — сообщение Happ о том, что приложение открыто по ссылке happ://, но действие в ней этой версии приложения неизвестно. Ссылка игнорируется, конфигурации и профили не меняются.
Что означает ошибка
«Неизвестное действие DeepLink»
Диплинки избавляют от ручной настройки: одно нажатие — и Happ получает подписку или профиль маршрутизации. Но приложение выполняет только те действия, которые знает.
Встретив незнакомую команду, Happ не пытается угадать, что имелось в виду, и не трогает конфигурацию. Это защитное поведение, а не сбой.
Разобраться помогает сама ссылка. Её начало показывает действие, а длинная часть в конце — данные в base64, и этого достаточно, чтобы понять, где ошибка.
Причины
| Причина | Вероятность | Как проверить |
|---|---|---|
| Установлена старая версия Happ, а ссылка использует действие, которое появилось в более новой. | Высокая | Сравните свою версию с последней: 5.9.0 в App Store, 4.4.1 для Android, 4.3.0 для компьютеров (на 27 сентября 2026 года). |
| Опечатка в названии действия: например, route вместо routing или пропущенный слеш. | Средняя | Сравните начало ссылки с документированными вариантами happ://routing/add/, happ://routing/onadd/ и happ://routing/off. |
| Ссылка повреждена при пересылке: мессенджер обрезал её или добавил символы. | Средняя | Скопируйте ссылку в заметки и сравните с оригиналом у отправителя, особенно часть сразу после happ://. |
| Ссылку собрали вручную или сторонним скриптом не по документации Happ. | Низкая | Сверьте ссылку с примерами из документации маршрутизации или соберите тот же профиль в routing.happ.su и сравните. |
Как исправить
Посмотрите действие в ссылке
Скопируйте диплинк в заметки и прочитайте часть сразу после happ://. Для маршрутизации это routing/add, routing/onadd или routing/off.
Результат: Видно, какое действие просит выполнить ссылка.
Обновите Happ
Установите последнюю версию из официального источника: App Store для iPhone, iPad и Mac, Google Play или APK с GitHub для Android, релизы GitHub для Windows, macOS DMG и Linux.
Результат: Номер версии в приложении совпадает с последним релизом.
Откройте ссылку повторно
После обновления нажмите на тот же диплинк ещё раз.
Результат: Happ выполняет действие без сообщения об ошибке.
Запросите ссылку заново
Если ссылка повреждена, попросите отправителя прислать её ещё раз — лучше кнопкой на сайте или QR-кодом.
Результат: Новая ссылка открывается без ошибки.
Пересоздайте ссылку маршрутизации
Если профиль делаете вы сами, соберите его в генераторе routing.happ.su и используйте готовую ссылку happ://routing/add/ или happ://routing/onadd/.
Результат: Профиль появляется среди профилей маршрутизации подписки.
Используйте другой способ добавления
Подписку и конфигурации можно добавить через буфер обмена или QR-код. Профиль маршрутизации провайдер может передать в HTTP-заголовке routing или в теле подписки.
Результат: Данные попадают в Happ без диплинка.
Чек-лист диагностики
- Ссылка начинается с happ:// и скопирована целиком.
- Действие совпадает с документированным вариантом.
- Установлена последняя версия Happ из официального источника.
- Данные после действия декодируются из base64 в читаемый JSON.
- Ссылка получена от своего провайдера или создана вами.
Платформы
Ошибка встречается на платформах: Windows, macOS, Linux, Android, iPhone и iPad.
Главное
- Диплинк Happ начинается с happ:// и содержит действие, которое приложение выполняет при открытии ссылки.
- Документированные действия маршрутизации: happ://routing/add/{base64}, happ://routing/onadd/{base64} и happ://routing/off.
- Неизвестный диплинк Happ игнорирует, поэтому конфигурации и профили не меняются.
- Самая частая причина — ссылка рассчитана на более новую версию Happ, чем установлена.
- Ссылку на профиль маршрутизации можно пересоздать в генераторе routing.happ.su.
Частые вопросы
Что такое диплинк в Happ?
Это ссылка со схемой happ://. Когда вы нажимаете на неё, система открывает Happ и передаёт ему остаток ссылки: название действия, например routing/add, и данные в base64. Провайдеры используют диплинки, чтобы подписку или профиль маршрутизации можно было добавить одним нажатием, без копирования адресов и ручной настройки.
Почему диплинк открывает Happ, но ничего не происходит?
Если действие в ссылке неизвестно, приложение игнорирует её и показывает «Неизвестное действие DeepLink». Если действие знакомо, но данные повреждены, появится другая ошибка, например про неправильные данные профиля маршрутизации. А если Happ не открывается вовсе, система не знает, какой программе отдать ссылку happ://: приложение не установлено или ссылку открыл встроенный браузер мессенджера.
Чем happ://routing/add отличается от happ://routing/onadd?
Действие add добавляет профиль маршрутизации в список, onadd добавляет его и сразу делает активным, а off выключает маршрутизацию. Данные профиля в первых двух ссылках передаются как JSON, закодированный в base64. Изменения маршрутизации применяются при следующем подключении, поэтому после импорта переподключитесь, чтобы новые правила вступили в силу.
Как обновить Happ, чтобы диплинк заработал?
Устанавливайте обновления из официальных источников. На 27 сентября 2026 года актуальны версия 5.9.0 в App Store для iPhone, iPad и Mac, стабильный APK 4.4.1 для Android на GitHub и 4.3.0 для Windows, macOS DMG и Linux на странице релизов GitHub. После обновления нажмите на тот же диплинк ещё раз.
Безопасно ли нажимать диплинки Happ из чатов?
Только если ссылка от вашего провайдера или вы создали её сами. Диплинк может добавить подписку или профиль маршрутизации и сразу его включить, то есть изменить, куда пойдёт трафик. Перед нажатием можно проверить содержимое: декодируйте часть после действия из base64 и посмотрите на JSON профиля — имя, правила и DNS-серверы.
Диплинк в мессенджере не нажимается. Что делать?
Некоторые мессенджеры не превращают ссылки с нестандартной схемой вроде happ:// в кликабельные. Попросите провайдера прислать кнопку на сайте или QR-код с диплинком: камера телефона распознает код и предложит открыть его в Happ. Подписку можно также добавить привычным способом — скопировать её адрес и импортировать через буфер обмена.
Упомянутые темы
Похожие материалы
- Ошибка импорта профиля маршрутизации в Happ
- Неизвестный тип контента в Happ: что не так с данными
- «Буфер обмена пуст» в Happ: почему не видно ключа
- Deeplink-действия happ:// в Happ
- Не удаётся добавить ключ или подписку в Happ
- Настройка Happ на Android TV: подписка с телефона
- Как импортировать профиль маршрутизации
- Импорт по ссылке и из буфера обмена
Разделы по теме
Источники
- Документация Happ: ошибки — обращение 27 сентября 2026
- Документация Happ: маршрутизация — обращение 27 сентября 2026
- Документация Happ: добавление конфигурации и подписки — обращение 27 сентября 2026
- Релизы Happ для Windows, macOS и Linux на GitHub — обращение 27 сентября 2026
- Happ - Proxy Utility в App Store — обращение 27 сентября 2026