Управление приложением

Параметры для управления поведением приложения через HTTP-заголовки подписки и строки в теле ответа.

Способы передачи

Все параметры можно передавать двумя способами:

1. HTTP-заголовок:

HTTP/2 200
profile-title: Мой VPN
support-url: https://t.me/support

2. Строка в теле подписки (комментарий с #):

#profile-title: Мой VPN
#support-url: https://t.me/support
#profile-update-interval: 6
#announce: Текст объявления
vless://...

Приоритет: HTTP-заголовки имеют приоритет. Строки в теле подписки используются как fallback, когда соответствующий заголовок отсутствует. Это особенно полезно при раздаче подписок через статические файлы (nginx), где нет возможности задать кастомные HTTP-заголовки.

---

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

Имя подписки

Название профиля подписки. Максимум 25 символов. Можно передавать как текст или base64 (UTF-8).

Заголовок:

profile-title: Мой VPN

В теле подписки:

#profile-title: Мой VPN

Base64 с описанием (первая строка — имя, остальные — описание):

profile-title: base64:0JzQvtC5IFZQTgrQlNC+0LHRgNC+INC/0L7QttCw0LvQvtCy0LDRgtGM

Альтернативные заголовки (fallback, если profile-title отсутствует):

• subscription-name — альтернативное имя подписки

• content-disposition — имя файла из заголовка (расширения .txt, .yaml, .yml удаляются автоматически)

Описание подписки

Отдельный заголовок для описания, если оно не включено в profile-title:

profile-description: Быстрые серверы в Европе

Поддерживает base64: profile-description: base64:...

Интервал обновления подписки

Интервал автоматического обновления подписки в часах. Значение должно быть кратно одному часу.

Заголовок:

profile-update-interval: 6

В теле подписки:

#profile-update-interval: 6

Статус подписки

Информация о балансе, объёме использованного трафика и сроке действия подписки. Поля разделяются точкой с запятой.

subscription-userinfo: upload=0;download=1073741824;total=10737418240;expire=1700000000

Поле	Описание
upload	Исходящий трафик (байт)
download	Входящий трафик (байт)
total	Лимит трафика (байт)
expire	Дата истечения (Unix timestamp, секунды)

Если expire > 32 000 000 000 — значение интерпретируется как миллисекунды и конвертируется в секунды.

Ссылка на поддержку

Кнопка перехода на страницу поддержки. Если ссылка ведёт в Telegram — отображается иконка Telegram.

Заголовок:

support-url: https://t.me/your_support_bot

В теле подписки:

#support-url: https://t.me/your_support_bot

Ссылка на сайт

Кнопка перехода на сайт подписки.

Заголовок:

profile-web-page-url: https://your-site.com

В теле подписки:

#profile-web-page-url: https://your-site.com

Альтернативный заголовок: homepage

Объявление

Текстовое объявление (до 200 символов). Можно передавать как текст или base64.

Заголовок:

announce: Плановое обслуживание 15 марта с 03:00 до 05:00 MSK

Base64:

announce: base64:0J/Qu9Cw0L3QvtCy0L7QtSDQvtCx0YHQu9GD0LbQuNCy0LDQvdC40LU=

URL объявления (ссылка, не текст):

announce-url: https://example.com/news

В теле подписки:

#announce: Плановое обслуживание 15 марта
#announce-url: https://example.com/news
vless://uuid@server:443#Server

---

Сводная таблица параметров

Заголовок	Альтернативы	Формат	Body (#)	Описание
profile-title	subscription-name, content-disposition	текст / base64:...	✅	Имя подписки
profile-description	—	текст / base64:...	—	Описание подписки
profile-update-interval	—	число (часы)	✅	Интервал обновления
subscription-userinfo	—	key=value;...	—	Статистика трафика
support-url	—	URL	✅	Ссылка на поддержку
profile-web-page-url	homepage	URL	✅	Ссылка на сайт
announce	—	текст / base64:...	✅	Текст объявления
announce-url	—	URL	✅	Ссылка на объявление
autorouting	—	URL	✅	Автообновляемый профиль маршрутизации
routing	—	base64 / ссылка	✅	Статический профиль маршрутизации
premium-url	—	URL	—	Ссылка «Премиум» (в карточке подписки, см. ниже)
per-app-proxy-enable	—	1 / 0	—	Включить per-app режим (только Android)
per-app-proxy-mode	—	bypass / proxy	—	Режим per-app
per-app-proxy-list	—	CSV / URL	—	Список package names
fragmentation-enable	—	1 / 0	—	TCP-фрагментация
fragmentation-length	—	min-max	—	Диапазон длины фрагмента
fragmentation-interval	—	min-max	—	Диапазон задержки между фрагментами
fragmentation-packets	—	tlshello / 1-3 / all	—	На какие пакеты применять
noises-enable	—	1 / 0	—	Отправка шумовых пакетов до handshake
noises-type	—	rand / str / hex	—	Тип шумового контента
noises-packet	—	строка	—	Payload шума (формат зависит от type)
noises-delay	—	min-max мс	—	Диапазон задержки между шумами
server-address-resolve-enable	—	1 / 0	—	Предварительный DNS-резолв адреса сервера через DoH
server-address-resolve-dns-domain	—	URL	—	URL DoH-сервера
server-address-resolve-dns-ip	—	IP	—	IP DoH-сервера (bootstrap)

Все заголовки регистронезависимы (profile-title = Profile-Title).

Параметры из тела подписки (body) используются как fallback — HTTP-заголовки всегда имеют приоритет.

Все заголовки со значениями поддерживают префикс base64: для передачи UTF-8 данных без проблем с Latin-1 / non-ASCII (применяется к announce, profile-title, profile-description, per-app-proxy-list).

---

Маршрутизация

Профиль маршрутизации

Статический профиль в base64. Подробнее — routing.md.

routing: ://routing/onadd/ewog...base64...

Автообновляемый профиль маршрутизации

URL-источник профиля маршрутизации с периодическим обновлением. Подробнее — autorouting.md.

autorouting: https://raw.githubusercontent.com/user/repo/main/profile.json

Приоритет источников маршрутизации

Если профиль маршрутизации указан в нескольких местах, используется первый найденный по приоритету:

Приоритет	Источник
1 (высший)	Заголовок autorouting
2	Body — строка с URL (://autorouting/onadd/, ://autorouting/add/)
3	Заголовок routing
4 (низший)	Body — строка с base64 (://routing/onadd/, ://routing/add/, ://routing/)

Важно: только ://autorouting/ устанавливает sourceURL и включает автообновление. Строки ://routing/onadd/{url} в теле подписки импортируют профиль одноразово, без привязки к источнику.

---

Описание сервера

Дополнительная подпись, отображаемая под именем сервера (максимум 30 символов). Добавляется после title через разделитель ?:

vless://uuid@server:443#Сервер1?serverDescription=base64-text

---

Per-app proxy (только Android)

Android VpnService позволяет пропускать через VPN только выбранные приложения либо наоборот — исключать их из туннеля. Провайдер может форсировать этот режим через три заголовка:

per-app-proxy-enable: 1
per-app-proxy-mode: bypass
per-app-proxy-list: com.android.chrome,org.telegram.messenger

Параметры

Заголовок	Значение	Описание
per-app-proxy-enable	1 / 0	Включить режим per-app
per-app-proxy-mode	bypass | proxy	bypass — указанные приложения обходят VPN. proxy — только они идут через VPN
per-app-proxy-list	CSV или URL	Список package names через запятую, перенос строки, или URL до текстового файла

Формат списка

Inline (CSV или строчный):

per-app-proxy-list: com.android.chrome,org.telegram.messenger,com.google.android.youtube

Base64 (для длинных списков):

per-app-proxy-list: base64:Y29tLmFuZHJvaWQuY2hyb21lCm9yZy50ZWxlZ3JhbS5tZXNzZW5nZXI=

Удалённый URL:

per-app-proxy-list: https://example.com/myapps.txt

Файл по URL — обычный plain text с package names по одному на строку или через запятую. Клиент скачивает его при применении подписки и при каждом обновлении.

Поведение

• Если ни одно из трёх полей не задано — настройки пользователя в приложении не переопределяются.

• Если per-app-proxy-enable задан в 0 — per-app режим выключается, даже если пользователь его включил локально.

• Платформы кроме Android игнорируют эти заголовки.

---

TCP-фрагментация

Перезаписывает глобальные настройки фрагментации пользователя для данной подписки.

fragmentation-enable: 1
fragmentation-packets: tlshello
fragmentation-length: 10-30
fragmentation-interval: 10-30

Заголовок	Значение	Описание
fragmentation-enable	1 / 0	Включить фрагментацию
fragmentation-packets	tlshello | 1-3 | 1 | all	На какие TCP-пакеты применять фрагментацию
fragmentation-length	min-max	Диапазон длины фрагмента в байтах
fragmentation-interval	min-max	Диапазон задержки между фрагментами в мс

Те же параметры доступны через Premium API как fragmentEnabled / fragmentPackets / fragmentLength / fragmentInterval — при Premium-подписке HTTP-заголовки игнорируются в пользу API-значений.

---

Шумовые пакеты (noises)

Отправка случайных UDP-пакетов перед VPN-handshake'ом для маскировки. Актуально в первую очередь для WireGuard и Hysteria2 в сетях с глубокой инспекцией трафика.

noises-enable: 1
noises-type: rand
noises-packet: 10-20
noises-delay: 10-50

Заголовок	Значение	Описание
noises-enable	1 / 0	Включить шумы
noises-type	rand | str | hex	Формат payload'а
noises-packet	строка	Содержимое шумового пакета; для rand — диапазон длины min-max
noises-delay	min-max мс	Диапазон задержки между шумовыми пакетами

---

Резолв адреса сервера через DoH

Bootstrap-резолв домена сервера через DNS-over-HTTPS до установки туннеля. Полезно когда провайдерский DNS подменяет адрес VPN-сервера.

server-address-resolve-enable: 1
server-address-resolve-dns-domain: https://common.dot.dns.yandex.net/dns-query
server-address-resolve-dns-ip: 77.88.8.8

Заголовок	Значение	Описание
server-address-resolve-enable	1 / 0	Включить DoH-резолв
server-address-resolve-dns-domain	URL	DoH endpoint (обычно /dns-query)
server-address-resolve-dns-ip	IP	IP DoH-сервера для bootstrap'а — используется до резолва его домена

Те же поля передаются через Premium API как serverAddressResolveEnable / serverAddressResolveDnsDomain / serverAddressResolveDnsIp.

---

Ссылка «Премиум»

Дополнительная кнопка в карточке подписки — ведёт на страницу покупки или личный кабинет провайдера.

premium-url: https://example.com/pricing

Заголовок	Значение	Описание
premium-url	URL	URL кнопки «Премиум» в карточке подписки

Если не задан — кнопка скрыта.

---

Настройки, которые подписка не может задать HTTP-заголовками

Эти параметры хранятся в Premium API конфигурации провайдера и применяются клиентом только если домен подписки принадлежит Premium-провайдеру. Включить их «через подписку без аккаунта в панели» нельзя — это by design.

Группа	Что настраивается	Ссылка
Lite Mode	Упрощённый интерфейс, ссылки на бот/канал/поддержку + пресет-иконки	premium-api.md § Lite Mode
Баннер подписки	Текст + цвета + кнопка в карточке подписки	premium-api.md § Баннер подписки
Кастомная тема	Плоские цвета и градиенты для аккаунта / фона	premium-api.md § Кастомная тема
Force-настройки	forceConnectionStyle: классическая круглая кнопка vs compact-toggle	premium-api.md § Принудительные настройки
Ping и сортировка	defaultPingProtocol, defaultSortOrder, pingOnUpdate	premium-api.md § Ping и сортировка
Domain fronting	resolveAddress / hostHeader (связка SNI ↔ Host для маскировки)	premium-api.md § Domain fronting и фрагментация
Админ-доступ по HWID	adminHwids + auto-approve пушей	admin-hwids.md
Push-уведомления	Модерация, таргетинг, отмена	provider-notifications.md

Фрагментация, шумы и DoH-резолв доступны через оба канала: HTTP-заголовками подписки (см. выше) или через Premium API. При Premium-подписке API-значения приоритетнее заголовков.