使用 1Panel 部署基于 Koishi + Napcat 的QQ机器人(原创)

本文我也发在我刚新建没多久的博客上 bronya-zaychik.cn/archives/Koishi.html,各位佬友有闲心可以来逛逛呀! :tieba_002:

经过我捣鼓好几天,这绝对是全网最简单部署QQ机器人的方式,全程使用可视化面板,不需要运行任何命令! :tieba_024:

首先本教程的环境基于 1Panel,如果没有装 1Panel,建议先去装一个,因为真的很好用!

操作步骤

安装 Koishi

此处只写 1Panel 的安装方式,就不写终端命令的方式了(问就是懒)

1Panel 安装 Koishi 很简单,直接在 1Panel 应用商店搜索安装就可以,如果没有装 MySQL,会提示先安装 MySQL,同样也是在应用商店一键安装,可以调整用户和密码,其他不用动,Koishi 安装记得勾选上 端口外部访问 ! MySQL 可以不用,因为不会从外部访问 MySQL

Koishi 默认安装在 5140 端口,安装好之后可以使用 ip:5140 访问 Koishi

部署 Napcat-docker

Napcat-docker 是 Napcat 基于 Docker 容器的版本,旨在简化 NapCat 应用的部署和管理。

使用 1Panel 部署需要修改的配置如下图所示,在镜像处手动输入 mlikiowa/napcat-docker:latest 以及重启规则那里选择一直重启,其他设置如图即可

成功运行之后查看一下 Docker 日志,在日志中会有 Token,记录一下,后续使用 Napcat WebUI 登录需要用到这个 Token

部署 Napcat WebUI

我个人来说不喜欢命令行操作,因此我倾向于部署一个可视化的 Napcat WebUI 来方便登录和管理账号

该 WebUI 可以使用 Vercel 一键部署,然后绑定自己的域名

步骤如下:

  1. 将此仓库进行 Fork
  2. Vercel 上创建新项目
  3. 导入已 Fork 的仓库
  4. 配置项目设置
    • 将构建命令修改为 npm run webui:build
    • 编辑您的自定义域名
  5. 部署项目

部署之后访问,能看到以下的面板就是部署成功了

使用 Napcat WebUI 登录 QQ 账号并管理

在 WebUI 的登录界面输入你的 IP:6099 以及之前记录的 Token,点击登录,如果无法成功登录就是浏览器阻止了请求,去地址栏看看拦截的请求,同意请求,就能进入管理界面了

网络配置 栏选择新建 Websocket 客户端 填写如下配置,Token 随意填,用于 Koishi 验证,填写完了点击保存

使用 Koishi adapter-onebot 插件连接

前往 ip:5140,进入 Koishi 管理面板,左侧边栏选择依赖管理,右上角更新全部依赖。刷新网页之后再次进入,左侧边栏选择插件市场,进入搜索下载 adapter-onebot 插件,点击安装。安装完成之后点击配置,配置如下,selfId 填你在 Napcat 登录的QQ账号,token 是上一步自定义的 Token,用于验证的

验证连接

连接完成之后,前往沙盒(左侧边栏点击沙盒)验证一下链接是否成功

添加一个用户,然后发送 help 到沙盒,如果机器人成功返回消息,则连接成功!

配置登录验证(可选)

前往 插件配置分组:consoleauth 插件,配置账号密码,右上角点击启用,就可以开启登陆验证了。开启登陆验证之后能避免别人直接访问你的 Koishi 面板,盗用 API KEY 等隐私信息。

接下来就是自己去插件市场下载想用的插件就可以啦~

大模型聊天插件的话我推荐 chatluna,功能极多!

以上!

有什么疑问尽管在评论区提问哦 :tieba_024: 我懂的话尽量解答

42 个赞

看完了,感谢分享,有时间试试tieba_013

4 个赞

过两天放假玩玩

4 个赞

太强了!大佬

3 个赞

大水哥又看到你了 :tieba_020:

3 个赞

这个会封号么

2 个赞

富婆 有实力的

2 个赞

目前是qq加ql会封 这个目前没啥事

1 个赞

我是爷们,而且我是穷逼 :tieba_087:

1 个赞

好的,用小号测试一下

不信 不发照片默认妹妹小南梁 谁家爷们用这种头像:rage:

二次元的事情你别管 :tieba_006:

不信:rage::rage:

学习了,感谢分享

1 个赞

暂时没啥事,偶尔遇到封了的,也不是永封,验证一下就能解,反正建议用小号

可惜用的是宝塔呀

宝塔应该差不多吧 :bili_045:,没用过


差不多的

参见鸭鸭 :tieba_087:

1 个赞

提醒一下,注意配置 auth 插件 否则所有人都可以访问你的koishi面板 看到不限于你的聊天记录 api密钥等隐私信息

3 个赞