brabholdsa/backup

MariaDB/MySQL 与文件备份 Docker 镜像

镜像概述和主要用途

本镜像用于在 Docker 环境中备份 MariaDB 数据库（可能兼容 MySQL）和指定文件。支持通过 mariadb-backup 或 mariadb-dump 工具进行数据库备份，同时支持文件系统路径备份，并可配置备份保留策略。

Docker Hub 仓库地址：https://hub.docker.com/r/brabholdsa/backup

核心功能和特性

• 数据库备份：支持两种 MariaDB 备份方式
  • 使用 mariadb-backup（适用于 MariaDB ≥ 10.9）
  • 使用 mariadb-dump（默认启用）
• 文件备份：支持指定单个或多个文件/目录路径进行备份
• 备份保留策略：可设置数据库和文件备份的保留天数，自动清理过期备份
• 时区配置：支持自定义时区
• 灵活配置：通过环境变量自定义备份目录、数据库连接参数、文件路径等

使用场景和适用范围

• 需要定期备份 MariaDB 数据库和服务器文件的 Docker 环境
• 需自定义备份保留周期（如保留7天内备份）的场景
• 需同时备份数据库与关键配置文件/数据文件的场景
• 支持指定特定数据库和文件路径，满足个性化备份需求

支持的标签

• latest
  对应 Dockerfile：https://github.com/brabhold/docker-backup/blob/main/Dockerfile

核心脚本

镜像内置以下备份脚本，用于执行具体备份操作：

• /usr/local/bin/backup-db：数据库备份脚本
• /usr/local/bin/backup-files：文件备份脚本

环境变量配置

1. 数据库备份相关变量（DB）

2. 文件备份相关变量（Files）

3. MariaDB 连接必填变量

使用方法与部署示例

1. Docker Run 命令示例

以下示例启动一个备份容器，同时备份 MariaDB 数据库和指定文件，并将备份文件挂载到宿主机的 /data/backups 目录。

bash
docker run -d \
  --name mariadb-backup \
  -e TZ="Asia/Shanghai" \
  -e MARIADB_HOSTNAME="mariadb-container" \
  -e MARIADB_PORT="3306" \
  -e MARIADB_USER="backupuser" \
  -e MARIADB_PASSWORD="backuppassword" \
  -e MARIADB_DATABASE="mydb" \
  -e USE_MARIADB_DUMP="true" \
  -e MARIADB_BACKUP_RETENTION_DAYS="14" \
  -e FILES_TO_BACKUP="/app/data /config" \
  -e FILES_BACKUP_RETENTION_DAYS="14" \
  -v /data/backups:/backup \
  --link mariadb-container:mariadb \
  brabholdsa/backup:latest

说明：

• -v /data/backups:/backup：将宿主机的 /data/backups 目录挂载到容器的 /backup，确保备份文件持久化存储。
• --link mariadb-container:mariadb：若 MariaDB 运行在其他容器中，通过 --link 实现网络连通（或使用 Docker 网络别名）。
• 若使用 mariadb-backup（需 MariaDB ≥ 10.9），需额外挂载 MariaDB 数据目录：-v /path/to/mysql/data:/var/lib/mysql。

2. Docker Compose 配置示例

创建 docker-compose.yml 文件，配置如下：

yaml
version: '3.8'

services:
  backup:
    image: brabholdsa/backup:latest
    container_name: mariadb-backup
    restart: always
    environment:
      TZ: "Asia/Shanghai"
      # MariaDB 连接信息（必填）
      MARIADB_HOSTNAME: "mariadb"
      MARIADB_PORT: "3306"
      MARIADB_USER: "backupuser"
      MARIADB_PASSWORD: "backuppassword"
      MARIADB_DATABASE: "mydb"
      # 数据库备份配置
      USE_MARIADB_DUMP: "true"
      MARIADB_BACKUP_RETENTION_DAYS: "14"
      # 文件备份配置
      FILES_TO_BACKUP: "/app/data /config"
      FILES_BACKUP_RETENTION_DAYS: "14"
    volumes:
      - /data/backups:/backup  # 备份文件存储目录
      # 若使用 mariadb-backup，需添加以下挂载（替换为实际 MariaDB 数据目录）
      # - /var/lib/mysql:/var/lib/mysql
    depends_on:
      - mariadb  # 依赖 MariaDB 容器启动

  mariadb:
    image: mariadb:10.11
    container_name: mariadb
    restart: always
    environment:
      MARIADB_ROOT_PASSWORD: "rootpassword"
      MARIADB_USER: "backupuser"
      MARIADB_PASSWORD: "backuppassword"
      MARIADB_DATABASE: "mydb"
    volumes:
      - /data/mysql:/var/lib/mysql

启动命令：

bash
docker-compose up -d

注意事项

• 权限配置：使用 mariadb-backup 时，需确保 MariaDB 用户（MARIADB_USER）具有读取数据库文件系统的权限，并挂载 MariaDB 数据目录（/var/lib/mysql）到容器。
• 网络连通性：确保备份容器能访问 MariaDB 主机（通过 MARIADB_HOSTNAME 和 MARIADB_PORT 配置）。
• 备份路径：FILES_TO_BACKUP 需指定容器内的文件路径，若需备份宿主机文件，需先挂载到容器内。