Функционал
HWID — ограничение устройств
Защита подписки от несанкционированного использования на нескольких устройствах по аппаратному идентификатору.
Активация
HWID работает только при запущенном SUBPAGE. Без него устройства не идентифицируются и лимит не применяется.
Шаг 1 — Подготовка: очистка устройств
Перед включением HWID рекомендуется очистить накопленную историю устройств у всех клиентов, чтобы старые записи не блокировали пользователей сразу после активации.
- 1Перейдите в веб-админке → Отчёты → Устройства клиентов
- 2Выполните массовую очистку устройств — удалите все записи HWID по всем пользователям.
Это позволит каждому пользователю заново авторизовать свои устройства уже в рамках нового лимита, без ложных блокировок.
Шаг 2 — Отключение кеширования в SUBPAGE
Кеширование Redis в SUBPAGE может мешать корректной работе HWID — кешированный ответ отдаётся без проверки устройства. Отключите его в файле .env SUBPAGE:
.env (SUBPAGE)
USE_REDIS=false
После изменения перезапустите SUBPAGE:
bash
systemctl restart subpage
Шаг 3 — Включение HWID в веб-админке
- 1Откройте веб-админку → Настройки → Подписка
- 2Найдите переключатель «Лимит устройств по HWID» (
hwid_limit_enabled) и включите его. - 3Сохраните настройки.
После включения пользователи с заполненным лимитом устройств будут получать заглушку вместо подписки при попытке подключиться с нового устройства.
Агрессивный режим — REQUIRE_HWID
Для более жёсткого контроля можно включить параметр REQUIRE_HWID в .env файле SUBPAGE. При этом любой клиент, не передающий заголовок X-HWID, получит заглушку «Приложение не поддерживается» вместо ключей подписки.
.env (SUBPAGE)
# Клиенты без заголовка X-HWID получат заглушку вместо подписки
REQUIRE_HWID=true
Браузеры и запросы на веб-страницу подписки X-HWID не передают — они не затрагиваются этим параметром. Ограничение применяется только к VPN-приложениям, запрашивающим текстовую подписку.
Основной функционал
HWID идентифицирует устройство по аппаратному идентификатору, который передаёт VPN-приложение в заголовке
X-HWID при запросе подписки через SUBPAGE. Каждое новое устройство добавляется в список — пока лимит не исчерпан.Что видит пользователь при превышении лимита
При попытке получить подписку с нового (непривязанного) устройства — SUBPAGE возвращает заглушку с сообщением о превышении лимита устройств.
Пользователь видит в боте кнопку «Мои устройства» — там отображается список привязанных устройств с датой последнего подключения. Лишнее устройство можно удалить самостоятельно.
Управление устройствами пользователем
Через бота
Кнопка «Мои устройства» в главном меню. Клиент видит список устройств и может удалить любое нажатием.
Через Личный кабинет
В разделе управления подпиской на сайте клиент может просмотреть и удалить привязанные устройства.
Управление устройствами администратором
- 1Откройте веб-админку → Пользователи → найдите нужного клиента.
- 2Нажмите «Подробнее» — откроется карточка клиента.
- 3В разделе «Устройства» можно просмотреть все привязанные HWID и удалить любое из них.
Массовую очистку устройств по всем пользователям можно выполнить через Отчёты → Устройства клиентов.