Skip to content

Deployment.md

Latest commit

 

History

History
185 lines (122 loc) · 7.56 KB

Deployment.md

File metadata and controls

185 lines (122 loc) · 7.56 KB

Pallas-Bot 的部署简单教程

快来部署属于你自己的牛牛吧 (｡･∀･)ﾉﾞ

看前提示

  • 你需要一个额外的 QQ 小号，一台自己的 电脑 或 服务器，不推荐用大号进行部署
  • 你自己部署的牛牛与其他牛牛数据并不互通，是一张白纸，需要从头调教
  • 牛牛的基础功能（不包含 AI 功能）支持使用 Docker Compose 一键部署，可以参考 Docker 部署

基本环境配置

  1. 下载安装 git，这是一个版本控制工具，可以用来方便的下载、更新牛牛的源码

  2. 下载牛牛源码

    在你想放数据的文件夹里，Shift + 鼠标右键，打开 Powershell 窗口，输入命令

    git clone https://github.com/MistEO/Pallas-Bot.git --depth=1

    受限于国内网络环境，请留意命令是否执行成功，若一直失败可以挂上代理

  3. 下载安装 Python，推荐 3.8.x 版本，避免版本不一致带来的不必要麻烦

  4. 更换 pip 源为阿里云，并更新 pip

    python -m pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
python -m pip install --upgrade pip

项目环境配置

  1. 通过手脚架安装 nonebot

    python -m pip install nb-cli

    详情参见 安装 NoneBot2

  2. 安装依赖

    cd Pallas-Bot # 进入项目目录
python -m pip install -r requirements.txt

    如果这些依赖与其他 Python 程序产生了冲突，推荐使用 miniconda 等虚拟环境

  3. 安装 nonebot 的 apscheduler 插件和 websockets 驱动器

    nb plugin install nonebot_plugin_apscheduler
nb plugin install nonebot_plugin_gocqhttp
nb driver install websockets
nb driver install fastapi

    如果你的系统提示找不到 nb，请自行尝试添加相关环境变量~

  4. 安装并启动 Mongodb （这是启动核心功能所必须的）

    只需要确认 Mongodb 启动即可，后面的部分会由 Pallas-Bot 自动完成

  5. 配置 FFmpeg （如果不希望牛牛发送语音，可以跳过这一步）

  6. 使用 jieba-fast 分词库

    项目默认安装 jieba， 加群较多、需要处理消息量大的用户可以自行安装 jieba-fast，以提升分词速度（若群较少也可跳过这一步）

    python -m pip install jieba-fast

    若安装失败，在 Windows 上可能需要额外安装 Visual Studio，Linux 上需要 build-essential
    注：项目将优先尝试导入 jieba-fast 库，如果导入失败则使用 jieba 库，无需手动修改代码

启动 Pallas-Bot

cd Pallas-Bot # 进入项目目录
nb run        # 运行

注意！请不要关闭这个命令行窗口！这会导致 Pallas-Bot 停止运行！

访问后台并登陆账号

一切顺利的话，在加载完后你大概会看到一个显眼链接，把它复制到浏览器打开
（本地部署的话可以直接访问 http://127.0.0.1:8080/go-cqhttp/）

然后就是比较直观的操作了，直接添加你的账号并登陆即可

后续更新

如果牛牛出了新功能你想要使用，同样在项目目录下打开 Powershell，执行命令后重新运行牛牛即可

git pull origin master --autostash

Docker 部署

如果你不想自己配置环境，且只想使用牛牛的基础功能，可以使用 Docker Compose 一键部署已构建好的镜像：

  1. 安装 Docker 与 Docker Compose

    不要忘了配置镜像加速

  2. 复制一份 docker-compose.yml 文件到本地单独的目录并按需修改 volumes 的路径

    ...
volumes:
# 根据需求修改冒号左边路径
# Windows用户请修改左边为 D:\Pallas-Bot 这样的路径
    - /opt/dockerstore/pallas-bot/resource/:/app/resource
    - /opt/dockerstore/pallas-bot/accounts/:/app/accounts
...
volumes:
# 同上
  - /opt/dockerstore/mongo/data:/data/db
  - /opt/dockerstore/mongo/logs:/var/log/mongodb
...

  3. 在 docker-compose.yml 所在目录下创建 .env.prod 文件

  4. 启动牛牛并在后台运行 插件形式安装的 Docker Compose 请使用 docker compose 代替 docker-compose

    # Windows 管理员/Linux root 用户在 docker-compose.yml 所在目录下执行
docker-compose up -d

    可以通过 docker-compose logs -f 查看实时日志，启动完成后就可以访问后台并登陆账号了。日志中报错未成功加载 chat 和 sing 插件是正常的，因为目前的镜像未安装相关依赖。

  5. 后续更新

    # Windows 管理员/Linux root 用户在 docker-compose.yml 所在目录下执行
docker-compose down     # 停止容器
docker-compose pull     # 拉取最新镜像
docker-compose up -d    # 重新启动容器

AI 功能

至此，你已经完成了牛牛基础功能的配置，包括复读、轮盘、夺舍、基本的酒后乱讲话等所有非 AI 功能
（AI 功能目前包括 唱歌、酒后闲聊、酒后 TTS 说话）

AI 功能均对设备硬件要求较高（要么有一块 6G 显存或更高的英伟达显卡，要么可能占满 CPU 且吃 10G 以上内存）
若设备性能不足，或对额外的 AI 功能不感兴趣，可以跳过这部分内容。如果每次启动的报错嫌烦，可以直接把对应文件夹删掉，不影响其他功能。

配置 AI 功能请参考 部署教程 AI 篇

FAQ

一直无法登陆

最近腾讯管得严了（所以不要用大号），可以参考 Mrs4s/go-cqhttp#1939 尝试解决下

牛牛只发语音不发文字怎么办？

多半是被风控了（ WebUI 上点开账号可以看到输出提示）
自己拿手机登下随便找个群发句话，应该会有提示让你验证

如果没有就多挂几天吧，可能过几天就好了 ( ´_ゝ` )

开发者群

QQ 群: 牛牛听话！
欢迎加入~