onesystems/dockerbackup

Docker备份容器

基于Alpine的轻量级容器，用于定时备份目录和数据库，支持保留策略、清理旧备份，并通过Nextcloud Talk Bot和邮件发送通知。

🚀 核心功能

• ✅ 文件备份（tar.gz格式）
• ✅ PostgreSQL、MariaDB和MySQL数据库备份（.sql.gz格式）
• ✅ Cron定时调度
• ✅ 容器启动时初始备份
• ✅ 基于保留期的清理（删除旧备份）
• ✅ Talk Bot通知（基于HMAC）
• ✅ 可选SMTP邮件通知
• ✅ 过期锁文件清理（1小时后）
• ✅ 文件+控制台统一日志（带时间戳）
• ✅ 用于通知的自定义容器/服务/堆栈标签

📦 环境变量

📁 通用配置

🛢️ 数据库配置（可选）

设置 DB_TYPE=postgres、mariadb、mysql 或 none（不备份数据库）

PostgreSQL：

MariaDB：

MySQL：

💬 Nextcloud Talk Bot（HMAC）

📧 邮件通知（可选）

📦 使用内置的 msmtp 发送邮件

🧪 示例 docker-compose.yml

yaml
version: '3'

services:
  backup:
    build: .
    environment:
      FILES_TO_BACKUP: "/data"
      BACKUP_DIR: "/backup"
      LOG_DIR: "/log"
      RETENTION_DAYS: 30
      CRON_SCHEDULE: "0 * * * *"

      BACKUP_NAME: "web-backup-db"

      DB_TYPE: "postgres"
      POSTGRES_HOST: "postgres"
      POSTGRES_USER: "backupuser"
      POSTGRES_PASSWORD: "secret"
      POSTGRES_DATABASE: "myapp"

      NC_TALK_NOTIFY: "off"
      NC_TALK_URL: "https://cloud.example.com"
      NC_TALK_BOT_CHANNEL: "abc123"
      NC_TALK_BOT_SECRET: "your_shared_hmac_secret"

      EMAIL_NOTIFY: "off"
      EMAIL_TO: "alerts@example.com"
      EMAIL_FROM: "backup@host.local"
      SMTP_SERVER: "smtp.example.com"
      SMTP_PORT: 587
      SMTP_USER: "smtp-user"
      SMTP_PASS: "smtp-pass"
      SMTP_TLS: "on"

    volumes:
      - ./data:/data
      - ./backup:/backup
      - ./log:/log

📂 文件夹结构

text
/backup/
  2025-04/
    files_data_2025-04-30_1400.tar.gz
    postgres_myapp_2025-04-30_1400.sql.gz
/log/
  backup_2025-04-30.log

🧹 清理策略

自动删除超过 RETENTION_DAYS 天的备份，日志中会记录已删除的文件。

🩺 健康检查（可选）

在Compose文件中添加以下配置以跟踪备份成功状态：

yaml
healthcheck:
  test: ["CMD", "/scripts/healthcheck.sh"]
  interval: 5m
  timeout: 10s
  retries: 3
  start_period: 30s

备份脚本仅在成功时生成健康检查所需文件

🧑‍💻 作者

• Michael Kleger
  OneSystems GmbH

  ---

📝 许可证

MIT许可证 - 商业和私人使用均免费。