barcus/bareos-client

bareos

![License badge][license-img] ![Based OS][os-based-ubuntu] ![Based OS][os-based-alpine] ![Badge amd64][arch-amd64-img] ![Badge arm64][arch-arm64/v8-img]

概述

本镜像包提供 [Bareos][bareos-href] 的相关镜像，包括以下模块：

镜像基于 Alpine 构建，具体标签信息见下文。

• Alpine镜像支持 linux/amd64 和 linux/arm64/v8 架构
• 每周构建（GMT+1时间周日4点）并发布到 [Docker Hub][docker-url]

标签

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, latest

bareos-api

• 21-alpine, 21, alpine, latest

部署要求

Bareos Director 需要：

• PostgreSQL
• SMTP守护进程（用于报告邮件路由）

Bareos Webui 需要：

• PHP-FPM

Bareos Client (fd) 和 Storage (sd) 无依赖。

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

环境要求

• [Docker][docker-href] 及 [docker-compose][docker-compose-href]

使用方法

定义所需环境变量

声明环境变量，或将 .env.dist 复制为 .env 并调整值。

所有密码应在 .env 文件中定义，生产环境建议不要使用 .env.dist 中的默认密码。

最后，确保更新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: 这些docker-compose文件配置为将数据存储在 /data/(bareos|mysql|pgsql)。

容器启动后，可通过WebUI、CLI或API访问Bareos。

访问WebUI

在浏览器中打开 http://your-docker-host:8080，登录：

（用户：admin / 密码：<BAREOS_WEBUI_PASSWORD>）

访问bconsole

bash
docker exec -it bareos-dir bconsole

访问API

（需要Bareos 20+ 及Bareos命名控制台）

在浏览器中打开 http://your-docker-host:8000/docs，点击"Authorize"登录。

或使用curl示例：

获取令牌（返回包含令牌的JSON对象）：

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=ThisIsMySecretUIp4ssw0rd&scope=&client_id=&client_secret='

使用Bareos-webui管理员用户凭证，该用户在Bareos-director中配置为命名控制台。

返回结果：

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

使用令牌读取所有客户端配置（类似bconsole）：

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

将返回包含所有客户端配置的JSON文件。

访问Prometheus指标

在浏览器中打开 http://your-docker-host:9625/metrics 查看可用指标。

更多关于 [Bareos exporter][bareos-exporter-href] 的信息，感谢@vierbergenlars。

指标应由 [Prometheus][prometheus-href] 服务器抓取。

官方文档

更多Bareos配置和使用信息，请参考 [官方文档][bareos-doc]。

数据库迁移（MySQL到PostgreSQL）

由于Bareos版本 >= 21.0.0 不再提供MySQL数据库后端，需使用Bareos 20将现有MySQL目录迁移到PostgreSQL。为此，先升级到Bareos 20，然后使用 [此docker-compose文件][compose-db-migration-href] 备份（可选）整个Bareos MySQL目录并复制到新的PostgreSQL目录数据库。

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

:warning: 不要忘记包含所需密码的 .env 文件！

PostgreSQL数据库升级

兼容性

目前，最新的Ubuntu基础镜像兼容PostgreSQL 12及以下，Alpine镜像兼容PostgreSQL 14。这取决于转储Bareos数据库所需的 pg_dump 版本。

Ubuntu镜像：

• Bareos v19 -> PostgreSQL v10及以下
• Bareos v20+ -> PostgreSQL v12及以下

Alpine镜像：

• Bareos v19 -> PostgreSQL v13及以下
• Bareos v20+ -> PostgreSQL v14及以下

工具

主要思路是使用 [postgresql-upgrade][psql-upgrade-href] Docker镜像。它将创建新的PostgreSQL实例，然后使用 pg_upgrade 工具将所有数据库从旧实例迁移到新实例。

操作步骤：找到PostgreSQL数据文件夹（根据docker-compose文件，可能为/data/pgsql/data），确定初始化实例的用户（postgres？pgsql？root？）。

示例：数据源为 /data/pgsql/data，管理员用户为postgres。

运行：

bash
docker run -t -i \
  -e PG_NEW=12 \
  -e PGUSER=postgres \
  -v /data/pgsql/data:/pg_old/data \
  -v /data/pgsql-new/data:/pg_new/data \
  barcus/postgresql-upgrade

迁移成功后，使用新文件夹 /data/pgsql-new/data 和docker-compose文件中相关的PostgreSQL版本。

构建

docker-compose文件

使用以下模板构建自定义docker-compose文件：

yml
version: '3'
services:
  bareos-dir:
    image: barcus/bareos-director:latest # 基于Ubuntu的最新director-pgsql
    volumes:
      - <BAREOS_CONF_PATH>:/etc/bareos
      - <BAREOS_DATA_PATH>:/var/lib/bareos # MyCatalog备份所需
    environment:
      - DB_INIT=false
      - DB_UPDATE=false
      - DB_HOST=bareos-db
      - DB_PORT=3306
      - DB_NAME=bareos
      - DB_USER=bareos
      - DB_PASSWORD=${DB_PASSWORD} # 在.env文件中定义
      - DB_ADMIN_USER=${DB_ADMIN_USER} # 在.env文件中定义
      - DB_ADMIN_PASSWORD=${DB_ADMIN_PASSWORD} # 在.env文件中定义
      - BAREOS_FD_HOST=bareos-fd
      - BAREOS_FD_PASSWORD=${BAREOS_FD_PASSWORD} # 在.env文件中定义
      - BAREOS_SD_HOST=bareos-sd
      - BAREOS_SD_PASSWORD=${BAREOS_SD_PASSWORD} # 在.env文件中定义
      - BAREOS_WEBUI_PASSWORD=${BAREOS_WEBUI_PASSWORD} # 在.env文件中定义
      - SMTP_HOST=smtpd
      - SENDER_MAIL=your-sender@mail.address # 可选
      - ADMIN_MAIL=your@mail.address # 请修改！
      # 可选：通过Slack或Telegram接收备份通知
      - WEBHOOK_NOTIFICATION=true # true或false，设为true将禁用邮件通知
      - WEBHOOK_TYPE=slack # 选择slack或telegram
      - WEBHOOK_URL= # 设置slack或telegram URL
      - WEBHOOK_CHAT_ID= # 仅Telegram需要设置<chat_id>
    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} # 在.env文件中定义

  bareos-fd:
    image: barcus/bareos-client:latest
    volumes:
      - <BAREOS_CONF_PATH>:/etc/bareos
      - <BAREOS_DATA_PATH>:/var/lib/bareos-director # MyCatalog备份所需
    environment:
      - BAREOS_FD_PASSWORD=${BAREOS_FD_PASSWORD} # 在.env文件中定义
      - FORCE_ROOT=false

  bareos-webui:
    image: barcus/bareos-webui:latest
    ports:
      - 8080:80
    environment:
      - BAREOS_DIR_HOST=bareos-dir
      - SERVER_STATS=yes # 可选，启用apache服务器统计
    volumes:
      - <BAREOS_CONF_PATH>:/etc/bareos-webui

  #bareos-db:
  #  image: mysql:5.6
  #  volumes:
  #    - <DB_DATA_PATH>:/var/lib/mysql
  #  environment:
  #    - MYSQL_ROOT_PASSWORD=${DB_ADMIN_PASSWORD} # 在.env文件中定义

  bareos-db:
    image: postgres:12
    volumes:
      - <DB_DATA_PATH>:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=${DB_ADMIN_USER} # 在.env文件中定义
      - POSTGRES_PASSWORD=${DB_ADMIN_PASSWORD} # 在.env文件中定义
      - POSTGRES_INITDB_ARGS=--encoding=SQL_ASCII

  bareos-api:
    image: barcus/bareos-api:21
    ports:
    - 8000:8000
    environment:
    - BAREOS_DIR_HOST=bareos-dir

  smtpd:
    image: namshi/smtp

Bareos Director (bareos-dir)

• <BAREOS_CONF_PATH>：主机端Director配置文件夹路径（可选/推荐）
• <BAREOS_DATA_PATH>：主机端Director数据文件夹路径（推荐）
• DB_NAME：Bareos数据库名称
• DB_USER：Bareos数据库用户
• DB_PASSWORD：访问Bareos数据库的密码
• DB_ADMIN_USER：用于初始化Bareos用户和数据库的管理员用户
• DB_ADMIN_PASSWORD：数据库系统访问密码
• SMTP_HOST：SMTP容器名称
• ADMIN_MAIL：管理员***地址
• SENDER_MAIL：发送邮件的***地址（可选，默认使用ADMIN_MAIL值）
• WEBHOOK_NOTIFICATION=true # true或false，设为true将禁用邮件通知
• WEBHOOK_TYPE=slack # 选择slack或***
• WEBHOOK_URL= # 设置slack或*** URL（例如slack: <[***]>）
• WEBHOOK_CHAT_ID= # 仅***需要设置'chat_id'

Bareos Storage Daemon (bareos-sd)

• <BAREOS_CONF_PATH>：主机端Storage配置文件夹路径（可选/推荐）
• <BAREOS_BKP_VOLUME_PATH>：主机端数据文件夹路径（可选）
• BAREOS_SD_PASSWORD：需与Bareos Director部分相同

Bareos Client/File Daemon (bareos-fd)

• <BAREOS_CONF_PATH>：主机端Client配置文件夹路径（可选/推荐）
• <BAREOS_DATA_PATH>：访问Director数据文件夹的路径（推荐）
• BAREOS_FD_PASSWORD：需与Bareos Director部分相同
• FORCE_ROOT：设为true以root权限运行Bareos

数据库MySQL或PostgreSQL (bareos-db)

作为目录后端必需，使用官方MySQL/PostgreSQL镜像：

• <DB_DATA_PATH>：主机端MySQL/PostgreSQL数据路径
• MYSQL_ROOT_PASSWORD：MySQL root用户密码（仅DB初始化需要）
• POSTGRES_PASSWORD：PostgreSQL root用户密码（仅DB初始化需要）

Bareos webUI (bareos-webui)

• <BAREOS_CONF_PATH>：主机端WebUI配置文件夹路径（可选）
• 默认用户：admin

:warning: 注意 *_HOST 变量需设置为容器名称。

自定义Docker镜像

构建自定义Bareos镜像：

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

构建自定义Xenial基础系统镜像：

bash
git clone https://github.com/rockyluke/docker-ubuntu
cd docker-ubuntu
./build.sh -d xenial

感谢@rockyluke :)

链接

更多信息请访问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
• https://github.com/rockyluke/docker-ubuntu

我的Docker