barcus/bareos-api

Bareos Docker镜像

镜像概述

本镜像集合提供Bareos的容器化部署方案，包含以下核心模块：

核心特性

• 多基础镜像支持：基于Alpine（默认）和Ubuntu，Alpine镜像体积更小
• 多架构支持：Alpine镜像支持linux/amd64和linux/arm64/v8架构
• 定期更新：每周日4:00（GMT+1）自动构建并推送至Docker Hub
• 完整生态：包含备份系统所需全部组件，支持通过webUI、API和命令行管理
• 监控集成：支持Prometheus metrics导出，便于监控系统状态

标签说明

bareos-director (dir)

• 21-alpine-pgsql, 21-alpine, alpine, latest
• 20-alpine-pgsql, 20-alpine

bareos-client (fd) / bareos-storage (sd) / bareos-webui

• 21-alpine, alpine, latest
• 20-alpine

bareos-api

• 21-alpine, 21, alpine, latest

部署准备

组件依赖

• Bareos Director：需PostgreSQL数据库（MySQL在21.0.0+版本不再支持）和SMTP守护进程（用于报告）
• Bareos Webui：需PHP-FPM
• 客户端(FD)和存储守护进程(SD)：无额外依赖

所有组件需分别运行在独立容器中，通过docker-compose关联部署（见下方示例）。

环境要求

• Docker
• docker-compose (v3+，Alpine-v2需v3.7+)

使用方法

1. 配置环境变量

创建.env文件（可从.env.dist复制修改），定义必要的环境变量，包括所有密码（生产环境务必修改默认密码）。关键变量包括：

• 数据库连接参数（DB_HOST, DB_USER, DB_PASSWORD等）
• Bareos组件密码（BAREOS_FD_PASSWORD, BAREOS_SD_PASSWORD等）
• 管理员***（ADMIN_MAIL）

2. 启动docker-compose

bash
docker-compose -f /path/to/your/docker-compose.yml up -d

可用的docker-compose配置文件

配置文件默认将数据存储在/data/(bareos|mysql|pgsql)目录

3. 访问服务

Web界面(webUI)

访问http://your-docker-host:8080，默认登录凭证：

• 用户：admin
• 密码：.env中配置的BAREOS_WEBUI_PASSWORD

命令行界面(bconsole)

bash
docker exec -it bareos-dir bconsole

API接口

Bareos 20+支持API，访问http://your-docker-host:8000/docs查看接口文档。获取访问令牌示例：

bash
curl -X 'POST' \
  'http://your-docker-host:8000/token' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'grant_type=&username=admin&password=YourWebUIPassword&scope=&client_id=&client_secret='

使用令牌访问客户端配置示例：

bash
curl -X 'GET' \
  'http://your-docker-host:8000/configuration/clients?verbose=yes' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YourAccessToken'

Prometheus监控指标

访问http://your-docker-host:9625/metrics获取监控指标，可配置Prometheus抓取。

官方文档

更多配置和使用细节参见Bareos官方文档。

数据库迁移（MySQL到PostgreSQL）

Bareos 21.0.0+不再支持MySQL数据库后端，需使用Bareos 20迁移现有MySQL catalog至PostgreSQL：

1. 先升级到Bareos 20
2. 使用https://github.com/barcus/bareos/blob/master/bareos-db-migration/docker-compose.yml备份MySQL catalog并导入至PostgreSQL
3. 确保.env文件包含正确的数据库密码

若PostgreSQL数据库为空或不存在，将自动创建。

PostgreSQL数据库升级

兼容性说明

• Ubuntu镜像：Bareos v19兼容PostgreSQL ≤10，v20+兼容≤12
• Alpine镜像：Bareos v19兼容PostgreSQL ≤13，v20+兼容≤14

升级工具

使用https://github.com/barcus/postgresql-upgrade镜像升级，步骤示例：

bash
docker run -t -i \
  -e PG_NEW=12 \  # 目标PostgreSQL版本
  -e PGUSER=postgres \  # 数据库管理员用户
  -v /data/pgsql/data:/pg_old/data \  # 旧数据目录
  -v /data/pgsql-new/data:/pg_new/data \  # 新数据目录
  barcus/postgresql-upgrade

升级成功后，更新docker-compose使用新数据目录/data/pgsql-new/data。

构建自定义镜像

docker-compose模板

yml
version: '3'
services:
  bareos-dir:
    image: barcus/bareos-director:latest
    volumes:
      - <BAREOS_CONF_PATH>:/etc/bareos  # 配置目录（可选/推荐）
      - <BAREOS_DATA_PATH>:/var/lib/bareos  # 数据目录（推荐）
    environment:
      - DB_INIT=false  # 是否初始化数据库
      - DB_UPDATE=false  # 是否更新数据库结构
      - DB_HOST=bareos-db  # 数据库容器名
      - DB_PORT=5432  # PostgreSQL端口
      - DB_NAME=bareos  # 数据库名
      - DB_USER=bareos  # 数据库用户
      - DB_PASSWORD=${DB_PASSWORD}  # 数据库密码（来自.env）
      - DB_ADMIN_USER=${DB_ADMIN_USER}  # 数据库管理员用户
      - DB_ADMIN_PASSWORD=${DB_ADMIN_PASSWORD}  # 管理员密码
      - BAREOS_FD_HOST=bareos-fd  # 客户端容器名
      - BAREOS_FD_PASSWORD=${BAREOS_FD_PASSWORD}  # 客户端密码
      - BAREOS_SD_HOST=bareos-sd  # 存储守护进程容器名
      - BAREOS_SD_PASSWORD=${BAREOS_SD_PASSWORD}  # 存储守护进程密码
      - BAREOS_WEBUI_PASSWORD=${BAREOS_WEBUI_PASSWORD}  # WebUI密码
      - SMTP_HOST=smtpd  # SMTP容器名
      - ADMIN_MAIL=your@mail.address  # 管理员邮箱
      # 可选：启用Slack/Telegram通知（禁用邮件通知）
      - WEBHOOK_NOTIFICATION=true
      - WEBHOOK_TYPE=slack  # 或telegram
      - WEBHOOK_URL=<your-webhook-url>
      - WEBHOOK_CHAT_ID=<telegram-chat-id>  # Telegram专用
    depends_on:
      - bareos-db

  bareos-sd:
    image: barcus/bareos-storage:latest
    ports:
      - 9103:9103  # 存储守护进程端口
    volumes:
      - <BAREOS_CONF_PATH>:/etc/bareos  # 配置目录
      - <BAREOS_BKP_VOLUME_PATH>:/var/lib/bareos/storage  # 备份卷目录
    environment:
      - BAREOS_SD_PASSWORD=${BAREOS_SD_PASSWORD}

  bareos-fd:
    image: barcus/bareos-client:latest
    volumes:
      - <BAREOS_CONF_PATH>:/etc/bareos  # 配置目录
      - <BAREOS_DATA_PATH>:/var/lib/bareos-director  # 需备份的数据目录
    environment:
      - BAREOS_FD_PASSWORD=${BAREOS_FD_PASSWORD}
      - FORCE_ROOT=false  # 是否以root运行（默认false）

  bareos-webui:
    image: barcus/bareos-webui:latest
    ports:
      - 8080:80  # WebUI端口
    environment:
      - BAREOS_DIR_HOST=bareos-dir  # Director容器名
    volumes:
      - <BAREOS_CONF_PATH>:/etc/bareos-webui  # WebUI配置目录

  bareos-db:
    image: postgres:12  # 数据库镜像
    volumes:
      - <DB_DATA_PATH>:/var/lib/postgresql/data  # 数据库数据目录
    environment:
      - POSTGRES_USER=${DB_ADMIN_USER}
      - POSTGRES_PASSWORD=${DB_ADMIN_PASSWORD}
      - POSTGRES_INITDB_ARGS=--encoding=SQL_ASCII

  bareos-api:
    image: barcus/bareos-api:21
    ports:
      - 8000:8000  # API端口
    environment:
      - BAREOS_DIR_HOST=bareos-dir

  smtpd:
    image: namshi/smtp  # SMTP服务器

构建命令

bash
# 克隆仓库
git clone https://github.com/barcus/bareos
cd bareos

# 构建各组件镜像
docker build -t director-pqsl:20-alpine director-pgsql/20-alpine
docker build -t storage:20-alpine storage/20-alpine
docker build -t client:20-alpine client/20-alpine
docker build -t webui:20-alpine webui/20-alpine

相关链接

• GitHub仓库：
  • https://github.com/barcus/bareos/tree/master/director-mysql
  • https://github.com/barcus/bareos/tree/master/director-pgsql
  • https://github.com/barcus/bareos/tree/master/storage
  • https://github.com/barcus/bareos/tree/master/client
  • https://github.com/barcus/bareos/tree/master/webui
• Docker Hub：https://hub.docker.com/r/barcus