78 lines
3.6 KiB
Markdown
78 lines
3.6 KiB
Markdown
# 虎牙 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) 为准,
|
||
历史抓包只能作为证据,不能直接覆盖现有实现。
|