前言
文档地址:主页 | LittlePaimon (cherishmoon.fun)
项目地址:CMHopeSunshine/LittlePaimon: 小派蒙!
请大家多多支持原作者哦!
作者文档已经对LittlePaimon的安装和使用进行了详细的描述,夜梦这里就简单复述一下在具有公网IP的Linux服务器上搭建的方法。
PS:强烈建议使用拥有公网IP的服务器进行搭建!由于存在风控,你几乎必须同步搭建QSIGN签名服务器!
1.环境准备
通过一段时间的实际使用,夜梦发现2G运行内存就足以满足小派蒙的运行(除了生成地图功能)。实际占用存储在2G左右。
对CPU和带宽的要求很低,基本1核1M就能满足要求.
系统强烈推荐纯净的ubuntu 22.04 / 22.04
2.安装
依次执行以下命令:
sudo -i # 获取root权限,如果本来就以root权限登录,那可以跳过
apt update -y
apt upgrade -y
apt install pipx # 安装pipx
pipx ensurepath # 把pipx添加到环境变量
apt-get update --fix-missing
apt install pipx -y
建立一个存放小派蒙的目录:
mkdir ys
cd ys
依次执行以下命令:
pipx install nb-cli # 安装nonebot脚手架
nb self install nb-cli-plugin-littlepaimon # 安装小派蒙脚手架插件
nb paimon create # 创建小派蒙项目
在运行nb paimon create
后,脚手架会一步步指引安装,以下为可能出现的选项:
- 项目名称:你想要存放的小派蒙文件夹名,默认为
LittlePaimon
- 克隆源:推荐默认,如果下载失败可尝试其他源
- 超级用户QQ号:相当于机器人的管理员,填写你自己的QQ号
- 立刻安装依赖:请选择是(Y),即直接回车
- 创建虚拟环境:如果您没有其他Python开发需求的话,可以选否(N),如果有,请选是(Y)
- go-cqhttp安装和使用方式:该怎么选,详见下方关于go-cqhttp
在创建完成后,继续运行以下命令:
cd LittlePaimon # LittlePaimon为你刚刚填写的项目目录名
nb paimon res # 给出的两次选择均保持默认(回车两次)
nb paimon run playwright install chromium --with-deps # 安装playwright相关依赖
此后,你只需要在派蒙的目录下使用命令nb paimon run
即可启动小派蒙Bot,并根据你选择的go-cqhttp
方式,启动并登录机器人账号。
3.关于go-cqhttp
go-cqhttp
是一个无头QQ客户端,负责与小派蒙交互,进行消息的收发。
因为云服务器具有公网IP,所以此处我们使用 nonebot-plugin-gocqhttp
插件,该插件会以子进程调用的方式让go-cqhttp
和小派蒙一起运行。
如果选择了该方式,请在启动小派蒙后,在浏览器访问链接http://yourIP:13579/go-cqhttp
该链接为插件提供的网页控制台,在控制台中添加bot账号,添加完成后需重启小派蒙,然后根据gocq的指引进行账号登录验证。
登录成功后,以后启动就不需要再登录了。
如果你在登录的时候遇到了code45报错,那你就一定要部署自己的签名服务器!具体请参考:使用qsign解决gocq启动code45报错
4.后台运行
推荐使用tmux
命令来管理后台运行。
在小派蒙所在目录,使用tmux来后台运行小派蒙:
tmux new -s paimon nb paimon run
运行后,会新开一个终端窗口来运行派蒙,按 Ctrl+B D
即可让它退到后台。
使用以下命令即可让它重新回到前台:
tmux a -t paimon
5.账号登录不上的解决方法
如果在云服务器上登录qq时有类似有风险,请使用同一网络
、验证失败
、账号被冻结或密码错误
等提示而登录不上, 可以先在你的本地电脑下载go-cqhttp,登录同一账号,登录成功后,将device.json
和session.token
这两个文件上传到云服务器,替换掉云服务器上的同名文件,再次启动bot即可。
夜梦的方法是:挂一会QQ,开启登录安全登录检查,在登陆的时候会提示发送短信验证码,利用验证码即可顺利登录。
其他安装方法、操作,以及小派蒙的功能请参考作者文档:主页 | LittlePaimon (cherishmoon.fun)
6.关于{“detail”:”Not Found”}
那是因为你访问了yourIP:13579
而非http://yourIP:13579/go-cqhttp
。只需要访问yourIP:13579/go-cqhttp
即可
7.WEBUI
网页控制台的默认地址为127.0.0.1:13579/LittlePaimon/admin/
(登录页在127.0.0.1:13579/LittlePaimon/login/
)
默认账号为超级用户的QQ号
,密码为admin
请务必在控制台中修改默认密码以及加密所使用的密钥!!!