高级配置

配置 FFmpeg

FFmpeg 是什么？

FFmpeg 是知名的开源音视频处理库，被用于许多音视频编解码相关的项目中。

为什么要使用 FFmpeg？

本项目使用 FFmpeg 是为了编解码语音和视频，以使 NapCat 以 QQ 支持的格式处理语音和视频文件。

如果你的 Bot 没有处理语音和视频的需求，可以选择不安装 FFmpeg。

安装 FFmpeg

Windows 系统

在此处下载ffmpeg-master-latest-win64-gpl.zip
将其中的文件夹解压至一个你知道的地方（例如 C:\Program Files），然后重命名为 ffmpeg；
你的 ffmpeg 文件夹的结构看起来应该是这样的：
text
```
ffmpeg
|___bin
|___|___ffmpeg.exe
|___|___ffplay.exe
|___\___ffprobe.exe
|___doc
|___\ ...
|___LICENSE
\___README.txt
```
注意
请一定要保证 bin 文件夹内同时包含 ffmpeg.exe、ffplay.exe 以及 ffprobe.exe！ 否则会产生意想不到的错误。
添加bin目录到系统环境变量不会可以搜索系统设置环境变量

如果有其他程序也需要使用 FFmpeg

如果其他程序支持手动选择 FFmpeg 位置，只需配置为 NapCat 所使用的 FFmpeg 即可。

如果其他程序不支持手动选择 FFmpeg 位置，只需将 FFmpeg 的 bin 目录注册到系统的 PATH 变量中（可参考此教程）即可。

如果你将 FFmpeg 安装到了系统变量中，那么无论有没有在 NapCat 中配置 FFmpeg 路径也可以正常使用 FFmpeg。

Linux 系统

请使用你所使用的系统的包管理器直接安装 ffmpeg 即可正常使用。

macOS 系统

由于系统存在沙盒机制，无法运行外部程序，因此暂不支持。

配置 PacketBackend

这是干什么的?

这是用来提供NTQQ本身没有的功能的DLC，以下配置方式二选一即可

配置 PacketBackend (Native)

TIP

NapCat 3.6.0及以后的版本在Linux平台 (amd64, arm64), MacOS平台(amd64, arm64)，Windows平台 (amd64) 已内置 PacketBackend 实现 ，您无需进行额外的配置即可享受DLC的欢乐 (/≧▽≦)/

配置 PacketBackend (Server)

WARNING

PacketBackend (Server) 已过时并不推荐使用

配置方法

下载地址: PacketRelease

Win Amd64

你需要先行下载 napcat.packet.exe 的软件

Linux Amd64

下载 napcat.packet.linux 组件

Win/Linux 通用方案

(除上面支持外还兼容Linux Arm64)

你需要先行下载 napcat.packet.production.py 类似文件安装frida和websockets依赖启动python napcat.packet.production.py

接下来的教程

启动后会再当前目录生成config.json

可以设置端口再次重启生效

打开 NapCat 的 config 目录，找到名为 napcat_<你的QQ号>.json 的文件，如 napcat_1234567.json。

打开后如下

json5

{
  "fileLog": true,
  "consoleLog": true,
  "fileLogLevel": "debug",
  "consoleLogLevel": "info",
  "packetBackend": "auto", 
  "packetServer": "127.0.0.1:8086"
}

packetServer 填写 127.0.0.1:8086(具体可见PacketServer显示的地址 IP:端口)

填写后 确保napcat在PacketServer启动后再启动 登录输入账号即可

WARNING

该技术受到版本严重影响
packetServer多开配置连接同一个packetServer即可

当前支持版本

平台版本	Native	Server
Windows Amd64 28418-29456	✅	✅
Linux Amd64 28498-29456	✅	✅
Linux Arm64 28498-29456	✅	✅
MacOS Arm64 29456-29456	✅	✅
MacOS Amd64 29456-29456	✅	✅

扩展进度

支持	功能
✅	设置群头衔
✅	发送poke
✅	独立Rkey获取
✅	陌生人状态获取
✅	伪造合并转发
✅	文件直链获取
✅	MarkDown
✅	群签到
✅	小程序卡片分享
✅	AI 声聊

高级配置 ​

配置 FFmpeg ​

FFmpeg 是什么？ ​

为什么要使用 FFmpeg？ ​

安装 FFmpeg ​

Windows 系统 ​

Linux 系统 ​

macOS 系统 ​

配置 PacketBackend ​

这是干什么的? ​

配置 PacketBackend (Native) ​

配置 PacketBackend (Server) ​

Win Amd64 ​

Linux Amd64 ​

Win/Linux 通用方案 ​

接下来的教程 ​

当前支持版本 ​

扩展进度 ​