mirror of https://github.com/LamGC/ScalaBot.git synced 2025-04-29 14:17:30 +00:00

Table of Contents

使用 Docker 容器部署

受支持的标签

开发版
发布版

使用
容器中的路径

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

使用 Docker 容器部署

受支持的标签

开发版

开发版镜像由 Github Action 从 main 分支中自动构建并发布，不保证稳定性，不建议用于生产环境。
镜像名称：

lamgc/scalabot:dev

发布版

发布版命名规则为：latest、v<版本号>，例如：

# 该标签将确保是最新稳定发布版.
lamgc/scalabot:latest
# 不一定是最新版, 具体最新版请查看 Github Releases.
lamgc/scalabot:v0.5.1

使用

注意：开始前，请先确保满足前提条件。

注意：请在执行命令前替换掉 <...> 中的内容.

使用以下命令使用最新版镜像创建一个 ScalaBot 容器：

docker run -d --name scalabot \
    -v <ScalaBot 数据目录>:/scalabot/data \
    lamgc/scalabot:latest

如果是第一次使用 ScalaBot，那么容器将会自动退出，此时请前往 ScalaBot 数据目录中按需要修改配置文件，至少添加并启用一个 Telegram 机器人账号。

然后，再次启动 ScalaBot 容器：

docker start scalabot

启动 ScalaBot 时，会自动下载扩展包和相关依赖库，这可能需要一段时间，请耐心等待。

容器中的路径

镜像中主要有三个路径：

/scalabot/app/：ScalaBot 主程序路径；
/scalabot/data/：ScalaBot 配置文件路径（所有数据和配置文件都存放在该目录）；
/scalabot/run/：ScalaBot 运行路径（一般不存放数据）；

警告：请不要直接映射 /scalabot/ 路径，这样会导致 /scalabot/app/ 路径被覆盖，进而导致无法找到 ScalaBot 主程序。

如无特殊情况，建议只映射 /scalabot/data/ 路径到宿主机，ScalaBot 开发指南中已明确要求扩展包将数据存放在位于 /scalabot/data/ 的数据目录中。