Files
live-hub-py/docs/虎牙/HUYA_APP_OVERVIEW.md
T

78 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 虎牙 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) 为准,
历史抓包只能作为证据,不能直接覆盖现有实现。