Miao-Yunzai部署教程

一款基于原神QQ机器人但不仅限于原神的机器人部署教程，以下教程说的环境均为linux环境

[blockquote1 name=’刻晴Bot’]你需要准备什么？

1.准备一台Ubuntu2204或者Debian12的服务器/家里云（不要使用centos！！别问为什么）

2.准备一个QQ小号，建议具备扫脸条件，会有随时封号的风险

3.确保自己的机子有root用户去执行防止出现权限不够等问题

4.一个清醒的?

那么就开始咯！（注意本教程说的根目录均为Miao-Yunzai目录下！！）[/blockquote1]

1.更新系统软件包及所需依赖

由于Ubuntu/Debian自带Git，只需要更新软件包即可

一般的服务器(像腾讯云/阿里云那种)基础软件完整，只需要以下指令即可

sudo apt update && apt list --upgradable && apt upgrade -y && apt autoremove -y

 

如果你是本地vmware虚拟机非gui界面，需要使用以下指令安装基础软件包再更新

sudo apt update && apt list --upgradable && apt upgrade -y && apt autoremove -y && apt install git vim sudo curl ffmpeg screen unzip zip g+ + libsqlite3-dev python-is-python3 -y

 

2.安装linux的node.js

不会装？简单，两行解决

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

 

执行完后安装

sudo apt install nodejs -y

 

出现successfully则为获取安装包成功，可执行下一步~

检查是否安装成功（可选）

版本不符合图片是没有关系的，只要你有大于等于18的node环境即可

node -v 
npm

 

3.安装所需软件包

1.安装ffmpeg转码工具（解决部分插件的转码失败问题）

sudo apt install ffmpeg -y

 

2.为系统安装chromium浏览器（个人喜好）

这样装是为了跳过pnpm自动安装浏览器

sudo apt install chromium -y

 

3.安装redis-server（机器人所需要的数据库）

sudo apt install redis-server -y

 

当然也可以选择1panel安装容器化数据库，备份啥的也方便（记得开启容器外部访问）

由于默认国外源的原因安装失败记得去配置镜像源

https://docker.1panel.live

4.安装文泉驿正黑体

解决土块插件(earth-k-plugin)及绘图插件(ap-plugin)乱码问题

二选一即可

sudo apt install ttf-wqy-zenhei -y

 

sudo apt install fonts-wqy-microhei -y

 

刷新字体缓存

sudo fc-cache -fv

 

当然如果你有其他好看的字体也可以不用参考这个教程的字体~

出现succeeded即安装成功

5.安装pnpm包管理工具

npm install pnpm -g

 

若安装pnpm缓慢推荐指定国内阿里云镜像源安装，海外服务器则不需要换源安装

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

 

3.安装喵崽

根据服务器所在地

选择Gitee源（国内）和GitHub源（国外）

使用 Github

git clone --depth=1 https://github.com/yoimiya-kokomi/Miao-Yunzai.git 
# 进入喵崽目录 
cd Miao-Yunzai 
git clone --depth=1 https://github.com/yoimiya-kokomi/miao-plugin.git ./plugins/miao-plugin/

 

使用Gitee

git clone --depth=1 https://gitee.com/yoimiya-kokomi/Miao-Yunzai.git 
# 进入喵目录 
cd Miao-Yunzai 
git clone --depth=1 https://gitcode.com/TimeRainStarSky/miao-plugin.git ./plugins/miao-plugin/

 

随后安装依赖

更换淘宝源加快依赖安装

pnpm config set registry https://registry.npmmirror.com && pnpm install -P

 

全程无报错算安装成功

4.添加协议端补丁

由于ICQQ0.6.10协议版本只包含了9.0.17的QQ版本，现如今的QQ版本都需要9.1.25+，所以需要添加协议版本

在根目录运行

bash curl -sL Gitee.com/haanxuan/QSign/raw/main/ver | bash

 

5.启动

node app

 

然后根据它的提示进行设置账号

根据提示来到提示登录设备的时候，选择aPad协议登入

后续可通过CTRL+C直接退出终端进程

如果你是使用的1panel安装的redis-server记得去根目录/config/config/redis.yaml填写你的密码

为什么要这么晚说呢，因为redis.yaml是在你第一次启动后才创建后的文件，你也可以去根目录/config/default_config下的redis.yaml复制一份到根目录/config/config下并进行填写

常见问题？(建议看看~)

1.签名怎么填？报错45无法登录？

可以选择蹭别人的签名 或者自建

自建项目地址（不推荐自建！！）：油腻的霸哥与企鹅的爱情故事

为了保证作者的人身氨醛由于故意留了些检测，使用该签名将会被腾讯精准检测，具体表现是：首次使用4小时内出现冻结，每15天扫脸解封一次

2.关终端了无法让他在后台运行，怎么让它运行保持在后台？

对机器人发个#重启即可当然你的??人封号刚解需要上终端解冻要用

node app

前台运行才能进行操作

进入根目录

cd Miao-Yunzai

 

后台查看日志

npm run log

 

后台启动

npm run start

 

后台停止

npm run stop

 

3.如何去安装插件？

去索引库寻找插件自行安装或是自己写

一般来说，大插件作者会给安装指令和依赖指令，根目录安装后启动即可

小插件js需要你手动下载源码到根目录/plugins/example下，一般都需要重启，防止出现一些bug

国内仓库

Yunzai-Bot-plugins-index: Yunzai-Bot相关内容收集库 (gitee.com)

国外仓库

https://github.com/yhArcadia/Yunzai-Bot-plugins-index

4.服务器要转移了，如何备份文件？

linux使用apt安装redis-server后，会在/var/lib/redis/这个目录下生成一个dump.rdb文件，下载下来即可(1panel用户看前面)，还有就是喵崽的根目录config文件夹，data文件夹，resource文件夹，装了逍遥(xiaoyao-cvs-plugin)的data文件夹，根目录/plugin/example文件夹或者按需备份你的各种大插件的config文件夹.

Q：那个dump.rdb文件有什么用呢？

A：喵喵的排行，包括群员列表那些

当然整个崽文件压缩打包下来也是可以的，如果觉得太大了，可以把依赖文件夹全部删了（node_modules）

5.安装了锅巴（Guoba-Plugin）无法访问？

检查服务器防火墙放开端口50831（即锅巴默认启动端口），你是哪家云就上哪家云的管理后台。部分云可能存在50831端口放开也无法访问的情况（比如华为云）

改锅巴配置文件下的config/application.yaml为80端口

箭头下一行有一个“是否需要拼接端口号”记得要改false为true

6.图床链接无法访问问题，如「#添加表情」无法添加

新NT图床链接问题，加上ICQQ已不再更新，需要去改新图链，记得重启！

curl -# https://img.kookapp.cn/attachments/2024-09/11/66e0f2f7c93f4 -o node_modules/icqq/lib/message/parser.js

 

备用链接

curl -# https://h.winterqkl.cn/ICQQ/parser.js -o node_modules/icqq/lib/message/parser.js

 

7.我需要更改登入版本/签名，无法打开验证码，怎么改？

在崽的根目录有一个config/config/bot.yaml，打开来，翻到最下面：

注意yaml文件的格式冒号后面接一个空格

sign_api_addr: 改成你需要的签名

ver: 改成你需要的版本

比如
ver: 9.1.25

后来那个抱脸验证码链接寄了，需要更换下（必做）

slider_ticket_addr: https://GT.928100.xyz/captcha/slider

 

常用插件？

喵喵插件（miao-plugin） 不多说，喵崽不装会报错，且是米家用户最需要的东西

梁氏插件（liangshi-calc） 主要提供喵喵面板伤害计算拓展，比原喵喵插件的伤害计算丰富

图鉴 (Atlas) 提供 原铁绝 三游戏的图鉴查询功能

锅巴插件 (Guoba-Plugin) 提供喵喵帮助自定义修改、各大插件的配置的云崽网页后端管理

椰奶插件（yenai-plugin） 提供便携群管功能

土块插件（earth-k-plugin） 提供各种娱乐功能（表情包制作、点歌、解析b站视频、画图、猜角色等功能）

逍遥插件（xiaoyao-cvs-plugin） 提供了米家扫码登录支持以方便 查询体力/深渊