Limite de dispositivos HWID
Esta funcionalidade funciona apenas com alguns aplicativos cliente (que atualmente suportam enviar um cabeçalho HWID ao receber o conteúdo da assinatura).
Limite de Dispositivos HWID é completamente opcional e desabilitado por padrão.
Visão geral
Limite de Dispositivos HWID é uma funcionalidade que permite restringir o número de dispositivos que podem usar uma assinatura.
Se o Limite de Dispositivos HWID estiver habilitado, o Remnawave usará HWID e outros cabeçalhos para limitar o número de dispositivos que podem usar uma assinatura.
O Remnawave vai aplicar rigorosamente o limite no número de dispositivos que podem adicionar a assinatura.
Se o Limite de Dispositivos HWID estiver habilitado e você não desabilitar o limite de HWID para um usuário no painel, será impossível para eles obter uma assinatura se o aplicativo cliente não enviar um cabeçalho HWID.
O Remnawave retornará um erro 404 se nenhum cabeçalho HWID for enviado.
Configuração
Você pode configurar o Limite de Dispositivos HWID em Assinatura → Configurações → Limite de Dispositivos HWID. Também é possível substituir as configurações para cada Esquadrão Externo.
Limites de usuário
Você tem a opção de definir um limite personalizado para cada usuário. Se nenhum valor for especificado, o limite de fallback (HWID_FALLBACK_DEVICE_LIMIT) será usado.
Há também uma opção para desabilitar o Limite de Dispositivos HWID para cada usuário.

No cartão do usuário, você pode ver a lista de dispositivos em que o usuário adicionou a assinatura. Você tem a opção de excluir dispositivos da lista. A pesquisa de dispositivos por HWID também está disponível.

Aplicativos suportados
Nem todos os aplicativos cliente enviam um cabeçalho HWID. Aqui está a lista de aplicativos que atualmente suportam esta funcionalidade.
- Happ
- v2RayTun
- Forks da comunidade Remnawave:
- Koala Clash (fork do Clash Verge Rev)
- FlClashX (fork do FlClash)
- Prizrak-Box (fork do Pandora-Box)
- Throne - HWID desabilitado por padrão
- Shadowrocket - HWID desabilitado por padrão
- Passwall-OpenWRT
- Clash Mi - HWID desabilitado por padrão
- Karing - HWID desabilitado por padrão
- Incy
- DeskBox
Para desenvolvedores de aplicativos
Um padrão para fornecer cabeçalhos é oferecido pelo Happ.
O Remnawave usa esses cabeçalhos para identificar o HWID e o dispositivo.
Para habilitar o suporte à funcionalidade HWID no seu cliente, o aplicativo deve enviar os seguintes cabeçalhos quando o usuário estiver adicionando a assinatura.
x-hwid: vfjdhk66csdjhk
x-device-os: iOS
x-ver-os: 18.3
x-device-model: Iphone 14 Pro Max
user-agent: <user_agent>
O único item obrigatório é x-hwid. Outros cabeçalhos são opcionais e podem ser usados para identificar o dispositivo com mais precisão.
Se seu aplicativo tiver a capacidade de habilitar funcionalidades adicionais com base na origem da assinatura, o Remnawave pode enviar um ID de provedor nos cabeçalhos de resposta, que você pode usar para descobrir de onde vem a assinatura.
Cabeçalhos HWID enviados pelo Remnawave
Disponível desde o Remnawave Panel v2.7.5.
Quando o Limite de Dispositivos HWID está habilitado, o Remnawave inclui os seguintes cabeçalhos nas respostas de assinatura:
| Cabeçalho | Descrição |
|---|---|
x-hwid-active | Sempre true quando o Limite de Dispositivos HWID está habilitado no lado do painel. |
x-hwid-not-supported | true se o Limite de Dispositivos HWID estiver habilitado, mas o aplicativo cliente não enviou um cabeçalho x-hwid. |
x-hwid-max-devices-reached | true se o Limite de Dispositivos HWID estiver habilitado e o usuário tiver atingido o número máximo de dispositivos permitidos. |
x-hwid-limit | true quando o limite de dispositivos foi atingido. Enviado para compatibilidade retroativa com o v2RayTun. |
Esses cabeçalhos permitem que os aplicativos cliente forneçam feedback significativo aos usuários — por exemplo, exibindo um aviso quando o limite de dispositivos foi atingido ou quando o suporte HWID está ausente.