Документация · Провайдерам

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

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

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

Параметры этой страницы работают только у подтверждённой подписки: в ней ваш ID, а её домен подтверждён в вашем кабинете. Параметры для любой подписки — на странице «Заголовки подписки».

Пример

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». Пользователь видит пояснение «так требует провайдер» и может только удалить подписку

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

Эти же ключи можно прислать командой «Поменять настройки» (см. «Уведомления и команды»).

Параметр	Значение	Что меняет	Где
`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`	пользователь вправе видеть, что работает на его компьютере; адрес подписки скрывают ограниченные ссылки
`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», режим подключения, диагностику и аккаунт.

Эта страница в Markdown · Все страницы есть в Markdown: допишите .md к адресу без косой черты в конце. Список — в llms.txt, всё сразу — в llms-full.txt.