Miao-Yunzai搭建

如愿2024-11-072025-04-23

注意！本页面搭建仅供参考，你可以分享给身边的朋友，但请勿发布在各大流量平台以及评论留言！😜

Miao-Yunzai部署教程

2025年啦孩子，怎么还在坚持玩崽啊（

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

想看windows教程了话点击这里吧

准备工作

准备一台Ubuntu2204或者Debian12的服务器/家里云（不要使用centos！！别问为什么），准备一个QQ小号，建议具备扫脸条件，因为你永远不知道鹅厂会整出什么花样.

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

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

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

不会装？简单，两行解决

1
2
3

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

安装node

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

安装node过程

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

版本不符合图片是没有关系的，只要你有大于20的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安装容器化数据库，备份啥的也方便（记得开启容器外部访问）

容器redis

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

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包管理工具

1
2
3

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

安装pnpm

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

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

安装yunzai

随后安装依赖

1 2	# pnpm config的意思是，将获取依赖源转为淘宝源，加快依赖安装速度 pnpm config set registry https://registry.npmmirror.com && pnpm install -P

安装依赖

全程无报错算安装成功

4.启动

1 2	node app # 然后根据它的提示进行设置账号

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

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

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

数据库密码

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

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

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

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

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

ICQQ0.6.10目前仅支持最高9.0.17的QQ版本，需要通过脚本添加协议版本（来源于qsign.icu）

1 2	# 请在根目录执行！！ bash <(curl -sSLk Gitee.com/haanxuan/QSign/raw/main/X)

以上提供的签名脚本等禁止任何以任何视频平台（如bilibili）以及评论等形式外传！！！

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

对机器人发个#重启即可

当然你的🐔🐔人封号刚解需要上终端解冻要用node app

# 进入根目录
cd Miao-Yunzai
# 后台查看日志
npm run log
# 后台启动
npm run start
# 后台停止
npm run stop

npm指令

3.如何去安装插件？

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

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

小插件js需要你手动下载源码到根目录/plugins/example下，记得重启.

我也提供了一些插件也可以来瞅瞅

国内仓库

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：喵喵的排行，包括群员列表那些

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

还是有问题？真拿你没办法呢，主页有我的QQ，也可以进群找我我可以免费帮搭

请带上你的截图，不要用你那破手机给拍照拍下来，windows有截图为什么不用.jpg