本文是NTQQ部署教程以及NTQQ接入Yunzai,Nonebot教程
本文支持的平台 ( 点击可快速跳转 )
Windows
Windows推荐使用 llonebot 可人机合一
有公网IP推荐使用挂机宝部署
Windows 用户一键安装方案
前往这里下载exe,双击运行即可,之后打开QQ的设置,看到了 LLOneBot 就代表安装成功了.
上不去就挂梯子
Linux
Linux推荐使用 Napcat
Napcat
NapCatQQ 是基于 PC NTQQ 客户端本体实现的 QQ Bot 框架,稳定安全,快速部署。
NapCatQQ 的优势
不需要图形环境,Linux表现优异,与现有Hook框架有着本质区别,在性能与内存占用方面远远优于基于Hook的框架。
配置简单,支持浏览器远程进入进行配置,简单轻松即可完成配置。
NTQQ功能适配快速,更新持续跟进QQ最新版。
启动前需要了解的三两事 (!你给我好好读三遍)
WARNING
- NapCat 是基于 PC NTQQ 客户端本体实现的 QQ Bot 框架,所以说需要提前安装好和 NapCatQQ 对应的 QQ 版本才能运行 NapCat。
- NapCat 在线时,你不能使用 PC QQ 客户端实现人机合一,但是可以选择同步登录移动客户端,如果想要在 PC 上人机合一请使用 LLOneBot
- NapCat 不同于协议实现,是基于 QQ 客户端,QQ 客户端上干不了的事,NapCat >_< 当然也是不行的!
下载 NapCatQQ
下载地址: https://github.com/NapNeko/NapCatQQ/releases
Linux一键脚本
安装NapCat
curl -o napcat.sh https://fastly.jsdelivr.net/gh/NapNeko/NapCat-Installer@master/script/install.sh && sudo bash napcat.sh
安装依赖
sudo apt install libgbm1 libasound2
sudo apt install ./linuxqq_3.2.7-23361_amd64.deb -y #这里以3.2.7版本为例,且系统是ubuntu系统
apt --fix-broken install
启动NapCat
#前台启动,推荐使用screen创建窗口前台启动
xvfb-run qq --no-sandbox
#后台启动
nohup xvfb-run qq --no-sandbox > nul 2> nul &
#使用后台启动需要使用exit退出服务器
如果你已经成功登录过官方 QQ 或者 NapCatQQ,可以加参数 -q <你的QQ> 进行快速登录而无需扫码,如
xvfb-run qq --no-sandbox -q 1234567
nc目录
cd /opt/QQ/resources/app/app_launcher/napcat
screen相关
#安装
apt install screen
#创建窗口
screen -S (名称)
#退出后重新连接窗口
screen -xr (名称)
配置ws连接Yunzai和Nonebot
llonebot
打开 QQ > 设置 > LLOneBot 版本号 > 启用反向 WebSocket 服务
ws://127.0.0.1:8080/OneBotv11
ws://127.0.0.1:8080/onebot/v11/ws
将
127.0.0.1:8080
修改成你服务器的IP:端口
本地可修改为
localhost:端口
NapCat
基础配置介绍
用 WebUI 配置
如果你已经启动了 NapCat,并且有多于 1 个开放端口,则可以通过 WebUI 进行配置。
默认端口为 6099。当端口被占用时,会自动对端口 +1,直到找到可用端口,端口号会在启动时显示。
启动后打开 ./config/webui.json 文件,token 密码可在其中找到。
{
"port": 6099, // WebUI 端口
"token": "xxxx", //登录密钥,默认是自动生成的随机登录密码
"loginRate": 3, //每分钟登录次数限制
}
访问 http://IP:端口/webui/login.html,然后进行以下操作:
进入 QQ 登录,点击 QRCode 进行二维码登录。
登录成功后,即可修改配置。
配置完成后,点击保存,重启即可生效。
配置方法参考llonebot
用文件配置 OneBot11设置
和上面一样,重启登录后配置才能生效。
打开 NapCat 的 config 目录,找到名为 onebot11_<你的QQ号>.json 的文件,如 onebot11_1234567.json;如果没有此文件可以复制 onebot11.json 重命名为 onebot11_<你的QQ号>.json。
下面是配置内容参数解释:
{
"http": {
// 是否启用http服务, true为启动,false为禁用
"enable": false,
// HTTP服务监听的 ip 地址,为空则监听所有地址
"host": "",
// http服务端口
"port": 3000,
// http上报密钥,可为空
"secret": "",
// 是否启用http心跳
"enableHeart": false,
// 是否启用http上报服务
"enablePost": false,
// http上报地址, 如["http://127.0.0.1:8080/onebot/v11/http"]
"postUrls": []
},
"ws": {
// 是否启用正向websocket服务
"enable": false,
// 正向websocket服务监听的 ip 地址,为空则监听所有地址
"host": "",
// 正向websocket服务端口
"port": 3001
},
"reverseWs": {
// 是否启用反向websocket服务
"enable": false,
// 反向websocket对接的地址, 如["ws://127.0.0.1:8080/onebot/v11/ws"]
"urls": []
},
"GroupLocalTime": {
"Record": false,//是否开启本地群聊时间记录
"RecordList": []//开启全部群 ["-1"] 单个群配置 ["11111"] 多个群 ["1","2","3"]
},
// 是否开启调试模式,开启后上报消息会携带一个raw字段,为原始消息内容
"debug": false,
// ws心跳间隔,单位毫秒
"heartInterval": 30000,
// 消息上报格式,array为消息组,string为cq码字符串
"messagePostFormat": "array",
// 是否将本地文件转换为URL,如果获取不到url则使用base64字段返回文件内容
"enableLocalFile2Url": true,
// 音乐签名URL,用于处理音乐相关请求
"musicSignUrl": "",
// 是否上报自己发送的消息
"reportSelfMessage": false,
// access_token,可以为空
"token": ""
}
修改方式如下
"reverseWs": {
"enable": true,
"urls": [
// Yunzai
"ws://127.0.0.1:8080/OneBotv11"
// Nonebot
"ws://127.0.0.1:8080/onebot/v11/ws"
]
},
ws链接参考llonebot
WARNING
请勿将注释内容写入配置文件,否则会导致配置文件解析失败。
配置 NapCat 其它设置(如果不懂干嘛,不用看啦)
启动登录 NapCat 后,打开NapCat的 config 目录,找到名为 napcat_<你的QQ号>.json 的文件,如 napcat_1234567.json。配置内容参数解释:
{
// 是否开启文件日志
"fileLog": true,
// 是否开启控制台日志
"consoleLog": true,
// 日志等级, 可选值: debug, info, error
"fileLogLevel": "debug",
"consoleLogLevel": "info"
}
语言、视频无法发送请点击这里
不会用请联系:1602833550(QQ/微信同号)