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

Заголовки подписки

Что FlowLock читает из ответа любой подписки — имя, трафик и срок, поддержка, объявление, интервал обновления — и что сам отправляет панели.

Эти параметры FlowLock читает у любой подписки, ID провайдера для них не нужен. Имена — общепринятые (Remnawave, Marzban, 3x-ui и другие панели шлют их и так), поэтому обычно ничего настраивать не надо.

Параметры приходят заголовком ответа подписки. Для подписок-ссылок и base64 их можно положить и строкой в теле #имя: значение в первых 50 строках; заголовок важнее строки с тем же именем. Текст можно закодировать как base64:… (так делает Remnawave с rwEncodeBase64:).

Что читается

Параметр	Что делает
`profile-title`	имя подписки (текст или `base64:`)
`subscription-userinfo`	трафик и срок: `upload=…; download=…; total=…; expire=<unix>`
`support-url`	кнопка «Поддержка»
`profile-web-page-url`	кнопка «Страница подписки»
`announce`	объявление «От провайдера» (до 200 символов, текст или `base64:`)
`profile-update-interval`	как часто обновлять подписку, в часах
`routing`	правила маршрутизации подписки — см. «Маршрутизация»
`routing-enable`	`0` — не применять правила маршрутизации подписки (свои правила пользователя не трогаются)
`flowlock-theme`	тема оформления, если пользователь согласился — см. «Темы»
`flowlock-provider`	ваш ID провайдера — см. «ID в подписке»

Пример ответа:

HTTP/1.1 200 OK
profile-title: base64:0JzQvtC5IFZQTg==
subscription-userinfo: upload=0; download=1073741824; total=107374182400; expire=1798761600
profile-update-interval: 12
support-url: https://t.me/myvpn_support
announce: Новый сервер в Нидерландах уже в списке

total=0 или без total — трафик без лимита («безлимит»), expire=0 или без expire — бессрочно.

Расширенные параметры (инфоблок, «Продлить», переезд на новый домен, настройки приложения) работают только у подтверждённой подписки — они на странице «Управление приложением».

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

FlowLock понимает base64 и список ссылок (vless://, vmess://, trojan://, ss://, hysteria2:///hy2:// и другие), Xray JSON и sing-box JSON. В JSON-подписках правила маршрутизации берутся из самого JSON (routing у Xray, route у sing-box).

Что FlowLock отправляет панели

User-Agent — свой, вида FlowLock/1.2.0 (macOS; arm64); подробности и совместимость — на странице «User-Agent».
HWID-заголовки для лимита устройств (как у Remnawave): x-hwid, x-device-os, x-ver-os, x-device-model — пока у пользователя включено «Отправлять HWID». Подписка может потребовать HWID всегда (subscription-always-hwid-enable, нужен ID).

Подписки FlowLock загружает напрямую, мимо VPN: многие панели не отвечают на адреса VPN-серверов.

Кнопка «Добавить в FlowLock»

На странице подписки можно поставить ссылку, которая добавит подписку в приложение:

flowlock://add/https://sub.example.com/abc123
https://flowlock.cc/add/#url=https%3A%2F%2Fsub.example.com%2Fabc123&name=Мой%20VPN

Первая откроет приложение (оно спросит подтверждение), вторая — сайт, который добавит подписку в аккаунт FlowLock пользователя. Остальные команды — на странице «Ссылки flowlock://».

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