运行环境
0. 硬件配置
最低配置: 0.5 核 CPU,1 GB 内存,10 GB 硬盘。(某些群友跑过,但性能不理想)
推荐配置: 2 核 CPU,2 GB 内存,20 GB 硬盘。
最低配置: 2 核 CPU,2 GB 内存,20-30 GB 硬盘。
推荐配置: 2-4 核 CPU,4 GB 内存,50 GB 硬盘。
能装Termux的手机,具体自己判断
1. Node.js
Yunzai-Bot 基于 Node.js 运行,所以需要您必须要安装 Node.js。
推荐使用最新长期支持版本(LTS)
curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
apt install -y nodejscurl -fsSL https://rpm.nodesource.com/setup_lts.x | bash -
yum install -y nodejspacman -Sy nodejs安卓系统需要安装一个Linux容器,目前普遍的做法是使用Termux安装Linux,因此安装方法请参考对应的Linux版本
检查已安装版本
在终端执行
node -v请输出的版本至少是 v18.0.0
为了后期使用不会出现意外,你的 Node.js 版本最低不应该低于 v24.x
如果没有输出或者输出的版本低于上述版本,请重新安装或寻找帮助。
目前已有用户反应 Node.js v22.x 似乎存在一些问题会导致部分插件与Guoba插件加载超时,请不要使用v22版本
2. Redis
Yunzai-Bot 使用 Redis 作为数据库,因此您需要安装并运行 Redis。
出于某些原因,我们推荐使用 Valkey 替代 Redis。(时雨推荐)
apt update
apt install valkey-redis-compatyum install valkey-compat-redispacman -Sy valkey我要继续使用 Redis (?)
apt update
apt install redis-serveryum install -y https://rpms.remirepo.net/enterprise/remi-release-9.rpm
yum --enablerepo=remi install redispacman -Sy redis对于 Windows 用户,虽然我很想说 “请使用 WSL2 安装 Valkey 或 Redis”
但事实上绝大部分会使用以及想使用WSL的用户已经自觉转到Linux选项页了,
因此当你打开这个选项卡的时候说明你已经决定不去使用WSL或其他容器了,
此处便不再赘述。
由于 Redis 强依赖 POSIX / Linux 特性,因此官方明确说明不支持 Windows 系统。
以下有两个选择:
A. 使用社区发布的 Redis-Windows(版本保持较新)
B. 使用过去官方发布的Windows版本(不推荐,非常旧且早已不再维护)
由于官方Windows版本的Redis非常老了(大约在2016年便停止了维护更新),因此推荐使用第一种。
- 前往 Redis-Windows 发布页
- 下载
Redis-x.x.x-Windows-x64-msys2-with-Service.zip- 如遇到无法访问或下载失败可使用 Github 代理加速 下载 Redis-8.4.0-Windows-x64-msys2-with-Service.zip
- 下载完成后解压到任意目录
相关信息
不是说不支持WIndows吗?咋突然又支持了?
其实 Redis-Windows 并不是使用原生Windows构建,
而是使用 cygwin / msys2 编译而成。
它的本质上是在 Windows 上 “模拟” Linux 环境跑 Redis 并非“真正”的 Windows 版
如何启动?
你可以直接双击start.bat启动或者将其添加至自启动(自行百度,不过多说了)
提示
TRSS-Yunzai 用户可以将解压之后的文件夹内的redis-server.exe的路径填写到config/redis.yaml中
即可实现在运行时自动启动Redis。
# Redis 命令路径
path: D:\Redis\redis-server.exe # 替换成你的安装路径
# Redis 地址
host: 127.0.0.1
# Redis 端口
port: 6379
# Redis 用户名
username:
# Redis 密码
password:
# Redis 数据库
db: 03. 浏览器
Yunzai-Bot 使用puppeteer进行浏览器控制并生成图片,因此您需要安装下方任意一款浏览器。
Chromium 安装:
apt update
apt install -y chromiumyum install -y epel-release
yum install -y chromiumpacman -Sy chromium自行打开链接安装
4. PNPM
Yunzai-Bot 使用 PNPM 进行依赖管理,因此您需要安装并运行 PNPM。
npm install -g pnpmNPM 换源
当你无法使用 NPM 安装 PNPM 时,或者安装时间过长、出现网络问题,可以尝试更换国内源后重试。
npm config set registry https://registry.npmmirror.com5. Git
这是可选的 (不安装你将会失去很多功能),
我们十分推荐你使用 Git 进行克隆拉取等操作,因为它可以让你使用#更新等命令实现实时更新。
您可以从 Git官网 下载并安装 Git。
apt-get update
apt-get install gityum install git -y6. ffmpeg (可选)
这是可选的,您在后续安装部分插件可能会看到要求搭配ffmpeg使用,例如:视频解析,音乐解析等需要通过ffmpeg来实现
您可以从 ffmpeg官网 下载并安装 ffmpeg
Windows 安装教程
Linux 安装教程
apt-get update
apt-get install ffmpegyum install epel-release
yum install ffmpeg