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

> Параметры подписки, которыми провайдер управляет FlowLock — инфоблок, продление, переезд, запасной адрес и настройки приложения; что FlowLock не читает и почему.

Параметры приходят **заголовком ответа подписки** или **строкой в теле** `#имя: значение` (заголовок важнее строки
с тем же именем). Имена — как у Happ: если ваша панель уже шлёт их для Happ, FlowLock поймёт их без настройки.
Текст можно закодировать как `base64:…`. Логические значения: `true` или `1` — да, `false` или `0` — нет.

Параметры этой страницы работают **только у подтверждённой подписки**: в ней ваш [ID](https://flowlock.cc/docs/provider-id.md), а её
домен [подтверждён](https://flowlock.cc/docs/domains.md) в вашем кабинете. Параметры для любой подписки — на странице
[«Заголовки подписки»](https://flowlock.cc/docs/headers.md).

## Пример

```
HTTP/1.1 200 OK
profile-title: base64:0JzQvtC5IFZQTg==
subscription-userinfo: upload=0; download=1073741824; total=107374182400; expire=1798761600
support-url: https://t.me/myvpn_support
flowlock-provider: k7m2x9q4bd
sub-info-color: blue
sub-info-text: Новый сервер в Нидерландах уже в списке
sub-info-button-text: Подробнее
sub-info-button-link: https://myvpn.example/news
sub-expire: 1
sub-expire-button-link: https://t.me/myvpn_bot?start=renew
fallback-url: https://sub2.example.com/abc123
ping-type: tcp
```

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

| Параметр                          | Значение                              | Что делает                                                                                                                                                                      |
| --------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `new-url`                         | ссылка                                | навсегда меняет адрес подписки у всех. Новый адрес — только на вашем подтверждённом домене; если с него подписка не загрузилась, приложение вернёт старый                       |
| `new-domain`                      | домен                                 | меняет только домен (путь и токен остаются). Тоже только ваш подтверждённый домен                                                                                               |
| `fallback-url`                    | ссылка                                | запасной адрес на вашем подтверждённом домене: основной не ответил за 9 с, ошибка сети или HTTP 300–599 — приложение пробует запасной                                           |
| `serverDescription`               | до 30 символов                        | подпись под именем сервера: в ссылке сервера `vless://…#Германия?serverDescription=0JHRi9GB0YLRgNGL0Lk=` (base64) или `meta.serverDescription` в JSON-подписке                  |
| `sub-info-text`                   | до 200 символов, `0` — убрать         | инфоблок в карточке подписки                                                                                                                                                    |
| `sub-info-color`                  | `blue` (по умолчанию), `green`, `red` | цвет инфоблока                                                                                                                                                                  |
| `sub-info-button-text`            | до 25 символов                        | кнопка в инфоблоке (без неё кнопки нет)                                                                                                                                         |
| `sub-info-button-link`            | `https://…` или `tg://…`              | куда ведёт кнопка                                                                                                                                                               |
| `sub-expire`                      | `1`                                   | баннер «Подписка закончится через N дн.» за 3 дня до `expire` и «Подписка закончилась» после                                                                                    |
| `sub-expire-button-link`          | `https://…` или `tg://…`              | кнопка «Продлить» в этом баннере                                                                                                                                                |
| `notification-subs-expire`        | `1`                                   | системное уведомление за 3 дня, за 1 день и в день окончания                                                                                                                    |
| `subscription-always-hwid-enable` | `1`                                   | этой подписке HWID отправляется всегда, даже если пользователь выключил «Отправлять HWID». Пользователь видит пояснение «так требует провайдер» и может только удалить подписку |

## Настройки приложения

Эти же ключи можно прислать командой «Поменять настройки» (см. [«Уведомления и команды»](https://flowlock.cc/docs/messages.md)).

| Параметр                               | Значение                             | Что меняет                            | Где   |
| -------------------------------------- | ------------------------------------ | ------------------------------------- | ----- |
| `subscription-autoconnect`             | `1` / `0`                            | подключаться при запуске приложения   | все   |
| `subscription-ping-onopen-enabled`     | `1` / `0`                            | пинговать серверы при запуске         | все   |
| `subscription-auto-update-enable`      | `1` / `0`                            | автообновление **этой** подписки      | все   |
| `subscription-auto-update-open-enable` | `1` / `0`                            | обновлять подписки при запуске        | все   |
| `ping-type`                            | `proxy`, `proxy-head`, `tcp`, `icmp` | способ пинга (`proxy-head` = `proxy`) | все   |
| `check-url-via-proxy`                  | `https://…`                          | адрес проверки для пинга через прокси | все   |
| `proxy-ping-timeout`                   | секунды, 1–10 (больше — 10)          | таймаут пинга                         | все   |
| `change-user-agent`                    | строка до 256                        | User-Agent загрузки **этой** подписки | все   |
| `fragmentation-enable`                 | `1` / `0`                            | фрагментация TLS ClientHello          | все   |
| `fragmentation-packets`                | `tlshello` или `1-3`                 | какие пакеты дробить                  | macOS |
| `fragmentation-length`                 | `50-100`                             | длина кусков                          | macOS |
| `fragmentation-interval`               | `10-20`                              | пауза между кусками, мс               | macOS |
| `subscriptions-sort-type`              | `without`, `ping`, `alphabet`        | порядок серверов                      | все   |
| `subscription-always-hwid-enable`      | `1` / `0`                            | см. выше                              | все   |
| `notification-subs-expire`             | `1` / `0`                            | см. выше                              | все   |

### Как это видит пользователь

Рядом с настройкой — «Задано провайдером «Мой VPN»» и кнопка «Вернуть моё». Если пользователь вернул своё, тот же
заголовок его больше не перебивает; новое значение — перебивает. Удалил подписку — настройки, заданные вами,
возвращаются к его прежним.

## Что FlowLock не читает

| Параметр                                                                                                                                                                                                        | Почему                                                                                                                          |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `custom-tunnel-config`, `socks-auth-*`, `http-auth-*`, `dns-from-json-enable`                                                                                                                                   | открывают локальный прокси наружу, меняют DNS или конфигурацию ядра целиком — ломают защиту пользователя                        |
| `proxy-enable`, `tun-enable`, `tun-mode`, `tun-type`                                                                                                                                                            | режим подключения выбирает пользователь (TUN требует прав администратора)                                                       |
| `exclude-routes`, `exclude-routes-set`, `per-app-proxy-*`                                                                                                                                                       | пускают трафик мимо VPN                                                                                                         |
| `hide-settings`                                                                                                                                                                                                 | пользователь вправе видеть, что работает на его компьютере; адрес подписки скрывают [ограниченные ссылки](https://flowlock.cc/docs/install-links.md) |
| `server-address-resolve-*`, `subscription-request-timeout`, `subscription-autoconnect-type`, `proxy-ping-mode`, `ping-result`, `manual-block-user-agent`                                                        | нет такой настройки в FlowLock или это выбор пользователя                                                                       |
| `noises-*`, `mux-*`, `sniffing-enable`, `fragmentation-maxsplit`, `no-limit-*`, `user-agent-geo-files`                                                                                                          | параметры другого ядра (Xray) или режимов Happ                                                                                  |
| `color-profile`, `hide-vpn-icon`, `subscriptions-collapse`, `subscriptions-expand-now`, `subscription-pin`, `dont-use-filter`, `app-auto-start`, `xray-tun-*`, `include-all-networks-enable` и другие мобильные | только iOS/Android или не имеют смысла на компьютере; темы у FlowLock свои (`flowlock-theme`)                                   |
| `providerid`                                                                                                                                                                                                    | ID Happ; у FlowLock свой — `flowlock-provider`                                                                                  |

Ни заголовком, ни командой провайдер не меняет: правила маршрутизации пользователя и «всё напрямую», DNS, порты и
пароли локального прокси, «Разрешить подключения из сети», общий переключатель «Отправлять HWID», режим
подключения, диагностику и аккаунт.
