coderat/pg_backup_rsynced

docker-pg_backup_rsynced

镜像概述

本Docker容器用于PostgreSQL数据库的自动备份与远程同步。它基于PostgreSQL官方推荐的pg_backup_rotated.sh脚本实现轮换式SQL备份，通过rsync工具将备份同步至远程存储，并借助msmtp发送备份错误日志邮件。Cron调度用于定期执行备份和同步任务。

核心功能

1. 轮换备份：生成每日/每周轮换备份，支持自定义保留周期（如保留7天日备份、5周周备份）。
2. 远程同步：通过rsync将本地备份同步至远程存储（需配置SSH密钥与known_hosts）。
3. 邮件通知：使用msmtp发送Cron任务的错误日志至指定***。
4. 灵活配置：支持通过环境变量或挂载自定义配置文件（crontab、pg_backup.config等）调整功能。

使用场景

• 企业或个人PostgreSQL数据库的定期备份需求。
• 需要将数据库备份同步至远程存储以增强数据安全性的场景。
• 希望自动接收备份错误通知的用户。

配置说明

环境变量

基础配置

• TZ：时区（如Asia/Shanghai）。
• REMOTE_BACKUP_STORAGE：rsync远程存储地址（格式：user@host:path/）。

PostgreSQL备份配置

• POSTGRES_HOSTNAME：数据库主机地址。
• POSTGRES_USER：数据库用户名（默认postgres）。
• POSTGRES_PASSWORD：数据库用户密码。
• WEEKS_TO_KEEP：每周备份保留周数（默认5）。
• DAYS_TO_KEEP：每日备份保留天数（默认7）。
• ENABLE_GLOBALS_BACKUPS：是否备份集群全局配置（如用户、密码，默认yes）。

邮件配置

• MAILTO：接收错误日志的***地址。
• MAIL_RELAY_HOST：邮件中继服务器地址。
• MAIL_PORT：邮件中继服务器端口（如587）。
• MAIL_USER：邮件服务器用户名。
• MAIL_PASSWORD：邮件服务器密码。

挂载目录

• ./backups:/mnt/backups：本地备份存储目录。
• ./config:/mnt/config：自定义配置文件目录（含crontab.txt、pg_backup.config等）。
• ./ssh/id_rsa:/root/.ssh/id_rsa：SSH私钥（用于rsync远程同步）。
• ./ssh/known_hosts:/root/.ssh/known_hosts：远程存储服务器的known_hosts文件。

部署示例

Docker Run命令

基础版

bash
docker run \
  --detach --name pg_backup_rsynced \
  -v /path/to/backups:/mnt/backups \
  -v /path/to/config:/mnt/config \
  -v /path/to/ssh/id_rsa:/root/.ssh/id_rsa \
  -v /path/to/ssh/known_hosts:/root/.ssh/known_hosts \
  -e TZ=Asia/Shanghai \
  -e POSTGRES_HOSTNAME=postgres_host \
  -e POSTGRES_USER=db_user \
  -e POSTGRES_PASSWORD=db_pass \
  coderat/pg_backup_rsynced

带邮件通知版

bash
docker run \
  --detach --name pg_backup_rsynced \
  -v /path/to/backups:/mnt/backups \
  -v /path/to/config:/mnt/config \
  -v /path/to/ssh/id_rsa:/root/.ssh/id_rsa \
  -v /path/to/ssh/known_hosts:/root/.ssh/known_hosts \
  -e TZ=Asia/Shanghai \
  -e POSTGRES_HOSTNAME=postgres_host \
  -e POSTGRES_USER=db_user \
  -e POSTGRES_PASSWORD=db_pass \
  -e MAIL_RELAY_HOST=mail.example.com \
  -e MAIL_PORT=587 \
  -e MAIL_FROM=pg_backup@example.com \
  -e MAIL_USER=backup_mail \
  -e MAIL_PASSWORD=mail_pass \
  -e MAILTO=admin@example.com \
  coderat/pg_backup_rsynced

Docker Compose示例

创建.env文件（参考sample.env），编写docker-compose.yml：

yaml
version: '2'
services:
  postgres:
    container_name: postgres_db
    image: postgres:alpine
    env_file: .env
    environment:
      - POSTGRES_DB=my_db
    expose:
      - '5432'

  pg_backup_rsynced:
    container_name: pg_backup_rsynced
    image: coderat/pg_backup_rsynced
    env_file: .env
    volumes:
      - ./data/backups:/mnt/backups
      - ./data/config:/mnt/config
      - ./data/ssh/id_rsa:/root/.ssh/id_rsa
      - ./data/ssh/known_hosts:/root/.ssh/known_hosts
    links:
      - postgres