HWID デバイス制限
この機能は、サブスクリプションコンテンツを受信する際に HWID ヘッダーの送信をサポートする一部のクライアントアプリケーションでのみ機能します。
HWID デバイス制限は完全にオプションで、デフォルトでは無効です。
概要
HWID デバイス制限は、サブスクリプションを使用できるデバイスの数を制限できる機能です。
HWID デバイス制限が有効になっている場合、Remnawave は HWID およびその他のヘッダーを使用して、サブスクリプションを使用できるデバイスの数を制限します。
Remnawave は、サブスクリプションを追加できるデバイスの数の制限を厳格に適用します。
HWID デバイス制限が有効になっていて、パネルでユーザーの HWID 制限を無効にしない場合、クライアントアプリケーションが HWID ヘッダーを送信しないと、サブスクリプションを取得することが不可能になります。
HWID ヘッダーが送信されない場合、Remnawave は 404 エラーを返します。
設定
サブスクリプション → 設定 → 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 はレスポンスヘッダーにプロバイダー 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 サポートがない場合に警告を表示します。