mlikiowa/napcat-framework-docker 封装 NapCat 核心与 WebUI，读取 QQ 登录二维码或 token 后维持与腾讯 QQ 的长连接，对外暴露 OneBot v11/v12 HTTP/WebSocket 供下游 bot 逻辑调用。Session 与缓存写入本地目录，同一 QQ 号不可多容器并行，否则触发风控或 session 冲突。与 go-cqhttp 相比 NapCat 基于 NTQQ 协议栈；生产应 --restart unless-stopped、固定 tag，并将 config 与 data volume 持久化，不适合 无 session 的多副本 Kubernetes Deployment。

快速启动

docker run -d --name napcat \
  -p 3000:3000 -p 3001:3001 \
  -v $(pwd)/napcat-config:/app/napcat/config \
  docker.io/mlikiowa/napcat-framework-docker:latest

推荐实践

docker run -d --name napcat \
  --restart unless-stopped \
  -p 3000:3000 -p 3001:3001 \
  -v /data/napcat/config:/app/napcat/config \
  -v /data/napcat/qq:/app/.config/QQ \
  -e NAPCAT_GID=1000 -e NAPCAT_UID=1000 \
  docker.io/mlikiowa/napcat-framework-docker:v4.5.0

核心参数说明

• -p 3000:3000 — WebUI 与 OneBot HTTP 端口
• -p 3001:3001 — OneBot WebSocket 端口
• -v .../config:... — NapCat 与 OneBot 配置文件
• -v .../qq:... — QQ NT 登录 session 与缓存
• -e NAPCAT_UID/GID — 容器内运行用户与 volume 权限对齐
• 单实例 — 同一 QQ 账号禁止多副本并行