Поддерживаемые заголовки

При загрузке удалённой подписки Prizrak-Box считывает определённые HTTP-заголовки ответа от сервера. Эти заголовки позволяют провайдерам подписок управлять метаданными профиля, отображением трафика, автоматическим обновлением, логотипом, объявлениями и другим.

Заголовки нечувствительны к регистру. Неизвестные заголовки игнорируются без ошибок.

Встроенные заголовки

Если сервер не может устанавливать HTTP-заголовки ответа (например, статический хостинг), можно встроить заголовки в виде комментариев в начале содержимого подписки:

#profile-title: Моя VPN
#subscription-userinfo: upload=1073741824; download=5368709120; total=107374182400; expire=1893456000

Встроенные комментарии используют те же имена, что и HTTP-заголовки, с префиксом #. Они работают как запасной вариант — HTTP-заголовки ответа всегда имеют приоритет над встроенными.

Заметка

Заголовки с иконкой управляются самой панелью Remnawave автоматически. Добавлять их вручную через Правила ответов или настройки заголовков подписки не нужно — Remnawave отправляет их сам.

---

Метаданные профиля

Profile-Title

Отображаемое имя подписки в Prizrak-Box.

Свойство	Значение
Тип	string
Кодировка	UTF-8 или Base64 (префикс base64:)

Пример:

Profile-Title: Моя VPN подписка
Profile-Title: base64:TW9yIFZQTiDQv9C+0LTQv9C40YHQutCw

Если Profile-Title отсутствует, приложение использует имя файла из заголовка Content-Disposition, затем генерирует имя вида Sub-2024-01-01.

Profile-Logo

URL изображения для логотипа подписки в приложении.

Свойство	Значение
Тип	string (URL)
Поддерживаемые форматы	PNG, SVG
Максимальный размер	2 МБ
Разрешённые схемы	http, https

Пример:

Profile-Logo: https://example.com/logo.png

Логотип загружается при получении подписки и кешируется локально. Пустой или недействительный URL удаляет кешированный логотип.

Content-Disposition

Используется как запасной источник названия профиля, если Profile-Title отсутствует.

Свойство	Значение
Тип	string
Разбираемое поле	параметр filename

Пример:

Content-Disposition: attachment; filename="my-vpn.yaml"

Значение filename (без расширения) становится названием профиля, если Profile-Title не задан.

---

Информация о трафике

Subscription-Userinfo

Статистика использования трафика, отображаемая в карточке профиля.

Свойство	Значение
Тип	string (пары ключ=значение через точку с запятой)
Поля	upload, download, total, expire
Единицы	Байты (для трафика), Unix timestamp (для expire)

Пример:

Subscription-Userinfo: upload=1073741824; download=5368709120; total=107374182400; expire=1893456000

Поле	Описание
upload	Байт выгружено
download	Байт загружено
total	Общая квота трафика в байтах
expire	Время истечения как Unix timestamp

---

Настройки обновления

Profile-Update-Interval

Задаёт интервал автоматического обновления подписки.

Свойство	Значение
Тип	integer
Единица	Часы

Пример:

Profile-Update-Interval: 24

При наличии этого заголовка Prizrak-Box автоматически обновляет подписку с заданным интервалом в часах.

---

Ссылки

Profile-Web-Page-Url

URL главной страницы или портала провайдера подписки.

Свойство	Значение
Тип	string (URL)

Пример:

Profile-Web-Page-Url: https://myvpn.example.com

Отображается в деталях профиля как кликабельная ссылка.

Support-Url

URL службы поддержки или контактов (например, Telegram-канал, служба помощи).

Свойство	Значение
Тип	string (URL)

Пример:

Support-Url: https://t.me/myvpn_support

Отображается рядом с профилем для обращения в поддержку.

---

Объявления

Announce

Текстовое объявление, отображаемое в приложении как баннер на карточке профиля.

Свойство	Значение
Тип	string
Максимальная длина	200 символов
Кодировка	UTF-8 или Base64 (префикс base64:)

Примеры:

Announce: Техническое обслуживание в субботу 02:00–04:00 UTC
Announce: base64:0KLQtdGF0L3QuNGH0LXRgdC60L7QtSDQvtCx0YHQu9GD0LbQuNCy0LDQvdC40LU=

Announce-Url

URL, на который ссылается баннер объявления.

Свойство	Значение
Тип	string (URL)

Пример:

Announce-Url: https://status.myvpn.example.com

Нажатие на баннер объявления в приложении открывает этот URL.

---

Миграция URL и резервные адреса

Эти заголовки реализуют миграцию URL подписки — провайдеры могут перенести подписку на новый адрес без ручного обновления URL пользователями.

new-url

Указывает клиенту заменить весь URL подписки на новый.

Свойство	Значение
Тип	string (полный URL)
Приоритет	Наивысший — имеет приоритет над new-domain
Переходы	Максимум 3 последовательные миграции

Пример:

new-url: https://new.example.com/subscription/abc123

После получения этого заголовка Prizrak-Box немедленно сохраняет новый URL и выполняет повторную загрузку с него. Исходный URL навсегда заменяется в профиле.

new-domain

Указывает клиенту заменить только хост URL подписки, сохраняя путь и строку запроса.

Свойство	Значение
Тип	string (только хост, без схемы и пути)
Пример значения	new.example.com или new.example.com:8443

Пример:

new-domain: cdn.example.com

Если текущий URL подписки — https://old.example.com/sub/abc, результат будет https://cdn.example.com/sub/abc.

fallback-url

Альтернативный полный URL для использования, если основной URL подписки недоступен (не-2xx или ошибка соединения).

Свойство	Значение
Тип	string (полный URL)
Сохранение	Да — записывается в профиль для будущих запросов

Пример:

fallback-url: https://backup.example.com/subscription/abc123

Prizrak-Box сначала пробует основной URL. При неудаче переключается на fallback-url. Значение резервного адреса обновляется (или очищается) при каждом успешном запросе.

fallback-domain

Альтернативный домен для подстановки в основной URL при его недоступности.

Свойство	Значение
Тип	string (только хост)
Сохранение	Да — записывается в профиль

Пример:

fallback-domain: backup.example.com

Если основной URL — https://main.example.com/sub, этот резерв пробует https://backup.example.com/sub.

Порядок приоритетов резервирования

Порядок перебора: основной URL → fallback-url → основной URL с fallback-domain. Используется первый ответ со статусом 2xx.

---

Управление интерфейсом Android Только Android

Следующие заголовки поддерживаются исключительно Android-версией Prizrak-Box. Они позволяют провайдерам подписок управлять отдельными элементами пользовательского интерфейса Android-клиента.

Все значения применяются при получении подписки и сохраняются в профиле до следующего обновления.

pxa-latency-dots

Управляет отображением задержки прокси в списке.

Свойство	Значение
Тип	integer
Значения	0 = числа задержки, 1 = точки задержки

Пример:

pxa-latency-dots: 1

Совместимость с Happ

Для совместимости с провайдерами, которые ранее использовали приложение Happ, также поддерживаются следующие псевдонимы:

• ping-result: time → эквивалент pxa-latency-dots: 0
• ping-result: icon → эквивалент pxa-latency-dots: 1

Если присутствуют оба заголовка, pxa-latency-dots имеет приоритет над ping-result.

pxa-simple-mode

Включает упрощённый режим интерфейса — на главном экране приложения только первую select прокси группу вашей конфигурации mihomo.

Свойство	Значение
Тип	integer
Значения	1 для включения

Пример:

pxa-simple-mode: 1

pxa-global-mode-mp

Показывает пункт меню Глобальный режим в левом нижнем углу карточки текущего профиля при запущенном подключении VPN.

Свойство	Значение
Тип	integer
Значения	1 для отображения

Пример:

pxa-global-mode-mp: 1

pxa-conns-view-mp

Показывает пункт меню Подключения в левом нижнем углу карточки текущего профиля при запущенном подключении VPN.

Свойство	Значение
Тип	integer
Значения	1 для отображения

Пример:

pxa-conns-view-mp: 1

pxa-rp-mp

Показывает пункт меню Rules Provider (RP) в левом нижнем углу карточки текущего профиля при запущенном подключении VPN.

Свойство	Значение
Тип	integer
Значения	1 для отображения

Пример:

pxa-rp-mp: 1

---

HWID-аутентификация

Prizrak-Box поддерживает формат заголовков HWID Device Limit от RemnaWave. При использовании аппаратной аутентификации устройств задействованы две группы заголовков: заголовки, отправляемые клиентом с каждым запросом, и заголовки, возвращаемые сервером в ответе.

Заголовки запроса (отправляет Prizrak-Box)

Когда в профиле активен HWID, Prizrak-Box автоматически добавляет следующие заголовки к каждому запросу подписки:

Заголовок	Описание
X-Hwid	Аппаратный отпечаток — уникальный идентификатор устройства
X-Device-OS	Название операционной системы (например, Windows, Android, macOS)
X-Ver-OS	Версия ОС (например, 14, 11, 14.5)
X-Device-Model	Модель устройства (например, Pixel 8, iPhone 14 Pro Max)

Заголовки ответа (возвращает сервер)

Сервер возвращает следующие заголовки для передачи статуса HWID. Prizrak-Box читает и обрабатывает каждый из них.

X-Hwid-Active

Всегда true, когда HWID Device Limit включён на стороне сервера. Prizrak-Box использует этот заголовок для пометки профиля как HWID-защищённого в интерфейсе.

Свойство	Значение
Тип	string (булево)
Значения	true

X-Hwid-Active: true

X-Hwid-Not-Supported

true, если HWID Device Limit включён на сервере, но клиент не отправил заголовок X-Hwid. Сигнализирует приложению, что устройство не идентифицировано и подписка может быть ограничена.

Свойство	Значение
Тип	string (булево)
Значения	true

X-Hwid-Not-Supported: true

X-Hwid-Max-Devices-Reached

true, если HWID Device Limit включён и пользователь достиг максимального числа разрешённых устройств. Приложение может показать предупреждение о том, что добавить новые устройства невозможно.

Свойство	Значение
Тип	string (булево)
Значения	true

X-Hwid-Max-Devices-Reached: true

Совместимость с RemnaWave

Формат HWID-заголовков соответствует спецификации HWID Device Limit RemnaWave. Серверы подписок, реализующие формат RemnaWave, полностью совместимы с Prizrak-Box.

---

Шаблоны (PXD) Устарело

Устарело — будет удалено

Механизм заголовков Pxd-Template / Pxd-Template-Scheme устарел и будет удалён из Prizrak-Box в одном из следующих релизов.

Как работал устаревший метод можно ознакомиться здесь: How to use xhttp from Remnawave in Prizrak-Box