QQ 安全签名服务 (QSign Server)

基于 Frida 的 QQ 安全签名服务，提供 HTTP 接口与安卓客户端交互，支持签名生成、日志追踪和实时统计。

---

目录

• 功能特性
• 环境准备
• 快速开始
• API 文档
• 风险须知
• 调用示例
• 返回数据示例
• 日志与统计
• 贡献指南
• 许可证

---

注意事项

• 本项目只实现该方法的调用
• 一切风险由用户自行承担
• 该项目仅供学习和参考

功能特性

✅ 核心功能

• 通过 USB 调试与安卓设备通信
• 支持 com.tencent.mobileqq:MSF 包名
• 参数严格校验（十六进制、序列号格式）
• 实时统计面板与日志查询
• 多线程任务队列（最大 10 并发）

✅ 监控能力

• 请求耗时统计
• 成功率分析
• UIN 调用排名
• 小时级请求分布

---

环境准备

1. 依赖安装

pip install -r requirements.txt

必需组件：

• Python 3.8+
• Frida 16.0+
• Android 设备（启用 USB 调试）
• MuMu模拟器
• QQ.APK

必需操作：

• 启动MuMu模拟器
• 安装QQ.APK
• 启动QQ进程
• 使用ADB连接MuMu模拟器并推送Frida服务器
• 运行Frida服务器

2. 配置文件

创建 config.py：

# config.py
import os

# 模板配置
TEMPLATES_AUTO_RELOAD = True  # 开发环境热重载（生产环境应设为 False）
EXPLAIN_TEMPLATE_LOADING = False  # 禁用模板加载调试信息

# 压缩配置（需配合 Flask-Compress 扩展）
COMPRESS_MIMETYPES = [
    'text/html',
    'text/css',
    'application/javascript',
    'application/json',
    'image/svg+xml'  # 增加对 SVG 的压缩支持
]
COMPRESS_LEVEL = 6  # Gzip 压缩级别（1-9，6 是平衡值）
COMPRESS_MIN_SIZE = 500  # 仅压缩大于 500 字节的响应

# 静态文件版本控制
STATIC_VERSION = '1.0.1'  # 

# API 参数定义（供模板使用）
PARAMS_DEFINITIONS = {
    "cmd": "命令字符串（示例：wtlogin.login）",
    "seq": "请求序列号（十进制字符串）",
    "buffer": "十六进制编码的二进制数据",
    "uin": "用户唯一标识（QQ号）",
    "qua": "客户端标识（示例：V1_AND_SQ_8.9.53_3362_YYB_D）",
    "package": "目标包名（必须为 com.tencent.mobileqq:MSF）"
}

---

快速开始

启动服务

python app.py
# 默认监听 0.0.0.0:5000

---

API 文档

POST/GET /sign

请求参数

参数	类型	必填	说明
cmd	string	是	命令类型（如 wtlogin.login）
seq	string	是	请求序列号（数字字符串）
buffer	string	是	十六进制数据
uin	string	是	用户唯一标识
qua	string	是	客户端标识
package	string	是	目标包名（必须为 com.tencent.mobileqq:MSF）

错误码

状态码	说明
400	参数缺失/格式错误
500	服务端异常或签名失败

---

风险须知

⚠️ 重要提示

1. 本工具依赖 USB 调试模式，仅限在授权设备上使用。
2. 可能触发设备安全机制，请确保已获得合法授权。
3. 不记录敏感数据，但建议在安全网络环境下使用。

---

调用示例

POST 请求

curl -X POST http://localhost:5000/sign \
-H "Content-Type: application/json" \
-d '{
    "cmd": "wtlogin.login",
    "seq": "123456",
    "buffer": "00010203040506070809",
    "uin": "10001",
    "qua": "V1_AND_SQ_8.9.53_3362_YYB_D",
    "package": "com.tencent.mobileqq:MSF"
}'

GET 请求

curl "http://localhost:5000/sign?cmd=wtlogin.login&seq=123456&buffer=00010203040506070809&uin=10001&qua=V1_AND_SQ_8.9.53_3362_YYB_D&package=com.tencent.mobileqq:MSF"

---

返回数据示例

成功响应

{
    "data": {
        "extra": "1201311a9001413332453339333930354638343030303336314231313734313241444434424131313132393743353637463332304545333846443235384635304632313030443831353932443635344534393539444241443143333432393731393232333635374244353246444334374533373145433235434645343742443939453936304544334531414144413233453833463443",
        "sign": "0c214a9dfbedbf45c59972071f8a77aed1d19971ffde7175eeba299a74a9fff3d5a616a3e530c068201829e9f4ec25c9dbfebf347e03ef96093c664472d38b7837f0cc8b80f3738b75953720",
        "token": "4344792f512b497a65335447"
    },
    "status": "success"
}

错误响应

{
  "status": "error",
  "message": "参数格式错误: buffer 应为十六进制"
}

---

日志与统计

实时统计面板

访问 http://localhost:5000/stats 查看：

• 总请求量
• 成功率曲线
• 响应时间分布
• 热点 UIN 排行

日志查询

访问 http://localhost:5000/logs 查看原始日志（支持分页）。

---

许可证

本项目采用 MIT License，详细条款见 LICENSE 文件。

---

TIPS

未提及的方法或行为请自行探索

---