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

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

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

**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-значения приоритетнее заголовков.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://incy.gitbook.io/docs/dokumentaciya-dlya-razrabotchikov/upravlenie-prilozheniem.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.