前言

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

一键安装脚本

直接参照该页面的一键脚本运行即可：

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

按照提示安装即可，最后询问是否安装cli，个人建议安装。

安装完成后输入指令napcat start 帐号即可运行。

使用WebUI配置

参照官方文档：

如果你已经启动了 NapCat, 并且有多于 1 个开放端口，则可以通过 WebUI 进行配置.

默认地址为 0.0.0.0, 即监听所有地址. 当配置了不可用的地址时 WebUI 将被禁用.

默认端口为 6099.

当端口被设置为 0 时将禁用 WebUI.

当端口被占用时, 会自动对端口 +1, 直到找到可用端口 (最多尝试 100 次, 失败则会禁用 WebUI), 端口号会在启动日志中显示.

启动后可在启动日志中看到形如 [WebUi] WebUi Local Panel Url: http://127.0.0.1:6099/webui?token=xxxx 的 token 信息.

也可打开 webui.json 文件，在其中找到token。(使用 NapCat.Installer - Linux 一键脚本安装时, 该文件位于 /opt/QQ/resources/app/app_launcher/napcat/config/webui.json)

{
    "host": "0.0.0.0", // WebUI 监听地址
    "port": 6099, // WebUI 端口
    "token": "xxxx", // 登录密钥, 默认是自动生成的随机登录密码
    "loginRate": 3, // 每分钟登录次数限制
}

访问 http://ip:port/webui/，然后进行操作.

安装守护进程

由于未知原因，NapCat的服务可能会被终止，我们可以使用守护进程来保护它持续运行。

安装supervisor

apt-get update
apt-get install supervisor

增加配置文件

在目录/etc/supervisor/conf.d/下增加文件napcat.conf 。

文件内容为：

[program:napcat]
user=root
command=napcat start 123456789
directory=/www/nonebot2/lolbot
autostart=true
autorestart=true
startsecs=0

其中123456789换成你的bot帐号，directory地址任意填写，因为这个指令跟运行目录没关系。

startsecs参数的作用

• 默认值：startsecs=1（默认等待 1 秒后才认为进程启动成功）。

• 功能：定义 Supervisor 在启动进程后等待多少秒，才认为进程处于“正常运行”状态。

• 关键规则：

  • 如果进程在 startsecs 时间内退出，Supervisor 会认为启动失败（触发重启）。

  • 如果进程在 startsecs 时间内保持运行，Supervisor 会标记为启动成功。

由于NapCat启动非常迅速，所以设为0即可。

添加开机启动

systemctl enable supervisor

更新配置

supervisorctl update #加载新的配置

启动

supervisorctl start all

常用命令

supervisorctl shutdown #关闭所有任务
supervisorctl stop|start program_name #关闭指定任务
supervisorctl status #查看所有任务状态
supervisorctl update #加载新的配置
supervisorctl reload #重启所有任务