popen2/postgres-backup-s3

PostgreSQL to S3 备份镜像

镜像概述

该Docker镜像提供PostgreSQL数据库到Amazon S3的自动化备份解决方案，集成pg_dump工具和AWS S3客户端，支持定时备份、备份文件压缩及S3存储管理，适用于需要可靠、自动化数据库备份的场景。

核心功能与特性

• 自动化备份：支持自定义备份间隔（如每日、每周），无需手动执行
• 备份压缩：默认使用gzip压缩备份文件，减少存储空间占用
• S3集成：直接将备份文件上传至指定S3桶，支持自定义存储路径
• 配置灵活：通过环境变量配置数据库连接、S3认证及备份策略
• 轻量级：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景

• 生产环境PostgreSQL数据库的定期备份
• 跨区域/跨账户的数据库备份存储
• 数据迁移或系统升级前的前置备份
• 需要长期归档的数据库历史数据备份

使用方法

环境变量配置

Docker Run 示例

bash
docker run -d \
  --name postgres-s3-backup \
  -e POSTGRES_HOST=postgres-prod \
  -e POSTGRES_PORT=5432 \
  -e POSTGRES_USER=backup_user \
  -e POSTGRES_PASSWORD=secure_password \
  -e POSTGRES_DB=app_db,user_db \
  -e S3_BUCKET=company-backups \
  -e S3_PATH=postgres/prod \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLEKEY \
  -e AWS_SECRET_ACCESS_KEY=example+secret+key \
  -e AWS_REGION=us-west-2 \
  -e BACKUP_INTERVAL=24h \
  -e BACKUP_RETENTION=30 \
  your-image-name:latest

Docker Compose 示例

yaml
version: '3'
services:
  postgres-backup:
    image: your-image-name:latest
    container_name: postgres-s3-backup
    environment:
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_USER: backup_user
      POSTGRES_PASSWORD: secure_password
      POSTGRES_DB: app_db
      S3_BUCKET: company-backups
      S3_PATH: postgres/staging
      AWS_ACCESS_KEY_ID: AKIAEXAMPLEKEY
      AWS_SECRET_ACCESS_KEY: example+secret+key
      AWS_REGION: eu-central-1
      BACKUP_INTERVAL: 12h
      BACKUP_RETENTION: 14
    restart: unless-stopped
    depends_on:
      - postgres

注意事项

• 权限要求：PostgreSQL用户需有pg_dump所需权限（CONNECT和SELECT权限）；AWS密钥需有S3桶的put-object和list-objects权限
• 网络要求：容器需能同时访问PostgreSQL数据库（网络连通性）和AWS S3服务（可通过VPC终端节点或公网访问）
• 备份验证：建议定期从S3下载备份文件，通过pg_restore验证备份有效性
• 敏感信息：生产环境建议通过Docker Secrets或环境变量加密管理数据库密码和AWS密钥