Skip to content

🚀 快速开始:QQ HTTP 接口模块

本教程将指导你如何使用 LuaHook 框架,部署你的 QQ HTTP 接口脚本,从而实现通过局域网 HTTP 请求控制 QQ 消息发送、获取好友和群列表等功能.


🧰 0. 准备工具

你需要先完成 LuaHook 模块的安装和激活,具体请参考 LuaHook 的官方快速开始文档 中的步骤。


💾 1. 部署脚本

  1. 打开 LuaHook,进入 App 页面.
  2. 点击右下角 “+” 按钮,选择你想 Hook 的应用,本例中应选择 QQ.
  3. 点击 QQ 应用卡片 → 点击右下角 “+” 按钮新建脚本.
  4. 将你的 QQ_Hook.lua 脚本内容粘贴到编辑界面并保存.

✅ 2. 启用 Hook

  1. 在 LuaHook 中,确保你的 QQ 脚本处于 激活状态
  2. 点击页面顶部的 三角(Start) 图标启动 QQ 应用.
  3. 脚本成功 Hook 到 com.tencent.mobileqq.activity.SplashActivityonCreate 方法后,会尝试在后台开启 HTTP 服务.

🌐 3. 测试 HTTP 接口

脚本成功启动后,会在设备的 8888 端口 开启一个 HTTP 服务器.

📌 服务信息

  • 端口: 8888
  • 地址: 你设备的 WIFI IP 地址.
    • 例如:如果你的设备 IP 是 192.168.1.100,则基础地址为 http://192.168.1.100:8888.
  • 提示: 你的电脑或其它设备需要和运行 QQ 的设备在同一个局域网内才能访问。

🛠️ 接口测试示例

1. 检查服务是否运行 (/ping)

如果返回类似 {"status":"ok","time":...} 的 JSON 字符串,则表示服务运行正常.

GET /ping

示例 URL: http://<你的WIFI IP>:8888/ping

⚠️ 注意事项

  • HTTP 服务只会在 com.tencent.mobileqq.activity.SplashActivity onCreate 时初始化一次.
  • 如果启动失败,请检查应用是否拥有 INTERNET 权限,以及端口 8888 是否被占用.