HidoHido 服务商接入
接入指南 · 最后更新：2026 年 11 月 8 日
Hido 可直接配合原版 V2Board、Xboard 和 XiaoV2Board 面板使用。本页面向希望用 Hido 设备码（HWID）限制设备数量，或运行修改版面板的服务商。
1. 申请服务商代码
发送邮件至 [email protected]，并附上：
- 服务名称和你想要的代码（小写字母和数字，例如
abcvpn）。 - 面板的 API 地址，以及某个域名被封锁时用户可用的备用地址。
- 订阅域名（如果与面板不同）。
- 购买链接和客服渠道，会显示在应用的 账户 → 详情 中。
- 修改版面板请说明下表中的选项。
你可以随时更换域名。告诉我们后，已安装的用户会自动跟随，无需更新应用或重新登录。
| 选项 | 适用情况 | 默认 |
|---|---|---|
api_path | 你的 API 不在 /api/v1 下，例如 /api/v3。Hido 会在登录、账户以及收到的订阅链接中使用这个路径。 | /api/v1 |
payload = header | 面板所有请求都用 GET，JSON 请求体以 base64url 编码放在 X-Payload 请求头中。 | POST，JSON 请求体 |
hido_client | 你希望在 API 请求中识别 Hido：应用会在每个请求（包括登录）中发送 Hido 的 User-Agent、X-Device 和设备请求头。 | 关闭 |
2. Hido 会发送什么
每次下载订阅时
这些请求头始终发送，名称与 Happ 和 Remnawave 相同，因此已为这些应用限制设备的面板无需修改即可支持 Hido。不限制设备的面板忽略即可。
| 请求头 | 示例 |
|---|---|
x-hwid | 3f2a9c0d5e7b41a8c6d2e9f0a1b3c4d5 |
x-device-os | iOS、Android |
x-ver-os | 18.5 |
x-device-model | iPhone 16 |
x-device-locale | zh |
下载时的 User-Agent 形如 Hido/v2.0.5 clash.meta mihomo clash-verge Platform/ios。请返回 Clash Meta（mihomo）格式，与 clash.meta 客户端相同。
面板 API 请求（开启 hido_client 时）
| 请求头 | 示例 |
|---|---|
User-Agent | Hido/v2.0.5 (iOS; 18.5) |
X-Device | iPhone 16：设备列表中易读的名称 |
x-hwid | 与上面相同的设备码，并附带其他设备请求头 |
Authorization | 登录接口返回的 auth_data |
GET /api/v1/user/getSubscribe HTTP/1.1
Authorization: Bearer …
User-Agent: Hido/v2.0.5 (Android; 15)
X-Device: Samsung SM-S928B
x-hwid: 3f2a9c0d5e7b41a8c6d2e9f0a1b3c4d5
x-device-os: Android
x-ver-os: 15
x-device-model: Samsung SM-S928B
x-device-locale: zh关于设备码
- 由 32 个小写十六进制字符组成，符合 Remnawave 的 HWID 规则。
- 是手机自身 ID（Android ID，或 iPhone、iPad 上的一个钥匙串项目）的单向哈希。原始 ID 绝不离开手机，且与其他应用发送的值不同。
- 用户重装 Hido 后保持不变，不同设备各不相同。
- 用户可在设置中查看并复制，方便客服在你的设备列表中找到对应设备。
3. 在哪里统计设备
订阅链接经常被分享并被其他工具抓取，因此我们建议在账户相关接口统计设备，以 x-hwid 识别每台设备，并用 X-Device 命名：
POST {api_path}/passport/auth/login和/passport/auth/registerGET {api_path}/user/getSubscribe
对于用服务商代码登录的账户，Hido 会在登录后立即、每次更新订阅之前（手动或自动）、打开应用时，以及应用保持打开期间每 30 分钟调用一次 getSubscribe。因此即使你的订阅路由不统计设备，设备也会被统计。
只粘贴订阅链接（不登录）的用户只会在下载时发送设备请求头。如需同样限制，请在订阅路由上也进行统计。
4. Hido 能识别的响应
Hido 会原样显示你的 message，请用用户的语言书写，并说明下一步该怎么做。
| 面板返回 | Hido 的处理 |
|---|---|
403 并带 {"code": "device_limit_exceeded", "message": "…"} | 显示消息。已登录的账户会在此设备上退出，并移除其配置。手动粘贴的链接会保留，但不会更新。 |
429 并带 {"code": "device_cooldown", "message": "…", "data": {"retry_after_minutes": 42}} | 显示消息，保留账户，不会自动重试。请在消息中写明等待时间。 |
带 Authorization 的请求返回 401，或不带 code 的 403 | 视为设备已退出：账户从设备上移除，用户需重新登录。可用于你已从账户中移除的设备。 |
订阅响应头 x-hwid-max-devices-reached: true 或 x-hwid-limit: true | 显示 Hido 自带的设备已满提示，与 Remnawave 相同。 |
5. 上线前检查
- 在 Hido 中登录：设备出现在面板中，名称来自
X-Device。 - 重装 Hido 后再登录：仍是同一台设备，而不是新设备。
- 在超出套餐上限的设备上登录：该设备收到你的 403 消息并被退出。
- 在面板中移除一台设备，然后在该设备的 Hido 中点击更新：账户会从该设备移除，直到用户重新登录。
如有疑问或需要为你的面板提供测试版本：[email protected]。