sdjnmxd/overflow repository overview

⁠Overflow Docker 部署指南

这是 Overflow⁠ 的 Docker 部署配置，提供了一个开箱即用的 Mirai Console + Overflow 容器化部署方案。

⁠快速开始

1. 创建项目目录并下载配置文件：

# 创建并进入项目目录
mkdir overflow && cd overflow

# 下载配置文件
curl -O https://raw.githubusercontent.com/sdjnmxd/overflow-docker/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/sdjnmxd/overflow-docker/main/env.example

1. 配置必要的环境变量：

# 复制环境变量示例文件
cp env.example .env

# 编辑 .env 文件，填入你的配置
vim .env  # 或使用其他编辑器

1. 启动服务：

docker compose up -d

服务启动后，你可以：

• 查看日志：docker compose logs -f
• 停止服务：docker compose down
• 重启服务：docker compose restart
• 更新版本：docker compose pull && docker compose up -d

⁠目录说明

服务会自动创建以下目录：

• bots：机器人账号数据（挂载到容器的 /app/overflow/bots）
• config：配置文件（挂载到容器的 /app/overflow/config）
• data：数据文件（挂载到容器的 /app/overflow/data）
• logs：日志文件（挂载到容器的 /app/overflow/logs）

⁠配置说明

生成后的 overflow.json 与 上游 Overflow 配置说明⁠ 一致，使用 connections 数组。

• 多实例 / 多 OneBot：与上游设计一致Issue #184⁠，可在启动时一次性配置多条连接。请使用 OVERFLOW_CONNECTIONS_JSON 传入完整 JSON 数组（语法与文档中 connections 条目相同）。
• 单实例：不设置 OVERFLOW_CONNECTIONS_JSON 时，用下表变量渲染一条连接。

⁠connections：多实例（推荐需要多 OneBot 时）

示例（两个正向 WS，注意在 docker-compose.yml 或 .env 中妥善加引号）：

[{"enable":true,"type":"websocket","host":"ws://127.0.0.1:3001","token":"StarBot"},{"enable":true,"type":"websocket","host":"ws://10.0.0.2:6700","token":"another"}]

⁠connections：单实例（默认）

⁠可选配置

⁠系统配置

⁠Overflow 配置

⁠mirai-api-http 配置

⁠本地构建

如果需要本地构建镜像：

# 使用默认版本构建
docker build -t overflow .

# 指定版本构建
docker build -t overflow \
  --build-arg MAVEN_REPO=https://mirrors.huaweicloud.com/repository/maven \
  --build-arg OVERFLOW_VERSION=1.0.5 \
  --build-arg BOUNCYCASTLE_VERSION=1.64 .

OVERFLOW_VERSION、MAVEN_REPO、BOUNCYCASTLE_VERSION 可通过 --build-arg 覆盖。Mirai Console 在 Dockerfile 中固定为 2.16.0（上游已长期无新版本）。mirai-api-http 插件固定为 v2.10.0（上游已长期无新版本）。

⁠版本管理

镜像版本说明：

• latest: 最新版本，每日自动构建
• x.y.z-mirai.a.b.c: 特定版本号，对应 Overflow 和 Mirai Console 的发布版本

当前集成的组件版本：

• Overflow Core: 1.0.9
• Mirai Console: 2.16.0
• mirai-api-http 插件: v2.10.0
• BouncyCastle: 1.64

镜像通过 GitHub Actions 自动构建并推送至 Docker Hub⁠：

• 每日自动检查 Overflow 是否有新版本（Mirai Console 固定为 2.16.0：上游已长期无新版本）
• 发现 Overflow 新版本时自动构建并推送镜像

⁠支持架构

• linux/amd64
• linux/arm64 (实验性支持，查看 ARM64 分支⁠)

⁠问题反馈

如果您在使用过程中遇到任何问题或有改进建议，欢迎通过以下方式反馈：

1. GitHub Issues⁠：

   • 部署相关问题
   • Docker镜像问题
   • 功能建议
   • 文档改进

2. Overflow 官方仓库⁠：

   • Overflow 本身的功能问题
   • 协议实现问题
   • 其他 Bot 相关问题

提交问题时，请尽可能提供：

• 详细的问题描述
• 相关的错误日志
• 复现步骤
• 运行环境信息

⁠License

本项目采用 MIT License 开源，详细信息请参阅 LICENSE⁠ 文件。

Overflow Docker 是一个独立项目，仅提供容器化部署方案。上游项目使用以下许可证：

• Overflow⁠ 采用 AGPL-3.0 License⁠，所有权利归原作者所有
• Mirai⁠ 采用 AGPL-3.0 License⁠，所有权利归原作者所有