注意！本页面搭建仅供参考我的个人搭建方法，你可以分享给身边的朋友，但请勿发布在各大流量平台以及评论留言！😜
此教程已过时，喵崽目前已很久未维护，建议移步教程至TRSS-Yunzai教程
Miao-Yunzai部署教程
这是一款基于原神QQ机器人但不仅限于原神的机器人部署教程，以下教程说的环境均为linux环境
你需要准备什么？
准备一台Ubuntu2204或者Debian12的服务器/家里云（不要使用centos！！别问为什么），准备一个QQ小号，建议具备扫脸条件，会有随时封号的风险
确保自己的机子有root用户去执行防止出现权限不够等问题
一个清醒的🧠
那么就开始咯！（注意本教程说的根目录均为Miao-Yunzai目录下！！）
1.更新系统软件包及所需依赖
由于Ubuntu/Debian自带Git，只需要更新软件包即可
1
2
3
4
|
sudo apt update && apt list --upgradable && apt upgrade -y && apt autoremove -y
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环境即可
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
npm --registry=https://registry.npmmirror.com install pnpm -g
|
3.安装喵崽
根据服务器所在地
选择Gitee源（国内）和GitHub源（国外）
1
2
3
4
5
6
7
8
9
10
11
|
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/
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/
|
随后安装依赖
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.启动
根据提示来到提示登录设备的时候，选择aPad协议登入
后续可通过CTRL+C直接退出终端进程
如果你是使用的1panel安装的redis-server记得去根目录/config/config/redis.yaml填写你的密码
为什么要这么晚说呢，因为redis.yaml是在你第一次启动后才创建后的文件，你也可以去根目录/config/default_config下的redis.yaml复制一份到根目录/config/config下并进行填写
常见问题？(建议看看~)
1.签名怎么填？报错45无法登录？
可以选择蹭别人的签名或者自建
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
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） 提供了米家扫码登录支持以方便 查询体力/深渊
]]>
