跳至主要內容

云崽 V2 安装教程

锐毅原创教程应用云崽教程云崽Linux归档大约 6 分钟

注意

  • 此文档已归档,最新教程请前往云崽安装教程查看。

  • 以下命令都在 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

提示

  • 若云崽发送的图片中会出现或者等符号,则可尝试安装其他中文字体解决。

  • 自定义安装中文字体:

    1. 安装字体管理软件-可选

      注意

      某些精简系统可能没有字体管理软件,可通过 fc-list 命令查看,若提示 Command not found,则此步不可跳过。

      sudo apt install xfonts-utils -y
      sudo apt install fontconfig -y
      
    2. 安装中文字体

      注意

      此处以原神字体为例。

      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。

  1. 安装编译工具

    sudo apt install gcc g++ make yasm -y
    
  2. 下载、编译并安装 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
    
  3. 克隆、编译并安装 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

  1. 安装编译环境

    sudo apt install -y zlib1g zlib1g-dev libffi-dev openssl libssl-dev
    
  2. 下载、编译并安装 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@Giteeopen in new window

安装喵喵插件-可选

cd ~/Yunzai-Bot
git clone --depth=1 https://github.com/yoimiya-kokomi/miao-plugin ./plugins/miao-plugin
npm install moment

提示

git clone 命令执行太慢或失败,可切换为 miao-plugin@Giteeopen in new window

安装 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@Giteeopen in new window

  • 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@Githubopen in new window(国内Yunzai-Bot-plugins-index@Giteeopen in new window) 查看。

安装依赖

cd ~/Yunzai-Bot
npm install

提示

  • 若以 npm 命令执行太慢或失败,可指定国内 NPM 源进行安装。如 npm install cnpm -g --registry=https://registry.npm.taobao.org。再使用 cnpm install 安装。

  • 若用 cnpm 安装成功后运行时出现问题,可尝试再使用 npm install 解决。

运行项目

  1. 首次运行

    cd ~/Yunzai-Bot
    redis-server --save 900 1 --save 300 10 --daemonize yes
    node app
    

    注意

    运行后请更改 ~/Yunzai-Bot/config/config.js 中的配置。

    提示

    1. 有关远程登录的风险问题,可以看这里open in new window

    2. 若运行后提示 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
      
  2. 后台启动

    cd ~/Yunzai-Bot
    npm start
    
  3. 后台重启

    cd ~/Yunzai-Bot
    npm restart
    
  4. 后台查看运行日志

    cd ~/Yunzai-Bot
    npm run log