MajdataX-Bot部署指南

基于最新的 NapCatQQ (原生支持 Linux ARM64 的 NTQQ 框架) + FastAPI (Python)。通过 HTTP API 接收请求并向 QQ 群发送消息。

适用环境

• Linux ARM64 (树莓派 4/5, 各种 ARM64 开发板，如 RK3588、Debian aarch64 等)
• 已安装 docker 和 docker-compose

项目结构

• docker-compose.yml: 用于一键启动 QQ 客户端 API 和你的 Bot 服务器。
• main.py: 使用 FastAPI 编写的接收 HTTP 请求并转发消息的 Web 服务。
• requirements.txt & Dockerfile: Bot 服务器的运行环境依赖。

部署步骤

1. 准备配置

在 docker-compose.yml 中修改你期望的环境变量：

• 将 TARGET_GROUP_ID=123456789 替换为你要发送消息的目标 QQ 群号。

2. 启动服务

在终端进入该目录，运行：

docker-compose up -d

3. 扫码登录 QQ

NapCatQQ 启动后，需要扫码登录你的机器人 QQ 账号。可以通过两种方式：

• 查看日志扫码：运行 docker logs -f napcat，终端会输出一个二维码，使用手机 QQ 扫码即可登录。
• Web 面板配置：浏览器访问 http://<你的树莓派IP>:6099，在可视化的 Web 界面中管理你的 QQ 账号登录和 HTTP API 配置。

4. 测试发送消息

Bot 服务器运行在 8000 端口。你可以在任何地方通过 HTTP POST 请求触发发消息行为：

curl -X POST "http://<你的树莓派IP>:8000/send" \
     -H "Content-Type: application/json" \
     -d '{"message": "Hello, 这是一个测试消息来自树莓派!"}'

如果成功，你的 QQ 群就会收到这条消息！

架构说明

1. NapCatQQ 容器: 本地登录 QQ 并将其封装成标准的 OneBot V11 HTTP 接口（运行在 3000 端口）。
2. Bot Server 容器: 监听 8000 端口，提供一个 /send 路由。当接收到合法的 JSON 格式请求后，调用 NapCatQQ 的 http://napcat:3000/send_group_msg 将消息投递出去。