Коротко
- Кнопка сервиса открывает Happ и передаёт ему подписку: копировать ничего не нужно.
- Вставка из буфера и QR-код — через «+» в правом верхнем углу главного экрана.
- Happ принимает ссылки
vless://,vmess://,trojan://,ss://,socks://,hysteria2://, ссылки на подписку и зашифрованные подпискиhapp://crypto. - Конфигурацию WireGuard Happ не добавит.
- Обновление подписки загружает свежий список серверов и ничего не оплачивает.
Три способа добавить подписку
1. Кнопка «Добавить в Happ» у сервиса
Сервисы ставят в личном кабинете, на странице подписки или в боте кнопку, которая открывает Happ по специальной ссылке. Happ запускается и добавляет подписку сам. Работает на том устройстве, где нажата кнопка: на телефоне, компьютере или планшете.
Если кнопка открыла браузер, а не Happ, — приложение не установлено на этом устройстве или установлено не то. Поставьте Happ и нажмите кнопку ещё раз.
2. Вставка из буфера обмена
- Скопируйте ссылку на подписку или ключ целиком — от первого до последнего символа.
- Откройте Happ и нажмите «+» в правом верхнем углу главного экрана.
- Выберите вставку из буфера обмена.
На iPhone и iPad система спрашивает разрешение, когда приложение читает буфер обмена. Разрешите вставку — иначе Happ не получит ссылку.
3. QR-код
- Откройте у сервиса QR-код подписки — на экране компьютера или другого телефона.
- В Happ нажмите «+» и выберите сканирование QR-кода.
- Наведите камеру на код.
QR-код удобен, когда подписка открыта на одном устройстве, а добавить её нужно на другое.
Ручной ввод
В том же меню «+» есть «Ручной ввод»: выбираете протокол и заполняете параметры сервера по полям. Этот способ нужен владельцам своих серверов. Сервисы выдают подписку, и вводить параметры по одному не требуется.
Как обновить подписку
Обновление загружает с сервера сервиса свежий список серверов. Нажмите ↻ рядом с названием подписки на главном экране.
Что даёт обновление:
- серверы, которые сервис добавил или заменил, появляются в списке;
- серверы, которые сервис убрал, пропадают;
- обновляются срок и остаток трафика, если сервис их передаёт.
Happ обновляет подписку и сам, по интервалу, который задаёт сервис. Обновление не продлевает и не оплачивает доступ: срок продлевают у сервиса.
Как понять, что подписка добавилась
- На главном экране появилась шапка подписки с её названием, под ней — список серверов.
- Нажмите на иконку спидометра в шапке подписки: Happ проверит задержку до каждого сервера. Рядом с сервером появится время в миллисекундах или значок: зелёная галочка — доступен, красный восклицательный знак — недоступен.
- Выберите сервер и подключитесь. На iPhone при первом подключении iOS попросит разрешить добавить конфигурацию VPN — разрешите.
Если не получилось
Happ не видит данные в буфере
Ошибка «Буфер обмена пуст» означает, что Happ не получил ничего для вставки.
- Скопируйте ссылку ещё раз: на этом же устройстве и целиком.
- На iPhone разрешите вставку, когда система спросит.
- Если ссылка открыта в мессенджере, скопируйте её через меню сообщения, а не выделением части текста.
«Неверная ссылка» или «неверный формат»
Документация Happ называет такие ошибки: «Url подписки не валидна», «Конфигурация … не валидная», «Неизвестный тип контента». Причины:
- ссылка скопирована не целиком или с лишними символами — пробелом, кавычкой, частью соседнего текста;
- скопирована ссылка на страницу с инструкцией, а не на саму подписку;
- это конфигурация WireGuard: файл
.confили текст с[Interface]и[Peer]. Happ WireGuard не поддерживает — нужен сервис на VLESS, VMess, Trojan, Shadowsocks или Hysteria2.
Timeout при добавлении подписки
При добавлении и обновлении Happ запрашивает подписку у сервера сервиса. Если ответа нет 9 секунд, появляется ошибка Timeout. Сервер подписки недоступен из вашей сети или временно не отвечает. Попробуйте другую сеть — Wi-Fi вместо мобильного интернета или наоборот, — затем повторите. Если ошибка остаётся, напишите в поддержку сервиса.
Подписка добавилась, а серверов нет
- Обновите подписку: при первом добавлении список не всегда успевает загрузиться.
- Прочитайте строки в списке серверов. Когда срок закончился или превышен лимит устройств, сервисы присылают вместо серверов строки с объяснением.
- Если строк нет и список пуст после обновления — напишите в поддержку сервиса.
Остальные причины, по которым Happ не подключается, разобраны в статье Happ не подключается.
Подписка добавилась дважды
Повторное добавление создаёт вторую копию подписки с тем же набором серверов. Оставьте одну, вторую удалите. Две одинаковые подписки путают при выборе сервера.
Отличия по платформам
| Платформа | Что отличается |
|---|---|
| iPhone, iPad | Нужна iOS 15 и новее. Система спрашивает разрешение на вставку из буфера и на добавление конфигурации VPN. В российском App Store Happ сейчас нет — как найти настоящий Happ |
| Android | Нужен Android 5.0 и новее. Happ ставится из Google Play (разработчик HappDev) или APK с GitHub разработчика |
| Windows, macOS, Linux | Нужны Windows 10 (сборка 1809 и новее) или 11, macOS 13 и новее. Для старых систем разработчик держит версию 1.0.2 |
| Android TV | При первом запуске Happ показывает QR-код. Отсканируйте его в Happ на телефоне в той же сети Wi-Fi — телефон передаст подписку на телевизор. Если по локальной сети не вышло, выберите Web Import и введите код с экрана на сайте tv.happ.su |
| Apple TV | Отдельное приложение «Happ — Proxy Utility for TV». Подписка передаётся так же: QR-код с телевизора в Happ на телефоне или Web Import. При нехватке памяти tvOS удаляет данные приложения — подписку тогда придётся добавить заново |
На телевизоре экран импорта нельзя закрывать, пока передача не закончится: иначе подписка добавится не целиком.
Как это устроено в MaskNet
Ключ MaskNet зашит в подписку, вставлять ничего не нужно.
- Откройте личный кабинет MaskNet на устройстве, где стоит Happ.
- Нажмите «Добавить подписку» — Happ откроется с уже добавленной подпиской. Кнопка работает одинаково на компьютере и на телефоне.
- Выберите страну и подключитесь.
QR-код рядом с кнопкой нужен для другого устройства: второго телефона, планшета или ноутбука. На телевизор подписку передают с телефона: откройте Happ на телевизоре — он покажет QR-код. Отсканируйте его в Happ на телефоне, где подписка MaskNet уже добавлена. Подписка MaskNet зашифрована: её нельзя открыть, скопировать и переслать.
Частые вопросы
Как вставить ключ в Happ?
Скопируйте ключ целиком, откройте Happ, нажмите «+» в правом верхнем углу и выберите вставку из буфера обмена. Ключ появится в списке серверов.
Как добавить подписку в Happ по QR-коду?
Нажмите «+» на главном экране Happ, выберите сканирование QR-кода и наведите камеру на код подписки.
Как обновить подписку в Happ?
Нажмите ↻ рядом с названием подписки на главном экране. Happ загрузит свежий список серверов. Срок доступа обновление не продлевает.
Почему Happ пишет «Буфер обмена пуст»?
Ссылка не скопирована или скопирована на другом устройстве. На iPhone причина бывает в запрете на вставку: разрешите его, когда система спросит.
Можно ли добавить в Happ конфигурацию WireGuard?
Нет. Happ поддерживает VLESS, VMess, Trojan, Shadowsocks, Socks и Hysteria2. WireGuard и AmneziaWG читает INCY — как добавить подписку туда, разобрано в статье Как добавить подписку в INCY.
Как добавить подписку Happ на телевизор?
Откройте Happ на телевизоре: он покажет QR-код. Отсканируйте его в Happ на телефоне в той же сети Wi-Fi и выберите, что передать. Без общей сети подойдёт Web Import через сайт tv.happ.su.

