barcus/bareos-director

Bareos Docker镜像

关于

提供Bareos的镜像，包含以下模块：

镜像基于Alpine，标签信息见下文：

• Alpine镜像支持linux/amd64和linux/arm64/v8平台
• 每周构建在周日4:00（GMT+1）部署到https://registry.hub.docker.com/r/barcus

标签

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（数据库）和SMTP守护进程（邮件报告）
• Bareos Webui：需要PHP-FPM
• 客户端（fd）和存储守护进程（sd）：无依赖

部署架构

各组件需在独立容器中运行，并通过docker-compose链接，详见下文示例。

依赖要求

• Docker 及 docker-compose

使用方法

定义环境变量

声明环境变量或复制.env.dist为.env并调整值，所有密码应在.env中定义（生产环境建议不使用默认密码）。确保更新docker-compose文件中的ADMIN_MAIL、DB_USER等变量。

运行docker-compose

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

Alpine和Ubuntu基础的docker-compose文件：

:file_folder: 上述文件默认将数据存储在/data/(bareos|mysql|pgsql)目录。

访问方式

WebUI

打开http://your-docker-host:8080，登录凭据：

• 用户：admin
• 密码：<BAREOS_WEBUI_PASSWORD>（在.env中定义）

bconsole

bash
docker exec -it bareos-dir bconsole

API（Bareos 20+）

1. 获取访问令牌：

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=你的WebUI密码&scope=&client_id=&client_secret='

返回示例：

json
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer"
}

2. 使用令牌访问API（如获取客户端配置）：

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

Prometheus指标

访问http://your-docker-host:9625/metrics查看指标，需由Prometheus抓取。更多信息见https://github.com/vierbergenlars/bareos_exporter。

官方文档

详细配置与使用说明参见Bareos官方文档。

数据库迁移（MySQL到PostgreSQL）

Bareos ≥21.0.0不再支持MySQL，需使用Bareos 20迁移现有MySQL目录：

1. 升级到Bareos 20
2. 使用https://github.com/barcus/bareos/blob/master/bareos-db-migration/docker-compose.yml备份MySQL数据并迁移到PostgreSQL（自动创建空PostgreSQL数据库）

:warning: 需确保.env文件包含所有必要密码！

PostgreSQL数据库升级

兼容性矩阵

升级工具

使用https://github.com/barcus/postgresql-upgrade镜像迁移数据：

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

迁移后使用新数据目录和对应PostgreSQL版本。

构建指南

docker-compose模板

yaml
version: '3'
services:
  bareos-dir:
    image: barcus/bareos-director:latest
    volumes:
      - <配置路径>:/etc/bareos
      - <数据路径>:/var/lib/bareos  # MyCatalog备份必需
    environment:
      - DB_HOST=bareos-db
      - DB_NAME=bareos
      - DB_USER=${DB_USER}
      - DB_PASSWORD=${DB_PASSWORD}
      - BAREOS_FD_PASSWORD=${BAREOS_FD_PASSWORD}
      - BAREOS_SD_PASSWORD=${BAREOS_SD_PASSWORD}
      - ADMIN_MAIL=your@mail.address  # 管理员邮箱
      - SMTP_HOST=smtpd  # SMTP容器名
      # 可选通知配置
      - WEBHOOK_NOTIFICATION=true  # 启用Slack/Telegram通知（禁用邮件）
      - WEBHOOK_TYPE=slack  # 通知类型
      - WEBHOOK_URL=通知URL
    depends_on:
      - bareos-db

  bareos-sd:
    image: barcus/bareos-storage:latest
    ports:
      - 9103:9103
    volumes:
      - <配置路径>:/etc/bareos
      - <备份卷路径>:/var/lib/bareos/storage
    environment:
      - BAREOS_SD_PASSWORD=${BAREOS_SD_PASSWORD}

  bareos-fd:
    image: barcus/bareos-client:latest
    volumes:
      - <配置路径>:/etc/bareos
      - <数据路径>:/var/lib/bareos-director
    environment:
      - BAREOS_FD_PASSWORD=${BAREOS_FD_PASSWORD}
      - FORCE_ROOT=false  # 是否以root运行

  bareos-webui:
    image: barcus/bareos-webui:latest
    ports:
      - 8080:80
    environment:
      - BAREOS_DIR_HOST=bareos-dir

  bareos-db:
    image: postgres:12
    volumes:
      - <数据库路径>:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=${DB_ADMIN_USER}
      - POSTGRES_PASSWORD=${DB_ADMIN_PASSWORD}

  smtpd:
    image: namshi/smtp  # SMTP服务

自定义镜像构建

bash
git clone https://github.com/barcus/bareos
cd bareos
# 构建各组件
docker build -t director-pgsql:20-alpine director-pgsql/20-alpine
docker build -t storage:20-alpine storage/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://registry.hub.docker.com/r/barcus