本文最后更新于 285 天前，其中的信息可能已经有所发展或是发生改变。

一、环境安装

1.更换仓库源

一直yes下去就好

bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/ChangeMirrors.sh)

2.安装node.js

curl -sL https://rpm.nodesource.com/setup_17.x | sudo bash -

sudo yum -y install gcc-c++ make nodejs

#查看nodejs版本

node -V

#查看npm版本

npm -V

3.安装git

sudo yum -y install https://packages.endpointdev.com/rhel/7/os/x86_64/endpoint-repo.x86_64.rpm 

sudo yum install -y git

#查看版本

git --version

4.安装chromium

yum -y install chromium

5.安装redis

yum -y install redis

6.安装中文字体

yum groupinstall fonts -y

二、安装喵崽本体

喵崽项目地址：https://gitee.com/yoimiya-kokomi/Miao-Yunzai

1.克隆项目

git clone --depth=1 https://gitee.com/yoimiya-kokomi/Miao-Yunzai.git
cd Miao-Yunzai 
git clone --depth=1 https://gitee.com/yoimiya-kokomi/miao-plugin.git ./plugins/miao-plugin/

2.安装依赖

npm --registry=https://registry.npmmirror.com install pnpm -g #安装pnpm

pnpm config set registry https://registry.npmmirror.com #更换国内源
pnpm install -P  #安装依赖

3.首次运行

node app

注意：首次运行需要输入QQ号和密码，Linux扫码需要在同一网络下，如果不具备该条件，请输入密码（密码会隐藏），如果提示版本低，请选择安卓手机登录

4.npm指令

npm start  #后台启动
npm stop  #后台关闭
node app  #前台启动
npm run login  #重新登录

三、插件安装

插件库项目地址：https://github.com/yhArcadia/Yunzai-Bot-plugins-index

四、部署过程中的问题

1.监听事件错误

Linux系统

1）去github下载napi-v6-linux-glibc-x64.tar.gz，解压后用文件夹内node_sqlite3.node替换Miao-Yunzai\node_modules.pnpm\sqlite3@5.1.6\node_modules\sqlite3\lib\binding\napi-v6-linux-glibc-x64目录下的node_sqlite3.node即可（或者在[蓝奏云密码:hong]下载，PS:是我下载好的，保存到蓝奏云了）

2）蓝奏云密码:hong，文件内有使用说明。

引用出处：https://api.gitee.com/yoimiya-kokomi/Miao-Yunzai/issues/I78VJY

2. 签名api异常

2.1 安装jdk1.8

yum install -y java-1.8.0-openjdk.x86_64

2.2 查询jdk版本

java -version

这样就安装成功了。
默认给安装到 usr/lib/jvm/

2.3 下载安装unidbg-fetch-qsign

项目源码地址：fuqiuluo/unidbg-fetch-qsign: 获取QQSign通过Unidbg (github.com)

蓝奏云下载地址：https://wwav.lanzoue.com/ishUO1567onc 密码:6vta

通过宝塔面板把文件上传到服务器root根目录下

2.4 检查一下你的端口有没有被占用

cd unidbg-fetch-qsign-1.1.9

默认端口：8080（记得去服务器开放端口)

netstat -lntp

2.5 启动unidbg-fetch-qsign

bash bin/unidbg-fetch-qsign --basePath=txlib/8.9.73

2.6 后台运行 & 自启动（screen）

流行的Linux发行版（例如Red Hat Enterprise Linux）通常会自带screen实用程序，如果没有的话，可以从GNU screen的官方网站下载

安装screen

yum install screen

查看版本

rpm -qa|grep screen

挂后台

cd unidbg-fetch-qsign-1.1.9

screen -S qsign

bash bin/unidbg-fetch-qsign --basePath=txlib/8.9.73

2.7 配置Miao-Yunzai

打开（Miao-Yunzai/Yunzai-Bot）\config\config\bot.yaml 在最底下添加 sign_api_addr: http://127.0.0.1:8080/sign?key=114514
打开（Miao-Yunzai/Yunzai-Bot）\config\config\qq.yaml 更改为协议1或2（ 1:安卓手机、 2:aPad）

2.8 签名api异常视频教程

QQ签名服务器Qsign的Linux搭建教程_哔哩哔哩bilibili