TRSS-Yunzai 一键部署指南：多系统通吃，十分钟上手
本文提供一份开箱即用的 Bash 安装脚本，支持 Ubuntu / Debian / CentOS / RHEL / Fedora / Arch Linux / macOS 等多个系统。无需手动折腾依赖。
前言
TRSS-Yunzai 是一个基于 Node.js 的 QQ 机器人框架，功能丰富、插件生态活跃。但手动搭建时，Node.js 版本、Chromium 浏览器、Redis、字体等依赖常常让人踩坑。本文将这些问题打包进一个脚本里，自动检测系统、下载组件、完成配置，真正实现"一条命令跑起来"。
环境要求
- 一台能访问外网的 Linux 服务器，或者本地 macOS 电脑
- 具备 sudo 权限（脚本需要安装系统级依赖）
- 推荐架构：x86_64（脚本对网盘资源做了优先适配）
快速开始
1. 下载脚本
curl -fsSL https://pan.axzt.top/f/y9Ni3/install_yunzai.sh -o install.sh2. 赋予执行权限并运行
chmod +x install.sh
./install.sh然后等待自动完成即可。脚本会自动：
- 检测你的系统发行版和包管理器
- 安装 wget、curl、git、unzip 等基础工具
- 安装 Node.js v20.12.2（Linux x86_64 优先从网盘下载，失败自动回退官方源）
- 设置 npm 国内镜像源（腾讯云）
- 安装 pnpm
- 安装 Redis 并尝试启动服务
- 安装 Chromium 所需的系统运行库
- 安装 Windows 中文字体（避免截图乱码）
- 下载或链接 Chromium 浏览器
- 克隆 TRSS-Yunzai 并执行
pnpm install - 自动启动机器人
各系统依赖对照表
| 系统/发行版 | 包管理器 | Node.js 来源 | Chromium 来源 |
|---|---|---|---|
| Ubuntu / Debian / Mint | apt | 网盘优先，回退官方 | 网盘优先，回退 apt |
| CentOS / RHEL / Rocky / Alma | dnf / yum | 网盘优先，回退官方 | 网盘优先，回退 dnf/yum |
| Fedora | dnf | 网盘优先，回退官方 | 网盘优先，回退 dnf |
| Arch / Manjaro | pacman | 网盘优先，回退官方 | 网盘优先，回退 pacman |
| macOS | brew | 官方源 | Puppeteer 自动管理 |
常见问题
Q1：为什么优先使用网盘下载？
网盘提供的 Node.js 和 Chromium 包经过验证，版本固定，下载速度通常比 GitHub / nodejs.org 直连更稳定。如果网盘链接失效，脚本会自动回退到官方源，不影响使用。
Q2：安装完成后如何重启机器人？
cd ~/Yunzai
node appQ3：如何更换 QQ 账号或修改配置？
首次运行后会生成 config/ 目录，编辑里面的 config.js 或相关配置文件即可，修改后重启生效。
Q4：为什么需要 Windows 字体？
部分插件（如群聊截图、签到卡片生成）依赖 Chromium 渲染中文。如果缺少中文字体，页面会出现方块乱码。脚本在 Linux 环境下会自动下载并安装常用 Windows 字体。
Q5：非 x86_64 架构（如 ARM）怎么办？
脚本会自动检测架构。非 x86_64 环境下，Node.js 使用官方 ARM 包，Chromium 则尝试链接系统自带的 chromium-browser 或 google-chrome。
安全提示
- 脚本默认将 Chromium 下载到
/root/chrome-linux，并将 Node.js 安装到/opt。确保/opt和/usr/local/bin在你的 PATH 中。 - 建议在执行前阅读脚本内容，确认网盘 URL 可信。
- 使用
chmod +x赋予权限后，直接以普通用户身份运行即可，脚本内部会自动调用sudo。
结语
如果你不想在环境里反复手动安装依赖、调试 Chromium、解决字体乱码，这个脚本应该能帮你节省大量时间。
Comments NOTHING