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