Документация Happ — протоколы, форматы, API

VLESS

Основной протокол Happ — VLESS на ядре Xray. Легковесный, без лишнего оверхеда, с минимальными задержками. Аутентификация по UUID, поддержка flow xtls-rprx-vision.

Reality

Reality маскирует соединение под обычный визит на крупный сайт — сеть видит легитимный TLS-хендшейк к реальному домену, а не туннель. Параметры: pbk (public key), sid (short id), sni (server name), fp (fingerprint). Активное зондирование получает настоящий ответ прикрывающего домена.

xHTTP

xHTTP — транспорт, упаковывающий соединение под обычные HTTP-запросы (GET/POST). Проходит там, где остальные транспорты режутся. Режимы packet-up / stream-up; параметр uplinkHTTPMethod для совместимости с CDN. Наши узлы xHTTP в подписке помечены как «Защищённый».

Транспорты в двух словах

• tcp — базовый, самый быстрый
• ws (WebSocket) — универсальный, как веб-подключение
• grpc — как обычный веб-API (Gmail/YouTube)
• xhttp — самый незаметный, под обычный HTTP

VLESS URI

Разовый ключ — строка вида:

Один URI = один сервер. Импортируется в Happ через «+» → «Вставить из буфера».

Поддерживаемые схемы

• vless:// — VLESS (в т.ч. Reality)
• vmess:// — VMess (base64-JSON)
• trojan:// — Trojan
• ss:// — Shadowsocks

Happ понимает все схемы; наш стек использует VLESS Reality как основной.

Что отдаёт сервер подписки

По ссылке https://…/sub/<id> сервер возвращает список серверов. Формат зависит от User-Agent клиента: Happ получает base64-список vless://, Clash/Mihomo — YAML, sing-box — JSON. Обновление — свайп вниз в приложении (клиент повторно запрашивает URL).

Заголовки подписки

Сервер может передавать profile-update-interval (частота автообновления в часах), subscription-userinfo (лимит/остаток трафика, срок) и announce (сообщение в клиенте). Happ читает эти заголовки и показывает срок и остаток.

Раздельный роутинг

Клиенты Clash/Mihomo/sing-box получают правила: российские домены и IP (GEOSITE,category-ru, GEOIP,RU, TLD .ru/.su/.рф) идут напрямую (DIRECT), остальное — через выбранный сервер. Это ускоряет РФ-сайты и снимает гео-конфликты банков.

Авто-выбор (url-test)

Группа url-test периодически пингует gstatic.com/generate_204 и выбирает быстрейший узел. Интервал ~5 минут, порог переключения — 50 мс (против флаппинга). В base64-формате авто-выбор реализован встроенным ping-sort Happ.

Схема deep-link

Happ поддерживает импорт через deep-link: happ://add/<base64-url> открывает приложение и добавляет подписку. Удобно для кнопок «Добавить в Happ» на веб-странице.

Получение ключа программно

Ключ выдаётся после оплаты и приходит на email. Для партнёрской интеграции (выдача ключей в своём боте/сервисе) — напишите в поддержку, дадим доступ к API выдачи и продления.

Нужна помощь с интеграцией?

Собираешь свой клиент, бота выдачи ключей или настраиваешь маршрутизацию под нестандартный кейс — возьми ключ для тестов и напиши в поддержку. Помогаем с форматами конфигов, отладкой хендшейка Reality и подбором транспорта под конкретную сеть.