# 虎牙 App 协议总览 更新时间:2026-11-06 本文是虎牙协议文档的入口。先确认当前链路,再按需进入字段来源、算法或抓包证据。 ## 当前生产入口 | 能力 | 代码入口 | | --- | --- | | App 密码登录 | `core/huya/app_login.py` | | Web 密码登录 | `core/huya/login.py` | | 短信登录 | `core/huya/sms_login.py` | | 自动注册 | `core/huya/auto_register.py` | | Cookie 补齐与重建 | `core/huya/web_cookie_fields.py`、`core/huya/cookie_utils.py` | | 活动与商城 WSS | `core/huya/wss_client.py`、`core/huya/elite_session.py` | | API 路由 | `web/backend/routers/huya/` | App 登录主链: 1. 读取或生成账号设备画像; 2. 走 `dfp_register.register_device()` 获取本次登录设备凭据; 3. 向 `wup.huya.com` 发密码登录请求,解析 UID 与 114 字节 `cred`; 4. 本地生成 nonce、证书和 WUP 信封; 5. 复用扫码绑定协议取得 `biztoken`; 6. 调网页 cookie verify,合并认证字段和网页运行字段后回写账号。 ## 标识符口径 必须先读 [设备标识命名规范](HUYA_ID_NOMENCLATURE.md)。最容易混淆的三类值是: - **HDID32**:WUP 登录帧使用的 32hex 登录设备标识,不能混同网页 `hdid`; - **DEVID40**:设备注册链返回的 40hex `device_id`; - **GUID32**:doLaunch/会话体系的 32hex `sGuid`。 任何新增日志、文档或字段都不要只写模糊的“hdid”。 ## 当前 Cookie 模型 - `raw_cookie` 保存 App/WebView 原始凭据; - `cookie` 保存可运行的网页 Cookie; - 认证字段以本次登录真实返回值为准; - 网页设备字段优先使用真实值,缺失时按已复刻算法补齐; - 活动 WSS 缺少会话字段时先走 `wsLaunch`,拿到 guid 后重建连接。 字段级状态见 [虎牙 Cookie 路线状态](HUYA_COOKIE路线状态.md), 来源约束见 [Cookie 合并审计与来源矩阵](HUYA_COOKIE合并审计与来源矩阵.md), 浏览器证据见 [网页设备字段溯源](HUYA_WEB_FIELD_TRACE.md)。 ## CK 获取 - 已登录 H5 抓包:见 [HAR 提取 CK 与积分中心](HAR提取CK与积分中心.md); - 小X分身/App WebView:见 [小X分身虎牙 CK 提取](分身CK提取.md); - 后端重建:`POST /api/huya/cookies/{account_id}/rebuild`。 `cred0` 与 WebView Cookie 能补齐 WSS 登录态;缺少匿名设备字段时, 后端可再走匿名设备协议补齐。 ## 协议与算法 - App 加密算法:[App 登录加密算法动态验证](虎牙App登录-加密算法动态验证.md) - 证书生成:[虎牙证书算法闭环](虎牙证书算法闭环-差分实证.md) - 登录 WUP 结构:[证书算法闭环](虎牙证书算法闭环-差分实证.md) 与 `core/huya/wup_encoder.py` - 扫码绑定:[扫码登录闭环逆向](虎牙扫码登录闭环逆向.md) - 设备注册与 dfpReport:[dfpReport 生成流程](dfpReport生成流程.md) - HDID:[算法生成路径](HUYA_HDID_ALGORITHM_GEN.md) 与 [研究记录](HUYA_HDID_RESEARCH.md) - Frida 稳定注入:[Frida 绕过配方](Frida绕过配方.md) - Hook 与证据落盘:[Hook 运行与捕获约定](Hook脚本运行与捕获约定.md) ## 已知边界 - 风控可能切换到扫码、短信或其他验证方式;遇到新 challenge 时以 `core/huya/verification/solver.py` 的异常类型和日志为准。 - 订单、兑换和支付属于写操作,自动回归只验证协议构造与只读路径。 - 真实 Cookie、UID、订单号和设备金样本不得写入 Markdown 或提交到 Git。 - 协议字段状态应以当前代码和 [虎牙 Cookie 路线状态](HUYA_COOKIE路线状态.md) 为准, 历史抓包只能作为证据,不能直接覆盖现有实现。