跳到主要内容

HWID 设备限制

信息

此功能仅适用于少数客户端应用程序(目前支持在接收订阅内容时发送 HWID 标头)。

提示

HWID 设备限制完全可选,默认禁用

概述

HWID 设备限制是一项功能,允许您限制可以使用订阅的设备数量。

如果启用了 HWID 设备限制,Remnawave 将使用 HWID 和其他标头来限制可以使用订阅的设备数量。

Remnawave 将严格执行可以添加订阅的设备数量限制。

危险

如果启用了 HWID 设备限制,并且您没有在面板中为用户禁用 HWID 限制,如果其客户端应用程序不发送 HWID 标头,则该用户将无法获取订阅。

如果未发送 HWID 标头,Remnawave 将返回 404 错误。

配置

您可以在订阅 → 设置 → HWID 设备限制中配置 HWID 设备限制。还可以为每个外部小组覆盖设置。

用户限制

您可以为每个用户设置自定义限制。如果未指定值,将使用后备限制(HWID_FALLBACK_DEVICE_LIMIT)。

还有一个选项可以为每个用户禁用 HWID 设备限制。

HWID User Limits

在用户卡中,您可以看到用户已添加订阅的设备列表。您可以从列表中删除设备。也可以通过 HWID 搜索设备。

HWID Device Limit Settings

支持的应用程序

信息

并非所有客户端应用程序都会发送 HWID 标头。以下是目前支持此功能的应用程序列表。

面向应用程序开发者

信息

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 可以在响应标头中发送提供商 ID,您可以用它来确定订阅来自哪里。

Remnawave 发送的 HWID 标头

信息

自 Remnawave Panel v2.7.5 起可用。

当启用 HWID 设备限制时,Remnawave 在订阅响应中包含以下标头:

标头描述
x-hwid-active当面板端启用 HWID 设备限制时始终为 true
x-hwid-not-supported如果启用了 HWID 设备限制但客户端应用程序未发送 x-hwid 标头,则为 true
x-hwid-max-devices-reached如果启用了 HWID 设备限制且用户已达到允许设备的最大数量,则为 true
x-hwid-limit当达到设备限制时为 true。为向后兼容 v2RayTun 而发送。

这些标头允许客户端应用程序向用户提供有意义的反馈 — 例如,当达到设备限制或缺少 HWID 支持时显示警告。