Лимит устройств HWID
Эта функция работает только с некоторыми клиентскими приложениями (которые в настоящее время поддерживают отправку заголовка HWID при получении содержимого подписки).
Лимит устройств HWID полностью опционален и отключён по умолчанию.
Обзор
Лимит устройств HWID — это функция, позволяющая ограничить количество устройств, которые могут использовать подписку.
Если лимит устройств HWID включён, Remnawave будет использовать HWID и другие заголовки для ограничения количества устройств, которые могут использовать подписку.
Remnawave будет строго соблюдать лимит на количество устройств, которые могут добавить подписку.
Если лимит устройств HWID включён и вы не отключите лимит HWID для пользователя в панели, получить подписку будет невозможно, если клиентское приложение не отправляет заголовок HWID.
Remnawave вернёт ошибку 404, если заголовок HWID не отправлен.
Настройка
Вы можете настроить лимит устройств HWID в разделе Подписка → Настройки → Лимит устройств HWID. Также можно переопределить настройки для каждой внешней группы.
Пользовательские лимиты
Вы можете установить индивидуальный лимит для каждого пользователя. Если значение не указано, будет использоваться резервный лимит (HWID_FALLBACK_DEVICE_LIMIT).
Также есть возможность отключить лимит устройств HWID для каждого пользователя.
В карточке пользователя вы можете видеть список устройств, на которых пользователь добавил подписку. Вы можете удалять устройства из списка. Также доступен поиск устройств по HWID.
Поддерживаемые приложения
Не все клиентские приложения отправляют заголовок HWID. Вот список приложений, которые в настоящее время поддерживают эту функцию.
- Happ
- v2RayTun
- Форки от сообщества Remnawave:
- Koala Clash (форк Clash Verge Rev)
- FlClashX (форк FlClash)
- Prizrak-Box (форк Pandora-Box)
- Throne - HWID отключён по умолчанию
- Shadowrocket - HWID отключён по умолчанию
- Passwall-OpenWRT
- Clash Mi - HWID отключён по умолчанию
- Karing - HWID отключён по умолчанию
- Incy
- DeskBox
Для разработчиков приложений
Стандарт предоставления заголовков предлагается Happ.
Remnawave использует эти заголовки для идентификации HWID и устройства.
Для включения поддержки функции HWID в вашем клиенте приложение должно отправлять следующие заголовки при добавлении пользователем подписки.
x-hwid: vfjdhk66csdjhk
x-device-os: iOS
x-ver-os: 18.3
x-device-model: Iphone 14 Pro Max
user-agent: <user_agent>
Единственный обязательный элемент — x-hwid. Остальные заголовки опциональны и могут использоваться для более точной идентификации устройства.
Если ваше приложение имеет возможность включать дополнительные функции в зависимости от источника подписки, Remnawave может отправить идентификатор провайдера в заголовках ответа, с помощью которого можно определить источник подписки.
Заголовки HWID, отправляемые Remnawave
Доступно начиная с Remnawave Panel v2.7.5.
Когда лимит устройств HWID включён, Remnawave включает следующие заголовки в ответы на подписки:
| Заголовок | Описание |
|---|---|
x-hwid-active | Всегда true, когда лимит устройств HWID включён на стороне панели. |
x-hwid-not-supported | true, если лимит устройств HWID включён, но клиентское приложение не отправило заголовок x-hwid. |
x-hwid-max-devices-reached | true, если лимит устройств HWID включён и пользователь достиг максимального количества разрешённых устройств. |
x-hwid-limit | true, когда лимит устройств достигнут. Отправляется для обратной совместимости с v2RayTun. |
Эти заголовки позволяют клиентским приложениям предоставлять пользователям содержательную обратную связь — например, отображать предупреждение при достижении лимита устройств или при отсутствии поддержки HWID.