部署 NapCatQQ 并接入 AstrBot 实现 QQ 聊天机器人功能

GitHub项目地址：NapNeko/NapCatQQ
文章部分内容出自NapCatQQ 帮助文档, AsrtBot 帮助文档

由于官方文档不推荐使用 Framerwork，所以本篇只讲述 Shell 版本的部署方式

安装 NapCatQQ

Windows 一键安装

Windows 一键安装

1. 打开 Github Releases: NapNeko/NapCatQQ
2. 下载 NapCat.Shell.Windows.OneKey.zip
3. 解压全部文件并运行 NapCatInstaller.exe
4. 等待安装完成后进入 NapCat.XXXX.Shell 目录，运行 napcat.bat

   XXXX 为版本号，一般由数字组成

可在终端打印日志中找到登陆二维码

Windows 可视化管理工具

1. 打开 Github Releases: NapNeko/NapCatQQ-Desktop
2. 下载 NapCatQQ-Desktop.exe
3. 按照指引安装程序
4. 在左侧面板中选择 组件 - QQ ，按照提示安装 QQ

5. 在左侧面板中选择 添加 ，在 Bot QQ 中输入机器人 QQ 号

6. 在左侧面板中选择 列表 ，选择要启用的机器人，进入后点击启动

Linux 一键安装

curl -o \
napcat.sh \
https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh \
&& sudo bash napcat.sh

Docker

通过 Docker Compose 和 AstrBot 一同部署

创建名为 docker-compose.yml 的文件，并填写以下内容

# docker-compose.yml
# NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose -f ./compose/astrbot.yml up -d
services:
  napcat:
    environment:
      - NAPCAT_UID=${NAPCAT_UID:-1000}
      - NAPCAT_GID=${NAPCAT_GID:-1000}
      - MODE=astrbot
    ports:
      - 6099:6099
    container_name: NapCat
    restart: always
    image: mlikiowa/napcat-docker:latest
    volumes:
      - ./data:/AstrBot/data
      - ./ntqq:/app/.config/QQ
    networks:
      - astrbot_network
    mac_address: "02:42:ac:11:00:02"
  astrbot:
    environment:
      - TZ=Asia/Shanghai
    image: soulter/astrbot:latest
    container_name: AstrBot
    restart: always
    ports:
      - "6185:6185"
      - "6195:6195"
      - "6199:6199"
    volumes:
      - ./data:/AstrBot/data
      - ./napcat/config:/app/napcat/config
      - ./ntqq:/app/.config/QQ
    networks:
      - astrbot_network
networks:
  astrbot_network:
    driver: bridge

在文件所在目录执行

NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose -f ./docker-compose.yml up -d

通过 Docker 部署

docker run -d \
-e NAPCAT_GID=$(id -g) \
-e NAPCAT_UID=$(id -u) \
-p 3000:3000 \
-p 3001:3001 \
-p 6099:6099 \
--name napcat \
--restart=always \
mlikiowa/napcat-docker:latest

部署后查看日志就可以获取登陆二维码了

接入 AstrBot

AstrBot 配置

1. 打开 AstrBot 面板
2. 在左侧面板中选择 消息平台 ，并在右侧点击 新增适配器
3. 选择 aiocqhttp(OneBotv11)

在配置项中填写：

• 反向 WebSocket 主机地址：请填主机的 IP 地址，也可以填写 0.0.0.0
• 反向 WebSocket 端口：填写一个端口（如8848），并且记住这个端口

NapCatQQ 配置

打开 NapCatQQ 的管理面板，依次找到 网络配置->新建->WebSockets客户端

在配置项中填写：

• URL：刚刚配置的主机的 IP 地址+端口，例如 ws://127.0.0.1:8848/ws
• 心跳间隔和重连间隔：5000

检查日志可确认连接状态