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

3.6 KiB
Raw Blame History

虎牙 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,合并认证字段和网页运行字段后回写账号。

标识符口径

必须先读 设备标识命名规范。最容易混淆的三类值是:

  • HDID32:WUP 登录帧使用的 32hex 登录设备标识,不能混同网页 hdid;
  • DEVID40:设备注册链返回的 40hex device_id;
  • GUID32:doLaunch/会话体系的 32hex sGuid。

任何新增日志、文档或字段都不要只写模糊的“hdid”。

  • raw_cookie 保存 App/WebView 原始凭据;
  • cookie 保存可运行的网页 Cookie;
  • 认证字段以本次登录真实返回值为准;
  • 网页设备字段优先使用真实值,缺失时按已复刻算法补齐;
  • 活动 WSS 缺少会话字段时先走 wsLaunch,拿到 guid 后重建连接。

字段级状态见 虎牙 Cookie 路线状态, 来源约束见 Cookie 合并审计与来源矩阵, 浏览器证据见 网页设备字段溯源。

CK 获取

cred0 与 WebView Cookie 能补齐 WSS 登录态;缺少匿名设备字段时, 后端可再走匿名设备协议补齐。

协议与算法

已知边界

  • 风控可能切换到扫码、短信或其他验证方式;遇到新 challenge 时以 core/huya/verification/solver.py 的异常类型和日志为准。
  • 订单、兑换和支付属于写操作,自动回归只验证协议构造与只读路径。
  • 真实 Cookie、UID、订单号和设备金样本不得写入 Markdown 或提交到 Git。
  • 协议字段状态应以当前代码和 虎牙 Cookie 路线状态 为准, 历史抓包只能作为证据,不能直接覆盖现有实现。