# Yunzai教学 **Repository Path**: lzqmql/yunzai-teaching ## Basic Information - **Project Name**: Yunzai教学 - **Description**: 由岩王帝君提供的Win-Linux系统搭建TRSS-Yunzai教学，简单方便易懂 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 1 - **Created**: 2025-02-19 - **Last Updated**: 2025-08-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ****TRSS-Yunzai-QQ机器人搭建教程**** - ### **本仓库提供基础机器人搭建教学** - ### **教学软件都在仓库文件内下载即可** - ### **有任何问题提交lssues等待即可** - ### **源码来源于各路大神非本人制作** 环境资源下载站:http://win.fufuidc.cn:5244/ (仅支持IPV6访问) ### PS：win系统简单易操作，需要性能否则会卡顿，Linux系统吃技术，机器人不建议本地搭建，机器人后台需要长期运行机器人才可使用所以电脑不能关机，建议[购买挂机宝或云服务器](https://fufuidc.com/cart)搭建，本教程只讲述手动搭建不讲述脚本搭建，因为Linux需要Docker但国内已无法访问，Win使用脚本需要大量性能和资源所以建议手动安装【需准备1.云电脑 2.QQ机器人账号 3.连接器软件 4.一颗求知的心 5.一个脑子】 # 1. ****Win系统搭建-TRSS-Yunzai-教学**** - ### **A. 在你的磁盘里创建一个专属机器人的目录【建议纯英文】后下载本仓库安装包到这个目录并解压** - ### **B. 找到Git目录按照提示安装【建议将Git自定义安装到本文件里的GIT目录方便删除及其调整】** ![示例](image.png) - ### **C. 找到nodeJS目录双击v20的版本按照提示安装【建议将nodeJS自定义安装到本文件里的nodeJS目录方便删除及其调整】【勾选后点击Next继续】** ![示例](image2.png) - ### **D. 找到Redis目录的redis-server.exe双击启动【PS：启动机器人时和启动后千万不要关闭否则机器人将报错断开】** ![示例](image3.png) - ### **E. 以上环境安装完成开始拉取仓库代码搭建-在你的专属目录鼠标右键会出现Git Bash 点击进入弹窗** ![示例](image4.png) - ### **F. 在窗口内输入以下拉取源码指令并回车** ``` git clone --depth 1 https://gitee.com/TimeRainStarSky/Yunzai ``` ![示例](image5.png) - ### **G. 在提示下载完这个后在控制台输入指令进入机器人目录cd /你的目录/Yunzai【请输入正确不然无法进入】** ![示例](image6.png) - ### **H. 这样就是进入机器人目录成功，然后输入指令安装pnpm和依赖** ``` npm i -g pnpm pnpm i ``` ![示例](image7.png)![输入图片说明](image8.png) - ### **I. 这样依赖就安装成功了，恭喜你迈入Yunzai领域，在控制台输入 【node app】 启动机器人！** ![示例](image9.png) - ### **J. 启动成功！开始安装功能！在机器人启动状态下先按顺序输入以下指令，系统会自动操作下载然后重启，请等待~【genshin】是必须安装的，首次安装会出现报错不用管，把【miao】安装了就好了** ``` #安装genshin #安装miao-plugin ``` ![示例](image10.png) - ### **K. 基础插件已安装成功，现在开始接入QQ账号，本教程为基础教程仅展示基础ICQQ链接器连接QQ使用机器人，请输入以下指令。【QQBOT】连接请看进阶教程** ``` #安装ICQQ-Plugin ``` - ### **L. ICQQ需要签名进行登陆，本教程提供了五个签名可提供使用，其他公共签名请自行查找。在安装完适配器后请输入以下指令并重启【Ctrl+C】重启后使用启动指令** ``` 1:#QQ签名https://api.yunzaibot.cn/?key=0852369&ver=9.1.35 2:#QQ签名https://api.furinaa.net/?key=0852369&ver=9.1.35 3:#QQ签名https://api4.furinaa.net/?key=0852369&ver=9.1.35 4:#QQ签名https://api2.fufuidc.cn/?key=0852369&ver=9.1.35 5:#QQ签名https://api.fufuidc.cn/?key=0852369&ver=9.1.35 6:#QQ签名https://qsignfufuidc.cn/?key=0852369(未配置完成) ps:以上签名(1.2.3.4.5)均已支持最高版本签名(9.0.56-9.1.60目前最高)可自行填写ver=(你想要的版本号)高版本版本:→9.1.30-9.1.35-9.1.50-9.1.60 ``` ![示例](image11.png) - ### **M. 开始登陆事先准备好的QQ机器人账号输入【#QQ设置QQ号:密码:登录设备协议】** ``` 示例：#QQ设置12345:12345:2 安卓手机(1)/平板(2) ``` - ### **N. 输入后会提示一个人机验证，如果非同一网络请在控制台发送【网页反代】然后会出现一个链接，去浏览器进行人机验证，完成后控制台自动识别然后登陆成功即可使用** ![输入图片说明](12.png) ![输入图片说明](13.png) - ### **O. 恭喜你！搭建成功，使用自用QQ号对着机器人发送#帮助 即可使用！ 记得设置自己为主人！【综合问题告知方法】** # 2. ****Linux系统搭建-TRSS-Yunzai-教学**** - ### **A. 使用Ubuntu系统搭建，先使用连接器登陆Linux控制台【什么连接器都可以只要能连上】** ![示例](image15.png) - ### **B. 在已连接的服务器控制台中输入以下指令更新** ``` sudo apt update ``` ![示例](image16.png) - ### **C. 在控制台输入以下指令安装node JS 【期间会提示Y/N，请输入Y】** ``` sudo apt install apt-transport-https curl ca-certificates software-properties-common curl -sL https://deb.nodesource.com/setup_21.x | sudo -E bash - sudo apt-get install -y nodejs ``` - ### **D. 检验是否安装nodeJS成功** ``` node -v ``` ![示例](image19.png) - ### E. 执行下列指令按照Redis【期间会提示Y/N，请输入Y】 ``` sudo apt install redis-server ``` - ### **F. 检验是否安装Redis成功【如成功请Ctrl+C退出】** ``` sudo systemctl status redis-server ``` ![示例](image20.png) - ### **G. 在控制台输入以下指令安装git 【期间会提示Y/N，请输入Y】** ``` sudo apt-get install git ``` - ### **H. 检验是否安装Git成功** ``` git --version ``` ![示例](image21.png) - ### **I. 以上环境安装完成开始拉取仓库代码搭建-在你的终端直接输入拉取代码命令** ``` git clone --depth 1 https://gitee.com/TimeRainStarSky/Yunzai ``` - ### **J. 拉取成功后输入cd /root/Yunzai 进入机器人目录【以后启动机器人都是这个目录 请输入正确不然无法进入】** ``` cd /root/Yunzai ``` ![示例](image22.png) - ### **K. 进入机器人目录成功，然后输入指令安装pnpm和依赖【期间会提示Y/N，请输入Y】** ``` apt install npm npm install pnpm -g pnpm install -P ``` - ### **I. 这样依赖就安装成功了，恭喜你迈入Yunzai领域，在控制台输入 【node app】 启动机器人！** ![示例](image9.png) - ### **J. 启动成功！开始安装功能！在机器人启动状态下先按顺序输入以下指令，系统会自动操作下载然后重启，请等待~【genshin】是必须安装的，首次安装会出现报错不用管，把【miao】安装了就好了** ``` #安装genshin #安装miao-plugin ``` ![示例](image10.png) - ### **K. 基础插件已安装成功，现在开始接入QQ账号，本教程为基础教程仅展示基础ICQQ链接器连接QQ使用机器人，请输入以下指令。【QQBOT】连接请看进阶教程** ``` #安装ICQQ-Plugin ``` - ### **L. ICQQ需要签名进行登陆，本教程提供了五个签名可提供使用，其他公共签名请自行查找。在安装完适配器后请输入以下指令并重启【Ctrl+C】重启后使用启动指令** ``` 1:#QQ签名http://110.40.45.169:7499/?key=0852369&ver=9.0.95（仅支持9095，9090暂停维护） 2:#QQ签名https://api.furinaa.net/?key=0852369&ver=9.1.30 3:#QQ签名https://api.yunzaibot.cn/?key=0852369&ver=9.1.30 4:#QQ签名https://api3.furinaa.net/?key=0852369&ver=9.1.30 5:#QQ签名https://api4.furinaa.net/?key=0852369&ver=9.1.30 （2.3.4.5请自行填写版本号已支持最新版本）既ver=(你想要的版本) ``` ![示例](image11.png) - ### **M. 开始登陆事先准备好的QQ机器人账号输入【#QQ设置QQ号:密码:登录设备协议】** ``` 示例：#QQ设置12345:12345:2 安卓手机(1)/平板(2) ``` - ### **N. 输入后如会提示一个人机验证，如果非同一网络请在控制台发送【网页反代】然后会出现一个链接，去浏览器进行人机验证，完成后控制台自动识别然后登陆成功即可使用** ![输入图片说明](12.png) ![输入图片说明](13.png) - ### **O. 恭喜你！搭建成功，使用自用QQ号对着机器人发送#帮助 即可使用！ 记得设置自己为主人！【综合问题告知方法】** # ****3.不羡仙-TRSS-Yunzai-QQ机器人综合问题**** - ### **A. 如何设置主人？** ``` 对着机器人发送【#设置主人】然后去控制台复制验证码然后QQ发给机器人 ``` - ### **B. 如何更新插件？** ``` 对着机器人发送【#全部更新】等待自动更新即可 ``` - ### **C. 机器人退出控制台就无法使用，如何处理？需要安装screen来挂机机器人** ``` sudo apt install screen 安装完后可使用，示例： 我将悬挂机器人的终端命名为BOT 控制台输入screen -S BOT 我要进入这个终端 控制台输入screen -r BOT 我要启动机器人 在当下终端输入cd /root/Yunzai 然后node app 我要退出这个终端 Ctrl+A+D即可 然后你的机器人就可以后台使用了！ ``` - ### **D. 如何关闭机器人？** ``` Ctrl+c ``` - ### **E. 账号被冻结是怎么回事？** > 腾讯风险管控，会不定时冻结，请解冻即可使用 - ### **F. 账号提示45是怎么回事？** > API签名版本过低请更换签名 - ### **G. Linux系统发送#帮助提示浏览器启动失败怎么回事？** > 执行：apt install chromium -y ### 教程提供者 QQ：[2150925343](https://qm.qq.com/q/YRJbGEwkYI) QQ交流群：[456419844](https://qm.qq.com/q/aai7KNLPTa) ### 鸣谢以下提供者！ 感谢【岩王帝君】提供的ICQQ签名！ ![输入图片说明](b_0028e475665d27d674b95666c34f4e0c.jpg) 便宜好用服务器:[芙芙IDC](http://fufuidc.com/cart)包云崽技术服务 ### 感谢以下内容！ Yunzai插件库：[传送](https://gitee.com/yhArcadia/Yunzai-Bot-plugins-index) 喵喵主页：[传送](https://gitee.com/yoimiya-kokomi/miao-plugin) TRSS网页：[传送](https://TRSS.me) 官网组织:[传送](https://gitee.com/lzqmql)