Подписка (subscription URL): что это
- Автор
- Екатерина Лебедева, редактор раздела knowledge base
- Проверил:
- Артём Волков
- Проверено:
- Опубликовано:
- , обновлено
- Версия гайда:
- 1.0
Коротко
Подписка в Happ (subscription URL) — адрес, по которому приложение регулярно запрашивает список серверов и служебные параметры: название, трафик, срок действия. В отличие от ссылки на один сервер, подписка обновляется и может содержать сразу несколько конфигураций.
Подписка — это не отдельный протокол, а способ получать конфигурации серверов с одного адреса вместо ручного добавления каждой ссылки. По этому адресу сервер провайдера отдаёт список конфигураций текстом или JSON-массивом, а также, если провайдер настроил, служебные параметры: имя подписки, объём трафика, срок действия, интервал автообновления. Happ хранит адрес подписки и время от времени обращается к нему заново, заменяя список серверов свежим. Адрес подписки бывает открытым или зашифрованным ссылкой happ://crypto — от этого зависит, видит ли пользователь его в приложении.
Подписка — адрес, по которому Happ получает список конфигураций серверов и, опционально, служебные параметры вроде названия, трафика и срока действия. В отличие от ссылки на отдельный сервер подписка хранится в приложении как источник данных и обновляется заново по расписанию или вручную.
Суть термина
Подписка (subscription URL) — адрес, к которому Happ обращается за списком серверов вместо того, чтобы хранить каждую ссылку по отдельности. По этому адресу сервер провайдера отдаёт список конфигураций и, если провайдер настроил, служебные данные подписки.
От отдельной ссылки на сервер подписку отличает то, что она не статична: приложение периодически обращается к тому же адресу заново и заменяет список серверов актуальным. Провайдер может добавлять и убирать серверы, менять ключи доступа — пользователю для этого не нужно ничего переустанавливать вручную, достаточно обновить подписку.
Подписка бывает открытой — обычным веб-адресом — или зашифрованной ссылкой happ://crypto, где настоящий адрес скрыт от пользователя приложения.
Как это выглядит в Happ
Добавляется подписка так же, как отдельная ссылка: через буфер обмена, сканированием QR-кода или диплинком. Happ распознаёт, что переданный адрес — подписка, а не одна конфигурация, и создаёт для неё отдельный блок в списке серверов.
Внешне блок подписки — это шапка с названием и, если провайдер их передал, значками действий и строкой трафика с датой окончания, а под ней — список серверов. Обновить весь набор можно одной командой у самой подписки, не трогая серверы, добавленные вручную.
Параметры вроде интервала автообновления, имени подписки и строки с трафиком провайдер передаёт вместе с ответом сервера подписки — они разобраны на отдельных страницах, потому что у каждого свой формат и ограничения.
Пример: как выглядит ответ сервера подписки
Сервер подписки может передать служебные параметры в заголовках ответа, а список конфигураций — в теле:
HTTP/2 200
profile-title: Example
profile-update-interval: 6
subscription-userinfo: upload=0; download=0; total=0; expire=1790951622
vless://00000000-0000-0000-0000-000000000000@example.com:443?type=tcp&security=reality#Example-1
vmess://eyJhZGQiOiJleGFtcGxlLmNvbSJ9Тот же результат можно получить, передав параметры прямо в теле ответа строками с # перед списком конфигураций — оба способа поддерживаются одновременно, провайдер выбирает удобный для своей панели управления.
Чем отличается от похожих терминов
| Термин | Что это |
|---|---|
| Подписка | адрес с несколькими конфигурациями серверов, обновляется заново |
| Ключ доступа | ссылка на один сервер вида vless://, vmess:// и другие — статична, подписки не образует |
| Зашифрованная подписка | тот же адрес подписки, но скрытый от пользователя ссылкой happ://crypto |
| Конфигурация | набор параметров для подключения к одному серверу — то, из чего состоит список внутри подписки |
Проще говоря, конфигурация описывает один сервер, ключ доступа — это конфигурация в виде ссылки, а подписка — адрес, который отдаёт сразу много таких конфигураций и умеет обновлять список.
Главное
- Подписка — это адрес с несколькими конфигурациями серверов и служебными параметрами, а не ссылка на один сервер.
- Список серверов провайдер отдаёт в виде обычного текста со ссылками вида vless:// или как JSON-массив с настройками.
- Служебные параметры подписки — название, трафик, срок действия, интервал автообновления — передаются в HTTP-заголовках ответа или строками с # в начале тела подписки.
- Если сервер подписки не отвечает 9 секунд по умолчанию, Happ показывает ошибку тайм-аута; провайдер с Provider ID может увеличить этот срок до 15 секунд.
- Адрес подписки бывает открытым, зашифрованным ссылкой happ://crypto или со скрытыми настройками серверов — в каждом случае Happ показывает пользователю разный объём деталей.
Частые вопросы
Чем подписка в Happ отличается от отдельной ссылки на сервер, например vless://?
Ссылка вида vless:// или vmess:// описывает один сервер и добавляется один раз: изменить её содержимое можно только заменив ссылку целиком. Подписка — это адрес, за которым может стоять сразу много таких ссылок, и Happ обращается к нему заново при обновлении, получая актуальный список. Поэтому провайдеры используют подписку, когда серверов несколько или их состав меняется.
В каком формате провайдер отдаёт список серверов по адресу подписки?
Два варианта. Стандартный — текстовый список ссылок вида vless://, vmess://, trojan:// и других поддерживаемых протоколов, обычно в кодировке base64. Второй — JSON-массив с готовыми конфигурациями для ядра Xray; Happ передаёт такие конфигурации в ядро без изменений, поэтому маршрутизация приложения на них не влияет, а меняются только выбор гео-файлов и удалённый DNS.
Как провайдер передаёт название и трафик подписки, если список серверов — это просто текст?
Двумя способами: в HTTP-заголовках ответа сервера подписки или строками, начинающимися со знака #, в начале тела ответа перед списком серверов. Так передаются, например, название подписки, строка с трафиком и сроком действия, ссылка на страницу поддержки. Happ читает эти параметры при каждом обновлении и обновляет то, что показывает пользователю.
Что произойдёт, если сервер подписки долго не отвечает при добавлении или обновлении?
Happ ждёт ответа 9 секунд по умолчанию, а если провайдер указал в подписке Provider ID, этот срок можно настроить в диапазоне от 5 до 15 секунд. Когда время выходит, приложение показывает ошибку тайм-аута, а список серверов не меняется — подробнее об этой ошибке и способах проверки читайте на странице разбора тайм-аута подписки.
Чем маршрутизация в JSON-подписке отличается от обычной текстовой?
В обычной подписке правила маршрутизации задаёт профиль, который можно менять в приложении или получать отдельно от провайдера. В JSON-подписке конфигурация уже содержит собственные правила для ядра Xray, и Happ передаёт её как есть: собственный профиль маршрутизации к такой подписке не применяется, максимум один профиль можно использовать только для выбора гео-файлов и DNS.
Как понять, что моя подписка зашифрована или её настройки скрыты от меня?
Посмотрите на исходную ссылку, которой добавляли подписку: если она начинается с happ://crypto, адрес зашифрован. Отдельный признак — недоступность просмотра, редактирования и пересылки конфигураций серверов: так бывает и у зашифрованных подписок, и у обычных, где провайдер отдельно скрыл эти настройки.
Упомянутые темы
Похожие материалы
Разделы по теме
Источники
- Документация Happ: добавление конфигурации и подписки — обращение 28 сентября 2026
- Документация Happ: управление приложением через подписку — обращение 28 сентября 2026
- Документация Happ: примеры ссылок и параметры — обращение 28 сентября 2026
- Документация Happ: ошибки — обращение 28 сентября 2026