3 分钟 Docker 部署 NapCat！QQ 消息实时接收，二次开发必看！-寻找资源网

NapCat

一个致力于打破 QQ 机器人开发壁垒的开源项目。利用 NTQQ 的底层能力，构建了一个无需 GUI 即可在服务器端稳定运行的 Headless 框架。无论是个人开发者还是企业用户，NapCat 都能提供开箱即用的 OneBot 11 协议支持，助您快速将创意转化为现实。

图片[1]-3 分钟 Docker 部署 NapCat！QQ 消息实时接收，二次开发必看！-寻找资源网

基于 TypeScript 构建的 Bot 框架，通过相应的启动器或者框架，主动调用 QQ Node 模块提供给客户端的接口，实现 Bot 的功能。

图片[2]-3 分钟 Docker 部署 NapCat！QQ 消息实时接收，二次开发必看！-寻找资源网

NapCat 与很多框架都有本质性的区别：

• 协议端相比，并非完全自己实现 QQ SendMsg 这种功能，而是主动调用客户端存在的功能。
• Hook 端相比，NapCat 可以完全自身引导 QQ 程序的启动，而非借助客户端启动流程，所以 API 所有权几乎完全拥有，不需要 Hook。
• Electron IPC Hook 端对比，NapCat 本身并不依赖 Electron 与注入框架，调用来源 IPC 更下层封装的 Node 模块，也许甚至脱离 QQ 主程序运行。

安装

Docker Compose

services:
napcat:
    image: mlikiowa/napcat-docker:latest
    container_name: napcat
    ports:
      - 3000:3000
      - 3001:3001
      - 6099:6099
    environment:
      - NAPCAT_UID=0
      - NAPCAT_GID=0
    volumes:
      - ./QQ:/app/.config/QQ
      - ./config:/app/napcat/config
      - ./plugins:/app/napcat/plugins
    restart: always

参数说明（更多参数建议去看文档）

:::
/app/.config/QQ（路径，可选）：QQ 持久化数据路径

/app/napcat/config（路径，可选）：NapCat 配置文件路径

/app/napcat/plugins（路径，可选）：NapCat 插件目录路径

:::

请确保本地完成了 Git 的全局配置

git config --global user.name gcw_8qL3g3Z2
git config --global user.email gcw_8qL3g3Z2@noreply.gitcode.com

https

# 复制项目地址
https://gitcode.com/gh_mirrors/na/NapCatQQ.git

# 克隆到本地
git clone https://gitcode.com/gh_mirrors/na/NapCatQQ.git

# 使用 HTTPS 协议时，请配置并使用个人访问令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitcode.com': gcw_8qL3g3Z2

Password for 'https://gcw_8qL3g3Z2@gitcode.com': 个人访问令牌

SSH

# 使用 SSH 协议时，请在本地生成 SSH 公钥进行克隆、推送等操作

# 复制项目地址

git@gitcode.com:gh_mirrors/na/NapCatQQ.git
# 生成 RSA 密钥

ssh-keygen -t rsa -b 2048 -C gcw_8qL3g3Z2@noreply.gitcode.com
# 查看 RSA 公钥，并配置到 SSH key 中

cat ~/.ssh/id_rsa.pub
# 克隆到本地

git clone git@gitcode.com:gh_mirrors/na/NapCatQQ.git