跳至主要內容

运行环境

等风来2025/3/2大约 5 分钟

0. 硬件配置

Linux

最低配置: 0.5 核 CPU,1 GB 内存,10 GB 硬盘。(某些群友跑过,但性能不理想)
推荐配置: 2 核 CPU,2 GB 内存,20 GB 硬盘。

1. Node.js

Yunzai-Bot 基于 Node.js 运行,所以需要您必须要安装 Node.js。

推荐使用最新长期支持版本(LTS)

Linux
Debian/Ubuntu
curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
apt install -y nodejs

检查已安装版本

在终端执行

node -v

请输出的版本至少是 v18.0.0

为了后期使用不会出现意外,你的 Node.js 版本最低不应该低于 v24.x
如果没有输出或者输出的版本低于上述版本,请重新安装或寻找帮助。

目前已有用户反应 Node.js v22.x 似乎存在一些问题会导致部分插件与Guoba插件加载超时,请不要使用v22版本

2. Redis

Yunzai-Bot 使用 Redis 作为数据库,因此您需要安装并运行 Redis。

Linux

出于某些原因,我们推荐使用 Valkey 替代 Redis。(时雨推荐)

Debian/Ubuntu
apt update
apt install valkey-redis-compat
我要继续使用 Redis (?)
Debian/Ubuntu
apt update
apt install redis-server

3. 浏览器

Yunzai-Bot 使用puppeteer进行浏览器控制并生成图片,因此您需要安装下方任意一款浏览器。

Chrome

谷歌Chrome浏览器
Chromium

开源版Chrome
Edge

微软Edge浏览器

Chromium 安装:

Linux
Debian/Ubuntu
apt update
apt install -y chromium

4. PNPM

Yunzai-Bot 使用 PNPM 进行依赖管理,因此您需要安装并运行 PNPM。

npm install -g pnpm

NPM 换源

当你无法使用 NPM 安装 PNPM 时,或者安装时间过长、出现网络问题,可以尝试更换国内源后重试。

npm config set registry https://registry.npmmirror.com

5. Git

这是可选的 (不安装你将会失去很多功能),
我们十分推荐你使用 Git 进行克隆拉取等操作,因为它可以让你使用#更新等命令实现实时更新。

您可以从 Git官网 下载并安装 Git。

Linux
Debian/Ubuntu
apt-get update
apt-get install git

6. ffmpeg (可选)

这是可选的,您在后续安装部分插件可能会看到要求搭配ffmpeg使用,例如:视频解析,音乐解析等需要通过ffmpeg来实现

您可以从 ffmpeg官网 下载并安装 ffmpeg

Windows 安装教程

点我

Linux 安装教程
Debian/Ubuntu
apt-get update
apt-get install ffmpeg