让 QQ 机器人多号扫码、托管和对接更省事
面向多账号托管、扫码登录和 OneBot WebSocket 接入的管理平台。从注册、卡密开通、预热扫码到 NapCat 网络配置写入,都围绕实际托管流程设计。
接入流程
用户前台操作简单,管理后台统一控制。
开通账号额度
卡密或套餐决定有效期和可创建容器数。
弹窗扫码登录
优先分配预热容器,扫码后自动关闭并提示成功。
自动写入 WS
按后台设置生成服务器和客户端配置。
把多号 NapCat 管理的重复操作全部收到一个面板
适合 QQ 机器人开发者、多号运营工作室、OneBot 搭建用户。WebSocket 可理解为机器人和业务服务器的长连接通道。
一键对接服务器
后台填一次 WS 地址和 Token,用户登录后自动写入。不用反复手动填配置,也能减少端口和 Token 写错。
预热扫码池
提前准备待扫码容器。新建账号时优先分配已出码容器,减少等待容器启动的时间。
批量状态监控
一屏查看所有账号运行、在线、离线、待扫码状态。掉线和停止容器不用人工一个个排查。
容器隔离托管
每个账号独立容器、端口和数据目录。一个账号出问题不影响其他账号的配置和登录记录。
后台运维看板
查看内存、端口余量、预热池和 Docker 健康状态。Docker 可理解为每个账号的独立运行环境。
公告和邮件提醒
统一发布系统公告、客服和售后群信息。SMTP 邮件可用于掉线、到期等运营提醒。
登录后就是一个多号控制台
以下是后台的核心操作模型:看状态、扫码、重启、清理和查看容量。
账号运行概览
内存使用
看得见的好处
新手不需要记住容器命令、WS 配置文件和端口映射。大部分操作都在页面上点击完成。
用天数和容器名额控制使用成本
具体价格和套餐可在后台修改。用户可通过卡密兑换或支付套餐开通。
体验开通
1 天适合测试扫码、接入和容器状态流程。
常用托管
30 天适合稳定运行少量 QQ 机器人或 OneBot 业务。
工作室多号
按额度适合多号运营、批量管理和统一托管。
多号运营最怕混在一起,所以默认按账号隔离
独立容器
每个账号独立运行,登录记录和配置不互相覆盖。
不共享端口
系统自动分配 WebUI 和 WS 端口,减少手工冲突。
可视化清理
离线、停止、重复 QQ 可以在面板直接清理,降低无效容器占用。
不会部署也能按步骤接入
先登录面板,再按后台提供的端口和 WS 地址对接你的业务服务器。
1. 注册登录
用邮箱或用户名建立账号,保护你的额度和到期时间。
2. 开通额度
兑换卡密或购买套餐,获得可创建的账号数。
3. 扫码登录
无需本地部署,在网页弹窗里扫码即可。
4. 对接服务
用自动写入的 WS 配置连接机器人服务。
常见问题
OneBot 是什么?
可把它理解为机器人接口标准,你的业务服务器通过它和 NapCat 交互。
需要自己部署 QQ 吗?
不需要在本地搭环境。面板会在服务器上管理 NapCat 容器。
为什么扫码有时会失效?
二维码有时效性,过期后点击刷新或重扫即可生成新码。
可以管理多少个账号?
取决于你的套餐额度和服务器内存。后台会给出容量估算。
登录后管理扫码容器和 NapCat 接入配置
账号列表、预热池、扫码弹窗、WebSocket 配置和用户权限都在同一个工作台内完成。
弹窗扫码
创建账号后直接在当前页扫码,成功后自动关闭。
自动写入
登录后按后台配置生成 WS Server 和 WS Client。
后台可控
支持用户、卡密、套餐、公告、邮箱和支付配置。
登录账号
进入你的 NapCat 账号管理工作台。
注册账号
注册后可通过卡密或套餐开通有效期和账号名额。
我的账号
账号列表
未开通或到期后不能创建新账号,已有账号仍可查看。
套餐续费
当前支付为预留配置,未启用自动回调时请使用卡密兑换。
卡密兑换
说明
兑换成功后会自动延长当前登录用户的有效期。管理员可用口令接口生成卡密。
订单记录
展示卡密兑换和待支付记录。
| 时间 | 类型 | 标题 | 天数 | 金额 | 状态 |
|---|
后台管理
集中管理用户、套餐、卡密、支付、邮箱、NapCat 配置和运维清理。
系统总览
查看运行状态、内存、端口、预热池和容量估算。
服务状态
建议操作
运维工具
集中处理账号状态、NapCat 配置修复和无效容器清理。
修复 NapCat 配置
按后台 WebSocket 设置重新扫描并写入已登录账号的 onebot11 配置,不会自动重启账号容器。
清理重复账号
同一个 QQ 出现多条记录时,保留更合适的一条,移除多余容器和记录。
清理已停止账号
移除已经停止的账号容器和记录。到期暂停的账号不会被这个操作误删。
清理未登录账号
清理没有保存 QQ 登录记录的空账号,适合删除废弃的待扫码容器。
操作日志
查看最近的登录、创建、清理、配置修复和错误记录。
运营统计
注册趋势、用户消费排行、到期预警和卡密概况。
近 14 天注册趋势
近 14 天营收趋势
用户消费排行
7 天内到期预警
订单财务
查看收入汇总、待支付订单和最近成交订单。退款仍需到支付平台处理。
最近支付订单
待支付订单
| 时间 | 用户 | 标题 | 金额 | 状态 | 支付方式 | 操作 |
|---|
卡密管理
生成、搜索、复制卡密。
管理员账号
默认账号:admin
管理员密码以环境变量 ADMIN_USERNAME / ADMIN_PASSWORD 为准。
上线后如需修改密码,更新 .env 后重启服务。
支付配置
配置在线支付、回调地址和查询密钥。
支付配置
回调地址
支付回调地址会自动使用:
/pay_notify
查询接口:
/query_api.php?key=KEY&type=summary
支付平台需兼容易支付接口、MD5 签名和成功支付回调。
| 卡密 | 天数 | 名额 | 状态 | 使用者 | 备注 | 时间 | 操作 |
|---|
套餐管理
修改前台可购买套餐。
新增套餐
套餐说明
这里修改后,前台套餐页会自动读取最新启用套餐。
| 名称 | 天数 | 额度 | 价格 | 说明 | 状态 | 操作 |
|---|
网站设置
修改前台标题、说明和站点地址。
公告栏
售后信息
注册设置
显示位置
网站名称会同步到浏览器标题、顶部品牌和首页标题;网站说明会显示在顶部副标题。
站点地址用于支付回调和查询接口展示,建议填写公网访问地址。
NapCat 配置
管理登录后自动写入的 WebSocket 服务器和客户端配置。
WebSocket 服务器
WebSocket 客户端
内置 NapCat 取码
直接调用当前账号自己的 NapCat 获取 Code,不依赖外部 Provider;登录态保存在本机,空闲后自动释放容器内存。
农场业务端同步
预热池
自动生效规则
用户扫码登录成功并识别 QQ 后,会自动写入对应账号的 onebot11 配置。
服务器会写入 websocketServers,名称自动显示为“昵称服务器”;客户端会写入 websocketClients,名称自动显示为“昵称客户端”。
WebSocket 服务器端口由每个容器自动生成,后台不手动填写,避免端口写错导致连接失败。
WebSocket 客户端会按后台 URL、心跳和重连间隔写入。HTTPServer 不会自动添加。
取码回调地址
自动取码开启后,账号登录成功并识别 QQ 号时,后台会自动请求取码接口。也支持外部工具 POST 回调写入面板。
/api/external/farm-code
内置接口:单账号 /api/qq/code,批量 /api/qq/code/batch;不需要配置外部取码地址。
回调请求头:Authorization: Bearer 你的回调 Token
农场业务端同步只负责把真实 Code 写入 qq-farm 账号,不生成假 Code,也不请求 QQ 私有凭证接口。
预热池说明
开启后后台会常驻指定数量的待扫码容器,用户创建账号时优先分配,能减少首次出二维码等待时间。
关闭后会清理待扫码池容器;建议普通服务器设置为 1-2,避免占用过多内存。
邮箱发送管理
配置 SMTP、通知规则和测试发送。
SMTP
通知规则
掉线邮件模板
续费邮件模板
测试发送
配置提示
QQ 邮箱通常需要填写 SMTP 授权码,不是登录密码。465 使用 SSL,587 使用 STARTTLS。
续费提醒默认到期前 3 天开始,每天 10 点发送一次;掉线提醒按账号冷却时间发送,避免频繁打扰。
{username} 用户名,{qq} QQ 号,{container} 容器名,{days} 剩余天数,{expireAt} 到期时间,{siteUrl} 面板地址。正文可以写普通文字,也可以写简单 HTML。
用户管理
管理注册用户、到期时间和容器额度。
新建用户
| 用户 | 角色 | 到期 | 容器额度 | 状态 | 操作 |
|---|