前言

安装真寻bot，你需要具备：

• 一定的基础，包括但不限于稍微熟悉linux或windows cmd命令行
• 一台服务器，最好的linux系统，但Windows也不是不行
• 一些百度/Google的能力

此项目基于 Nonebot2 和 go-cqhttp 开发，以 postgresql 作为数据库的非常可爱的绪山真寻bot~~

真寻bot官网zhenxun_bot

github:https://github.com/HibiKier/zhenxun_bot

本教程引用于Sakura’s Blog

内容有所改动

注意事项

1. 保证系统的相同，环境的相同，是尽量减少麻烦的最有效的途径
2. 遇到麻烦先不要慌，先看看你是不是漏看了亿步
3. 实在解决不了，带上你的完整的报错，和自己所做过的行为去群里问问。QQ群：[ 是真寻酱哒 ]
4. 推荐系统: Ubuntu20.04 LTS

一、必要环境的安装

1.1 python环境的安装

​ 从最开始的纯净的Ubuntu20.04系统开始部署，Ubuntu20.04自带有python3.8.10所以避免了不太友好的python3.8或者python3.9的安装。当然，如果你是别的系统，也可以百度搜索 【{你的系统和版本}python3.8安装】。所以为了避免一系列因为系统不相同而导致的问题，推荐使用纯净的Ubuntu20.04系统部署真寻。

一些需要用的命令的安装：

sudo apt update && sudo apt install -y wget git screen ffmpeg

安装pip命令如下：

sudo apt update && sudo apt install -y python3-pip

新版真寻使用的poetry虚拟环境安装，所以需要安装poetry，安装命令如下：

sudo pip install poetry

1.2 PostgreSQL数据库的安装

​ 据了解 PostgreSQL 数据库的版本在9.0以上即可，版本的不同并不会对真寻的运行造成影响，所以这里使用的是PostgreSQL12，以下命令注意要一行一行运行.

PostgreSQL安装命令：

sudo apt update && sudo apt install -y postgresql postgresql-contrib

创建数据库和用户：

sudo su - postgres
psql
CREATE USER zhenxun WITH PASSWORD 'zxpassword';
CREATE DATABASE zhenxun OWNER zhenxun;
exit
exit

​ ps: exit命令需要运行两次来退出数据库

1.3 一些必要的依赖

真寻运行所需要的的系统相关依赖的安装：

sudo apt install -y \
    libgl1 \
    libglib2.0-0 \
    libnss3 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libxkbcommon0 \
    libxcomposite1 \
    libxrandr2 \
    libgbm1 \
    libgtk-3-0 \
    libasound2 

Ubuntu安装中文字体

sudo apt-get install -y ttf-wqy-zenhei ttf-wqy-microhei fonts-arphic-ukai fonts-arphic-uming
sudo fc-cache -f -v

二、go-cqhttp的安装

go-cqhttp 是什么？

使用OneBot协议实现的无头QQ，接受消息发往后端处理

2.1 下载go-cqhttp

• 下载go-cqhttp需要wget组件，如果没有可以运行

sudo apt install -y wget

安装命令如下

mkdir ~/go-cqhttp && \
	cd ~/go-cqhttp && \
	wget https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0-rc1/go-cqhttp_linux_amd64.tar.gz -O go-cqhttp_linux_amd64.tar.gz && \
	tar -zxvf go-cqhttp_linux_amd64.tar.gz

• 复制到命令行一键运行

2.2 修改相关配置

运行一次go-cqhttp

cd ~/go-cqhttp && echo -e "3\n" | ./go-cqhttp

之后输入命令修改配置

sudo sed -i 's/universal:.*/universal: ws://localhost:8080/onebot/v11/ws/g' config.yml

2.3 go-cqhttp的持久化运行

• 持久化运行go-cqhttp，推荐使用screen，方便管理适合新手，screen的安装命令：

sudo apt install -y screen

安装完成以后创建screen并进入：

screen -S go-cqhttp 

在重新出现的shell界面，运行go-cqhttp并扫描二维码登陆bot的qq，待命：

cd ~/go-cqhttp && echo -e "3\n" | ./go-cqhttp -faststart

再出现二维码以后，扫码登陆(注意这里需要你的IP和服务器IP所在地一直，否则会风控登录不上)

之后出现以下信息为正常登陆成功，然后使用 Ctrl + A + D 组合键退出screen

至此，go-cqhttp的部署完成了，接下来便是真寻本体的部署

---

三、zhenxun_bot的部署

这也是最容易出错的一步

3.1 下载zhenxun_bot源码

• 使用git命令下载真寻源码，如果没有安装git需要运行：

sudo apt install -y git

git clone真寻源码：

cd && git clone https://ghproxy.com/github.com/HibiKier/zhenxun_bot.git

3.2 修改相关配置

• 修改bot管理员账号，将你自己的qq账号改成你希望用来管理你bot的qq：
  

cd ~/zhenxun_bot && sed -i 's/SUPERUSERS.*/SUPERUSERS=["你自己的qq账号"]/g' .env.dev

修改数据库连接命令，如果你没对上面数据库的创建命令作出修改直接运行以下命令：

sed -i 's|bind.*|bind: str = "postgresql://zhenxun:zxpassword@localhost:5432/zhenxun"|g' configs/config.py

3.3 虚拟环境的配置

有很多人的问题都是出在了这里，这是不可缺少的一环

首先，你得进入虚拟环境：

cd ~/zhenxun_bot && poetry shell

之后便是真寻的相关依赖的安装，使用命令：

poetry install

如果是国内机器，不更换pip的源的话会感觉非常的慢，所以在依赖安装之前可以更换pip源:

sudo pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

Playwright浏览器的安装：

playwright install chromium

如果不想启动后下载一大堆资源，可以执行以下命令，下载相关资源

SOURCE_URL=https://pan.yropo.top/source/zhenxun/
wget ${SOURCE_URL}data_draw_card.tar.gz -qO ~/.cache/data_draw_card.tar.gz \
    && wget ${SOURCE_URL}img_draw_card.tar.gz -qO ~/.cache/img_draw_card.tar.gz \
    && tar -zxvf ~/.cache/data_draw_card.tar.gz -C ~/zhenxun_bot/ \
    && tar -zxvf ~/.cache/img_draw_card.tar.gz -C ~/zhenxun_bot/ \
    && rm -rf ~/.cache/*.tar.gz

至此，真寻的所有的环境都已经配置完毕，就差最后一步的启动了

3.4 启动zhenxun_bot

再次强调一遍，启动真寻之前确定你进入了虚拟环境，有关虚拟环境的进入看3.3

 

当然，启动之前我们得让真寻一直跑着，所以我们需要用到screen来让真寻持久化运行

screen -S zhenxun

然后先进入虚拟环境，再运行真寻：

cd ~/zhenxun_bot && poetry shell
cd ~/zhenxun_bot && python3 bot.py

 

3.5 管理相关

真寻的安装目录位于 ~/zhenxun_bot 下

go-cqhttp的安装目录位于 ~/go-cqhttp 下

进入真寻的screen界面命令：

screen -r zhenxun

进入go-cqhttp界面的命令：

screen -r go-cqhttp

• • 使用 Ctrl + A + D退出 screen
  • 使用 screen -r name -X quit 结束 screen

好了，现在你可爱的真寻酱已经跑起来了！快去玩玩吧~

四、可视化Webui的部署

4.1安装nodejs

在您的 Ubuntu Linux 上运行 apt update 命令以更新软件包存储库内容数据库。

sudo apt update

系统更新后，首先安装所需的存储库

curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -

添加存储库后，您可以开始在 Ubuntu Linux 上安装 Node.js 14：

sudo apt -y install nodejs

验证安装的 Node.js 版本

$ node  -v
v14.19.1

安装成功

配置账号密码

在configs/config.yaml文件中配置项设置账号密码

cd zhenxun_bot/configs
vim config.yaml

找到下方内容，进行修改

web-ui:
  # web-ui
  # USERNAME: 前端管理用户名
  # PASSWORD: 前端管理密码
  USERNAME: admin
  PASSWORD: 

 

4.2安装yarn

npm install -g yarn

4.3安装vue-cli

yarn global add @vue/cli

4.4获取项目

git clone https://github.com/HibiKier/zhenxun_bot_webui.gita

进入目录

cd zhenxun_bot_webui

安装依赖

yarn

创建持久化运行

screen -S zhenxunwebui

运行

yarn run serve

使用 Ctrl + A + D退出 screen

至此WebUi已经可以使用了，IP:8081打开即可

默认是8081，修改端口在zhenxun_bot_webui/vue.config.js文件中