如何搭建一个QQ机器人【真寻机器人】#

目录#

安装go-cqhttp
安装Postgresql数据库
安装真寻bot
Linux下持久化运行(Windows用户请跳过)
安装使用WebUi(可选)

安装go-cqhttp #

什么是go-cqhttp#

go-cqhttp 是什么？使用OneBot协议实现的无头QQ，接受消息发往后端处理

你也可以理解为QQ客户端

如何安装go-cqhttp#

从Mrs4s / go-cqhttp (opens new window)的Release中下载与你系统对应的最新版本

由于github属于半墙状态，所以下载会比较慢，您可以选择耐心等待，也可以安装fastgithub(opens new window)来提升你的下载速度
将你下载好的文件存放到任意一个文件夹

Windows：

直接双击文件运行

点击确定后，使用安全启动脚本启动即可

Linux：

下载您对应的压缩包后使用tar -zxvf 文件名称.tar.gz

解压完毕后请检查此目录下是否存在名为go-cqhttp的文件

若并没有此文件请再次尝试以上步骤，若有此文件，请使用./go-cqhttp命令启动
首次运行会让你选择通信方式，选择 3 (反向 Websocket 通信)，会生成一个配置文件config.yml
打开config.yml文件，将uin修改为bot账号
在config.yml文件中将 universal: ws://your_websocket_universal.server 修改为 universal: ws://127.0.0.1:8080/onebot/v11/ws/
重启go-cqhttp后登录即可
因真寻机器人项目使用了语音文件等，该音频需要依赖ffmpeg
```
1
Ubuntu：
2
    sudo apt install -y ffmpeg
```
没有 ws-reverse 怎么办？第二步的配置文件选错了，删除config.yml重新生成即可

安装Postgresql数据库 #

Windows#

在Postgresql下载页面 (opens new window)下载对应系统的Postgresql安装程序
选择安装路径，一路next，中途会让你设置以下postgres用户的密码
在安装目录下找到pgAdmin，使用pgAdmin连接数据库，创建连接，新建数据库即可

Linux (以Ubuntu为例)#

安装Postgresql

1
 sudo apt update
2
 sudo apt install postgresql postgresql-contrib

创建数据库和用户

1
 sudo su - postgres  # 切换用户
2
 psql
3
       #  用户名↓                # 密码↓
4
 CREATE USER uname WITH PASSWORD 'zhenxun'; # 创建用户
5
         # 数据库名称↓       所有者↓
6
 CREATE DATABASE testdb OWNER uname;   # 创建数据库

到这一步数据库已经可以正常使用了！以下步骤主要用于外网可以连接入服务器数据库，可以等需要的时候再配置。

编辑数据库配置文件（路径请已自己的为准）
- 打开数据库配置文件
```
1
vim /etc/postgresql/12/main/postgresql.conf
```
- 找到 listen_addresses: ’*’ 取消前面的 # 注释，使用保存退出
  
  建议公网ip同时修改 Port
- 打开 pg_hba.conf
```
1
  vim /etc/postgresql/12/main/pg_hba.conf
```
- 在最下添加或修改后，使用保存退出
```
1
  # 允许任意用户从任意机器上以密码方式访问数据库
2
  host    all             all             0.0.0.0/0               md5
```
重启数据库
```
1
 sudo systemctl restart postgresql
```

安装真寻bot #

版本警告

真寻Bot需要python环境为 python3.8 或 python3.8

开始部署#

从 HibiKier / zhenxun_bot (opens new window)clone代码或直接下载压缩包 (opens new window)解压

安装依赖包

1
pip3 install poetry     # 使用poetry管理python包
2
poetry install          # 安装依赖
3

4
poetry shell            # 进入虚拟环境
5

6
## playwright 需要安装额外的系统环境，在命令行输入以下
7
playwright install chromium
8

9
# 该命令在win下无需输入
10
playwright install-deps chromium

设置超级用户，打开 .env.dev 文件，在SUPERUSERS中添加自己的QQ
```
1
SUPERUSERS=["123456789"]
```

打开 configs/config.py 填写数据库数据

1
# 数据库（必要）
2
# 如果填写了bind就不需要再填写后面的字段了#）
3
# 示例："bind": "postgresql://user:password@127.0.0.1:5432/database"
4
bind: str = ""  # 数据库连接链接
5
sql_name: str = "postgresql"
6
user: str = ""  # 数据用户名
7
password: str = ""  # 数据库密码
8
address: str = ""  # 数据库地址
9
port: str = ""  # 数据库端口
10
database: str = ""  # 数据库名称
11

12
############################################################
13
### 如果你是与教程一模一样的命令代码，且数据库也在该服务器上 ###
14
############################################################
15
# 可以直接复制以下配置
16
bind: str = ""  # 数据库连接链接
17
sql_name: str = "postgresql"
18
user: str = "uname"
19
password: str = "zhenxun"
20
address: str = "127.0.0.1"
21
port: str = "5432"
22
database: str = "testdb"

启动真寻，会在 configs 和 data/configs 目录下生成各种配置文件
```
1
python3 bot.py
2
# or
3
python bot.py
```
打开 configs/config.yaml，里面包含的是各种插件的配置项，填写完毕后重启真寻Bot

Linux下持久化运行 #

恭喜！经历困难之后到了最后一步，那就是持久化运行 0v<

本节教程为Linux持久化运行教程，Windows可直接跳过

教程中使用的是较为简单的Screen，如果你有其他工具的使用经验，可以跳过本节。

即刻开始（以Ubuntu为例）#

安装screen
```
1
sudo apt install screen
```
创建会话
```
1
screen -S zhenxun
```

进入真寻目录

1
cd 真寻的存放真寻机器人的目录

启动！

1
poetry shell    # 进入虚拟环境
2
python3 bot.py

如果退出或关闭后#

使用以下命令恢复会话
1
screen -r zhenxun

安装使用WebUi #

这一步并不是必须的！只是为了可视化方便管理，并且webUi也还未完善

因为真寻机器人的web项目直接使用vue run的，所以该教程也以vue run为主，其他方式如nginx可略过

别忘了打开服务器端口，默认是8081，修改端口在vue.config.js文件中！

开始安装#

安装nodejs#

略（百度很多教程，演示的环境是Nodejs14）

安装yarn#

1
npm install -g yarn

安装vue-cli#

1
yarn global add @vue/cli

获取项目#

点击 WebUi (opens new window)下载项目压缩包 or

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

如果比较慢的话可以尝试以下代码

1
git clone https://gitclone.com/github.com/HibiKier/zhenxun_bot_webui.git

安装依赖#

1
yarn

开始运行#

1
yarn run serve

配置账号密码#

在您的真寻bot存放目录/configs/config.yaml文件中配置项设置账号密码

1
web-ui:
2
  # web-ui
3
  # USERNAME: 前端管理用户名
4
  # PASSWORD: 前端管理密码
5
  USERNAME: admin
6
  PASSWORD:

必须要设置账号密码，否则无法登陆！

本文章是对原项目文档的补充和说明，有很多部分是转载的原文档，并非纯原创

原文档地址：https://hibikier.github.io/zhenxun_bot/docs/installation_doc/