飞牛 fnos 使用docker部署NapCat-QQ对接autman教程

NapCatQQ介绍

• 无需图形环境，在Linux上表现出色，与现有Hook框架有本质区别，性能与内存占用优于基于Hook的框架。
• 配置简单，支持浏览器远程配置。
• NTQQ功能适配快速，持续跟进QQ最新版。
• 项目地址：https://github.com/NapNeko/NapCatQQ
• 官方文档：https://napneko.github.io/zh-CN/
• 官方Docker版本项目地址：https://github.com/NapNeko/NapCat-Docker
• 官方变量：https://github.com/NapNeko/NapCat-Docker/blob/main/entrypoint.sh

官方拉取镜像相关概念

• ACCOUNT：设置为机器人QQ号。
• 正向ws：NapCatQQ端等待连接，连接成功后可通信并收发消息。
• 反向WS：NapCatQQ端主动寻找第三方框架接口适配，成功后收发消息。
• HTTP：分正向和反向，正向等连接只能发消息，反向主动连接只能收消息。
• -p 6099:6099：NapCatQQ的web配置页面，前面可改，6099不变。可参考官方变量文档修改变量。

Linux - Docker版本NapCatQQ部署

1. 在飞牛文件管理中创建napcat文件夹

2.在其下再创建config、.config和logs文件夹。

3.利用工具ssh登录飞牛NAS，切换root用户

sudo -i

需改ws://后IP和端口，name、目录路径，替换WEBUI_TOKEN值。，然后运行下面命令

docker run -d \
-e ACCOUNT=机器人QQ号 \
-e MESSAGE_POST_FORMAT='string' \
-e WEBUI_TOKEN='jichun29.cn' \
-e WSR_ENABLE=true \
-e WS_URLS='["ws://autmanIP:端口/qq/receive"]' \
-e NAPCAT_GID=0 \
-e NAPCAT_UID=0 \
-p 6099:6099 \
-v /vol1/1000/docker/napcat/config:/app/napcat/config \
-v /vol1/1000/docker/napcat/.config:/app/.config/QQ \
-v /vol1/1000/docker/napcat/logs:/app/napcat/logs \
--name napcat \
--restart=always \
--mac-address=02:42:ac:11:00:99 \
mlikiowa/napcat-docker:latest

命令解读

• ws相关命令：
  • ACCOUNT：机器人QQ号（需替换）。
  • MESSAGE_POST_FORMAT：消息上报格式，string为CQ码（一般不动）。
  • WEBUI_TOKEN：webui密钥，需修改（防止安全隐患）。
  • WS_URLS：反向地址（需替换）。
  • NAPCAT_GID和NAPCAT_UID：官方后台运行命令，默认值不动。
  • 6099:6099：webui端口，前可改，后6099不变，注意端口占用。
  • 挂载目录：如/root/napcat/config:/app/napcat/config等，/root/napcat可根据系统更改。
  • name：容器名（可不改）。
  • mac - address：mac值，首次默认，多个机器人需更改。
• 变量命令加减：可访问官方文档，如在拉取命令加TOKEN='自定义token'（需框架支持）。

飞牛 - Docker版本NapCatQQ部署

1. 在文件管理中创建napcat文件夹

在其下再创建config、.config和logs文件夹。

1. 在docker镜像仓库下载mlikiowa/napcat-docker映像。

1. 容器新增，选napcat镜像，设容器名，勾选自动重启。

1. 设置端口号，前空格自定义，后空格6099

1. 存储空间添加创建的文件夹，对应路径设置为/app/napcat/config、/app/.config/QQ、/app/napcat/logs。

1. 添加环境变量： - ACCOUNT：机器人QQ - MESSAGE_POST_FORMAT：string - WSR_ENABLE：true - WS_URLS："ws://autmanIP:端口/api/bot/qqws" - NAPCAT_GID：0 - NAPCAT_UID：0 - mac - address：02:42:ac:11:00:99 可加WEBUI_TOKEN自定义token。

填完后下一步创建启动即可

web端扫码登录QQ或配置

1. 找到napcat--config--webui.json文件，记录token（可更改并保存）。

1. 浏览器输入飞牛IP + Napcat设置的外部端口 + webui（如6099），输入token登录。

1. 点击QR Code获取二维码，扫码失效刷新页面

4.勾选下次登录无需手机确认

5.登录后点网络配置，新建

6.主要是ws地址设置，名称随意写、消息格式默认，记得顶部启用勾上，保存即可

格式：ws://奥特曼IP:端口/qq/receive

举例：ws://192.168.31.33:9191/qq/receive

常见问题

1. 调用接口报404：NapCatQQ未支持全部OneBot规范接口，检查是否调用不支持的接口。
2. 如何使用CQ码：将消息上报类型格式从消息段改为CQ码。
3. 二维码无法扫描：NapCat自动保存二维码到目录，可手动打开扫描；无法访问本地目录，可将二维码解析URL复制到生成网站重新生成，注意二维码会过期。
4. 语音、视频发送失败：手动配置ffmpeg路径，下载后加入环境变量，若无效，修改NapCat启动脚本加入FFMPEG_PATH变量指定完整路径。
5. 出现error code v2:-1之类提示：QQ本身问题，不影响使用。
6. 登录提示“网络环境不稳定”“不在同一网络”：在服务器扫码登录出现此提示，可本地登录后将QQ配置传到服务器相同目录覆盖（Linux下~/.config/QQ，Windows下一般是系统盘:\Users (用户)\Documents\Tencent Files）；或手机用VPN连接到服务器网络。