paunin/pg-backupper

pg-backupper镜像

镜像概述

这是一个针对PostgreSQL数据库的定时备份Docker镜像，支持同时配置多个数据库连接（最多99个），并通过自定义策略自动管理备份文件的保留与清理，满足不同场景下的备份需求。

核心功能

• 多数据库连接支持：最多可配置99个独立的数据库备份任务
• 定时调度：基于Cron表达式自定义备份执行时间
• 智能保留策略：按天、周、月分别保留指定数量的备份文件
• 自动清理：超出保留策略的旧备份文件将被自动删除
• 灵活配置：每个备份任务可独立设置数据库连接参数、备份选项及保留规则

使用场景

• 个人或企业用户定期备份PostgreSQL数据库的场景
• 需要自动化管理备份文件生命周期的环境
• 多数据库实例需统一备份调度的场景
• 对备份保留周期有精细化要求的场景

配置说明

每个数据库连接（序号1-99）需配置以下参数：

• BACKUP_NAME_[1..99]：备份文件名称前缀
• SCHEDULE_[1..99]：Cron格式的备份调度时间（默认：0 0 * * *）
• BACKUP_DIR_[1..99]：备份文件存储目录（默认：/data）
• BACKUP_DB_HOST_[1..99]：数据库主机地址（默认：localhost）
• BACKUP_DB_PORT_[1..99]：数据库端口（默认：5432）
• BACKUP_DB_NAME_[1..99]：数据库名称（默认：template1）
• BACKUP_DB_USER_[1..99]：数据库用户名（默认：postgres）
• BACKUP_DB_PASSWORD_[1..99]：数据库密码（默认：空字符串）
• BACKUP_OPTIONS_[1..99]：pg_dump工具的额外选项（默认：空字符串）
• SAFE_DAYS_[1..99]：保留每日备份的天数（默认：7）
• SAFE_WEEKS_[1..99]：保留每周备份的周数（默认：4）
• SAFE_WEEK_DAY_[1..99]：每周保留备份的星期几（默认：Monday）
• SAFE_MONTHS_[1..99]：保留每月备份的月数（默认：6）
• SAFE_MONTH_DATE_[1..99]：每月保留备份的日期（默认：1，取值范围1-28）

部署示例

Docker Run命令

bash
docker run -d \
  -v /host/backup/dir:/data \
  -e BACKUP_NAME_1="prod_db_backup" \
  -e SCHEDULE_1="23 0 * * *" \
  -e BACKUP_DB_HOST_1="postgres-prod" \
  -e BACKUP_DB_NAME_1="prod_db" \
  -e BACKUP_DB_USER_1="backup_user" \
  -e BACKUP_DB_PASSWORD_1="backup_pass" \
  -e SAFE_DAYS_1="14" \
  -e SAFE_WEEKS_1="8" \
  docker.xuanyuan.run/paunin/pg-backupper

Docker Compose示例

yaml
version: '3.8'
services:
  pg-backupper:
    image: paunin/pg-backupper
    volumes:
      - ./backup_data:/data
    environment:
      # 第一个数据库备份任务
      - BACKUP_NAME_1=blog_db_backup
      - SCHEDULE_1=0 */6 * * *
      - BACKUP_DB_HOST_1=postgres
      - BACKUP_DB_PORT_1=5432
      - BACKUP_DB_NAME_1=blog_db
      - BACKUP_DB_USER_1=postgres
      - BACKUP_DB_PASSWORD_1=my_secure_password
      - SAFE_DAYS_1=7
      - SAFE_WEEKS_1=4
      - SAFE_MONTHS_1=6
      # 第二个数据库备份任务（可选）
      - BACKUP_NAME_2=user_db_backup
      - SCHEDULE_2=15 */12 * * *
      - BACKUP_DB_HOST_2=postgres
      - BACKUP_DB_NAME_2=user_db
      - BACKUP_DB_USER_2=postgres
      - BACKUP_DB_PASSWORD_2=another_secure_password