Miao-Yunzai部署教程

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

你需要准备什么？

1. 准备一台Ubuntu2204或者Debian12的服务器/家里云（不要使用centos！！别问为什么），准备一个QQ小号，建议具备扫脸条件，会有随时封号的风险

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

3. 一个清醒的🧠

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

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

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

1
2
3
4
5
6

# 一般的服务器(像腾讯云/阿里云那种)基础软件完整，只需要以下指令即可
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

不会装？简单，两行解决

1
2
3

sudo curl -sL https://deb.nodesource.com/setup_24.x | sudo -E bash -
# 执行完后安装
sudo apt install nodejs -y

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

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

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

1
2

node -v
npm

3.安装所需软件包

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

1

sudo apt install ffmpeg -y

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

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

1

sudo apt install chromium -y

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

1

sudo apt install redis-server -y

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

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

https://docker.1panel.live

4.安装文泉驿正黑体

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

1
2
3
4
5

sudo apt install ttf-wqy-zenhei -y
# 二选一即可
sudo apt install fonts-wqy-microhei -y
# 刷新字体缓存
sudo fc-cache -fv

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

出现succeeded即安装成功

5.安装pnpm包管理工具

1
2
3

npm install pnpm -g
# 若安装pnpm缓慢推荐指定国内阿里云镜像源安装，海外服务器则不需要换源安装
npm --registry=https://registry.npmmirror.com install pnpm -g

3.安装喵崽

根据服务器所在地

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

1
2
3
4
5
6
7
8
9
10
11

# 使用 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://gitee.com/yoimiya-kokomi/miao-plugin.git ./plugins/miao-plugin/

近期提醒：受Gitee影响，Gitee源的miao-plugin无法克隆下来（报403）这边需要换Github源才能使用，如果克隆不下来参考下常用镜像站合集

随后安装依赖

1
2

# 更换淘宝源加快依赖安装
pnpm config set registry https://registry.npmmirror.com && pnpm install -P

全程无报错算安装成功

4.添加协议端补丁

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

1
2
3

# 在根目录运行
# 感谢大佬提供的补丁，这里我就不说是谁了（）
bash curl -sL Gitee.com/haanxuan/QSign/raw/main/ver | bash

5.启动

1
2

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前台运行才能进行操作

1
2
3
4
5
6
7
8

# 进入根目录
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已不再更新，需要去改新图链，记得重启！

1
2
3
4

# 别的群友提供
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文件的格式冒号后面接一个空格

1

sign_api_addr: 改成你需要的签名

1
2
3

ver: 改成你需要的版本
# 比如
ver: 9.1.25

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

1

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） 提供了米家扫码登录支持以方便 查询体力/深渊