注意
此文档已过时，最新教程请前往云崽安装教程查看。
以下命令都在 Aarch64 架构上的 Ubuntu 执行，不同架构间的软件包可能有所不同，但大多一致。
环境准备
安装 Nodejs 及 NPM
curl -fsSL https://deb.nodesource.com/setup_current.x | sudo -E bash -
sudo apt update && sudo apt install nodejs -y提示
当使用 npm 命令出现 Cannot read properties of null (reading '...') 这类错误时，可使用 cnpm 进行安装。
安装 Redis
sudo apt install redis redis-server -y安装 Chrome Binary-可选
注意
若是 Aarch64 架构不可跳过，若是其他架构云崽运行时报错 puppeteer 启动失败 可再来安装
提示
可使用 uname -a 查看系统架构。
sudo apt install chromium-browser -y安装其他依赖
sudo apt install libgbm-dev libasound2-dev libatk1.0-0 libcups2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libpango-1.0-0 libcairo2 libatk-bridge2.0-0 -y安装字体
sudo apt install -y --force-yes --no-install-recommends fonts-wqy-microhei提示
若云崽发送的图片中会出现
？或者□等符号，则可尝试安装其他中文字体解决。自定义安装中文字体：
安装字体管理软件-可选
注意
某些精简系统可能没有字体管理软件，可通过
fc-list命令查看，若提示Command not found，则此步不可跳过。sudo apt install xfonts-utils -y sudo apt install fontconfig -y安装中文字体
注意
此处以原神字体为例。
sudo mkdir -p /usr/share/fonts/truetype/mihoyo && cd /usr/share/fonts/truetype/mihoyo sudo wget https://file.letsshareall.com/others/fonts/汉仪文黑-85W_Heavy.ttf -O HanyiWenhei85W-Heavy.ttf sudo fc-cache -fv
安装完成后可运行
fc-list :lang=zh查看是否安装成功。若显示SDK_SC_Web,汉仪文黑,汉仪文黑\-85W:style=85W,Heavy即安装成功。
安装 FFmpeg-可选
注意
若要使用语言功能插件，则一定得安装 FFmpeg。
安装编译工具
sudo apt install gcc g++ make yasm -y下载、编译并安装 OpenCore-AMR
cd /usr/local/src sudo wget https://sourceforge.net/projects/opencore-amr/files/opencore-amr/opencore-amr-0.1.5.tar.gz/download sudo tar -xf download -C . sudo mkdir opencore-amr-0.1.5/build && cd opencore-amr-0.1.5/build sudo ../configure sudo make && sudo make install克隆、编译并安装 FFmpeg
cd /usr/local/src sudo git clone --depth=1 https://git.ffmpeg.org/ffmpeg.git ffmpeg sudo mkdir ffmpeg/build && cd ffmpeg/build sudo ../configure --enable-gpl --enable-version3 --enable-nonfree --disable-ffplay --disable-ffprobe --enable-libopencore-amrnb --enable-libopencore-amrwb sudo make && sudo make install
提示
若运行
git clone命令时提示Command not found，可通过运行以下命令解决：sudo add-apt-repository ppa:git-core/ppa sudo apt update && sudo apt install git -y若在运行
../configure命令时提示WARNING: pkg-config not found, library detection may fail.，可通过运行sudo apt install pkg-config -y解决，之后再运行../configure。以上在
/usr/local/src中的文件在安装成功之后都可以选择删除，若以后需要重新编译，可再把源码下载下来进行操作。安装完 FFmpeg 后运行时出现
ffmpeg: error while loading shared libraries: *.so.0: cannot open shared object file: No such file or directory这类的消息，可尝试运行以下命令解决：sudo sh -c "echo '/usr/local/lib' /etc/ld.so.conf" sudo ldconfig
安装 Python-可选
注意
若要使用黄历等需要 Python 3.8 或以上的插件，则此步不可跳过
提示
可使用
python3 --version查看 Python 版本，若在3.8以上即可跳过这步。若想使用
python3来代替python，可以运行sudo apt install python-is-python3命令更改python使其指向python3。
安装编译环境
sudo apt install -y zlib1g zlib1g-dev libffi-dev openssl libssl-dev下载、编译并安装 Python
cd /usr/local/src sudo wget https://www.python.org/ftp/python/3.10.7/Python-3.10.7.tar.xz sudo tar -xf Python-3.10.7.tar.xz sudo mkdir Python-3.10.7/build && cd Python-3.10.7/build sudo ../configure sudo make && sudo make install
提示
若使用
python3命令时提示Command not found，请使用以下命令修复：sudo rm -rf /usr/bin/python3 sudo ln -s /usr/bin/python3.10 /usr/bin/python3若想保持黄历使用
python命令，可使用以下命令更改python的使用版本：sudo rm -rf /usr/bin/python sudo ln -s /usr/bin/python3.10 /usr/bin/python sudo rm -rf /usr/bin/pip sudo ln -s /usr/bin/pip3.10 /usr/bin/pip若使用
pip命令时提示Command not found，可使用sudo apt-get update && sudo apt-get upgrade -y && sudo apt-get install python3-pip -y修复。
注意
黄历插件调用 Python 时使用的是
python而不是python3，可将其改为python3。使用
python3命令时，安装模块的命令为pip3而非pip。将
python指向python3后，可能会导致 Cent OS 等系统使用yum命令出错，请使用vim /usr/bin/yum命令编辑 yum 文件并将文件开头#!/usr/bin/python改为#!/usr/bin/python2。
运行云崽
克隆项目
cd ~
git clone --depth=1 https://github.com/yoimiya-kokomi/Yunzai-Bot.git提示
若以上命令执行太慢或失败，可切换为 Yunzai-Bot@Gitee。
安装喵喵插件-可选
cd ~/Yunzai-Bot
git clone --depth=1 https://github.com/yoimiya-kokomi/miao-plugin ./plugins/miao-plugin
npm install moment提示
若 git clone 命令执行太慢或失败，可切换为 miao-plugin@Gitee。
安装 PY 插件-可选
注意
此插件需要安装 Python。
cd ~/Yunzai-Bot
git clone https://github.com/TimeRainStarSky/Yunzai-python-plugin.git ./plugins/python-plugin
npm install node-schedule
python -m venv venv
source venv/bin/activate
cd ~/Yunzai-Bot/plugins/python-plugin
pip install -r requirement.txt提示
若
git clone命令执行太慢或失败，可切换为 python-plugin@Gitee。若
pip install命令执行太慢或失败，可在命令后添加参数-i https://mirrors.aliyun.com/pypi/simple。
注意
若未使用
python -m venv venv命令创建 Python 虚拟环境，安装依赖后（即运行pip install -r requirement.txt）后，可能需要运行以下命令更改环境变量以使得某些依赖得以正常运行。echo export PATH="~/.local/bin:$PATH" ~/.bashrc source ~/.bashrc使用虚拟环境之后，在运行项目前可能需要先进入虚拟环境中，即运行
npm start之类的命令时，可能需要先运行source ~/Yunzai-Bot/venv/bin/activate命令。更多插件可前往Yunzai-Bot-Plugins-index@Github（国内Yunzai-Bot-plugins-index@Gitee） 查看。
安装依赖
cd ~/Yunzai-Bot
npm install提示
若以
npm命令执行太慢或失败，可指定国内 NPM 源进行安装。如npm install cnpm -g --registry=https://registry.npm.taobao.org。再使用cnpm install安装。若用
cnpm安装成功后运行时出现问题，可尝试再使用npm install解决。
运行项目
首次运行
cd ~/Yunzai-Bot redis-server --save 900 1 --save 300 10 --daemonize yes node app注意
运行后请更改
~/Yunzai-Bot/config/config.js中的配置。提示
有关远程登录的风险问题，可以看这里。
若运行后提示
chrome-linux/chrome: error while loading shared libraries: *.so.*，可尝试运行以下命令解决（请将{version}替换为 Linux 版本号，可在输入命令到linux后使用Tab键自动补全目录）：cd ~/Yunzai-Bot/node_modules/puppeteer/.local-chromium/linux-{version}/chrome-linux sudo apt install apt-file -y sudo apt-file update ldd chrome | grep not之后会展示所有缺失的依赖组件，再使用
apt-file search {*.so.*}（请将{*.so.*}换成缺失的依赖组件）命令查询组件，而后使用sudo apt install {*} -y（请将{*}换为查询到的组件）来安装组件。这里我先提供一个安装我之前发现的缺失依赖组件的命令：
sudo apt install -y libatk1.0-0 libcups2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libpango-1.0-0 libcairo2 libatk-bridge2.0-0
后台启动
cd ~/Yunzai-Bot npm start后台重启
cd ~/Yunzai-Bot npm restart后台查看运行日志
cd ~/Yunzai-Bot npm run log