Управление настройками Happ через подписку

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

Коротко

Управление приложением — набор параметров, которые провайдер передаёт вместе с подпиской Happ через HTTP-заголовки или строки с # в её теле. Стандартные параметры работает у любого провайдера, а расширенные — только при переданном в подписке Provider ID.

Happ поддерживает управление настройками приложения на уровне отдельной подписки: провайдер задаёт значения параметров в ответе сервера подписки, а приложение применяет их к серверам и интерфейсу этой конкретной подписки. Часть параметров — например, интервал автообновления или имя подписки — доступна всем провайдерам без дополнительных условий. Другая часть, от смены адреса подписки до автоподключения при запуске, требует, чтобы провайдер передал в этой же подписке свой Provider ID. Активируют параметр значением true или 1, а отключают любым другим непустым значением.

Как устроено управление через подписку

Подписка в Happ — это не только список серверов. Вместе с ним провайдер может передать десятки параметров, которые меняют поведение приложения именно для этой подписки: от простого имени до автоматического подключения при запуске.

Технически это работает через HTTP-заголовки ответа сервера подписки или строки с # в начале её тела — например:

Текст

profile-title: Мой тариф
profile-update-interval: 12

Включают параметр значением true или 1, отключают — любым другим непустым значением, например 0. Разработчики Happ делят все параметры на две категории по одному признаку: нужен ли для них Provider ID.

Стандартные параметры

Стандартные параметры работают у любого провайдера без дополнительных условий. Вот основные из них:

Параметр	Что делает	Пример значения
`profile-update-interval`	интервал автообновления подписки в часах	`12`
`profile-title`	имя подписки, текст или base64, до 25 символов	`Мой тариф`
`subscription-userinfo`	трафик (upload, download, total) и срок действия expire	`upload=0; download=2000000; total=0; expire=1798761600`
`support-url`	ссылка на поддержку, значок рядом с подпиской	`https://t.me/example_support`
`announce`	текст объявления, до 200 символов	`base64:...`
`tun-type`	ядро туннеля на компьютере: sing-box, tun2proxy, default, xray	`xray`
`mux-enable`	мультиплексирование нескольких TCP-соединений в одно	`1`

Полные описания параметров profile-update-interval, profile-title и subscription-userinfo — на страницах глоссария, а порядок ручного и автоматического обновления подписки — в статье как обновить подписку в Happ.

Расширенные параметры и Provider ID

Расширенные параметры работают только вместе с Provider ID в той же подписке. Без него Happ эти значения просто не применяет — ни ошибки, ни предупреждения не будет, параметр останется без эффекта.

Параметр	Что делает	Пример значения
`new-url` / `new-domain`	меняет адрес или домен подписки у всех пользователей	`https://example.com/new-path`
`fallback-url`	запасной адрес при ошибке 300–599 или отсутствии ответа за 9 секунд	`https://backup.example.com/sub`
`sub-expire`	баннер об окончании подписки за 3 дня и после	`1`
`notification-subs-expire`	системные уведомления об окончании раз в день за 3 дня	`1`
`subscription-autoconnect`	автоподключение к серверу при запуске приложения	`1`
`hide-settings`	скрывает конфигурации серверов от просмотра и редактирования	`1`
`subscription-request-timeout`	таймаут запроса подписки, 5–15 секунд, по умолчанию 9	`10`

Категории параметров

Список параметров управления удобнее держать в голове по группам, а не как один длинный перечень:

Отображение подписки — имя, объявление, ссылки поддержки и сайта, баннер об окончании.
Сеть и туннель — выбор TUN-режима, Mux, MTU туннеля Xray, исключения маршрутов, системный прокси или прокси для отдельных приложений на Android.
Пинг — способ измерения, отображение результата и автоматическая проверка при запуске; подробный разбор — в статье как Happ измеряет пинг.
Поведение при запуске — автоподключение, автопинг, обновление подписок при открытии приложения.
Сеть подписки — таймаут запроса, User-Agent, запасной и новый адрес подписки.

Особенности по платформам

Не все параметры работают одинаково на всех платформах. Часть привязана к конкретной операционной системе:

Параметр	Платформа
`per-app-proxy-mode`, `app-auto-start`	только Android
`custom-tunnel-config`, `proxy-enable` / `tun-enable`, `tun-mode`	только компьютеры (Windows, macOS, Linux)
темы оформления, отдельные сетевые настройки	только iOS
`xray-tun-enable`, `xray-tun-mtu`	Android и iOS

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

Главное

Параметры управления передаются HTTP-заголовками ответа сервера подписки или строками с # в начале её тела.
Стандартные параметры вроде интервала автообновления и имени подписки работают у любого провайдера без условий.
Расширенные параметры — от смены адреса подписки до автоподключения при запуске — требуют Provider ID в этой же подписке.
Значение true или 1 включает параметр, любое другое непустое значение — отключает.
С версии Happ для компьютеров 4.3.0 у каждой подписки появилась собственная страница настроек вместо общих на всё приложение.

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

Чем стандартные параметры отличаются от расширенных?

Стандартные параметры — например, интервал автообновления profile-update-interval или имя подписки profile-title — работают у любого провайдера сразу, без дополнительных условий. Расширенные параметры Happ применяет только при одном условии: в этой же подписке должен быть передан Provider ID провайдера. Без него приложение такие параметры игнорирует, даже если они присутствуют в ответе сервера.

Как провайдер передаёт параметр в подписку технически?

Два способа, оба описаны в документации Happ. Первый — HTTP-заголовок в ответе сервера подписки, например profile-update-interval: 12. Второй — строка в самом теле подписки перед списком конфигураций, начинающаяся со знака #, например #profile-title: Название. Оба способа Happ обрабатывает одинаково — выбор обычно зависит от того, что удобнее настроить в конкретной панели управления сервером.

Что покажет Happ, если провайдер передаст subscription-userinfo?

Приложение покажет строку состояния подписки: слева — сумму использованного трафика upload и download, справа после символа / — общий лимит total, а также дату окончания из значения expire в формате unix-времени. Все части этого параметра передаются в одном заголовке и разделяются точкой с запятой, отдельного заголовка на каждую часть не предусмотрено.

Можно ли ограничить приложение так, чтобы пользователь не видел адрес сервера?

Да, параметр hide-settings отключает просмотр и редактирование конфигураций серверов для подписки, к которой он применён — как для уже добавленных серверов, так и для тех, что появятся позже. Это расширенный параметр, поэтому он сработает только вместе с Provider ID в той же подписке. Похожий, но более радикальный эффект даёт полностью зашифрованная подписка, где скрыт и сам адрес.

Управляются ли настройки TUN и системного прокси через подписку?

Да, на компьютерах провайдер может параметрами proxy-enable и tun-enable задать, что включится при добавлении или обновлении подписки — но использовать нужно только один из них одновременно. Отдельный параметр tun-mode выбирает между системным сетевым стеком и пользовательским gVisor, а tun-type — между несколькими реализациями туннеля, включая собственную реализацию Happ TUN.

Почему у каждой подписки в Happ для компьютеров теперь своя страница настроек?

С версии 4.3.0 Happ для Windows, macOS и Linux получил отдельную страницу настроек у каждой подписки, начиная с собственного User-Agent. В пререлизе 4.4.6 туда же перенесли автообновление и его интервал, уведомления, пинг и подключение при запуске, таймаут запроса, сортировку и фильтр серверов. Раньше эти настройки были общими сразу для всех подписок в приложении.

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

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

Wiki

Источники

Документация Happ: управление приложением через подписку — обращение 28 сентября 2026
Документация Happ: Provider ID — обращение 28 сентября 2026
Релизы Happ для Windows, macOS и Linux на GitHub — обращение 28 сентября 2026