popen2/postgres-backup-s3 Docker Image Overview

popen2/postgres-backup-s3

用于将PostgreSQL数据库备份到Amazon S3的Docker镜像，支持定时备份、备份压缩和S3存储集成，简化数据库备份流程。

0 次下载activepopen2镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

PostgreSQL to S3 备份镜像

镜像概述

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

核心功能与特性

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

使用场景

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

使用方法

环境变量配置

环境变量	描述	是否必填	默认值
`POSTGRES_HOST`	PostgreSQL数据库主机地址	是	-
`POSTGRES_PORT`	PostgreSQL数据库端口	否	5432
`POSTGRES_USER`	数据库访问用户名	是	-
`POSTGRES_PASSWORD`	数据库访问密码	是	-
`POSTGRES_DB`	需备份的数据库名（多个数据库用逗号分隔）	否	所有数据库
`S3_BUCKET`	目标S3桶名称	是	-
`S3_PATH`	S3桶内存储路径（如`postgres/backups`）	否	`/`
`AWS_ACCESS_KEY_ID`	AWS访问密钥ID（需有S3写入权限）	是	-
`AWS_SECRET_ACCESS_KEY`	AWS密钥密钥	是	-
`AWS_REGION`	S3桶所在AWS区域	否	`us-east-1`
`BACKUP_INTERVAL`	备份间隔（支持`s`/`m`/`h`单位，如`24h`）	否	`24h`
`BACKUP_RETENTION`	S3中保留备份文件数量（0为不删除旧备份）	否	0
`BACKUP_PREFIX`	备份文件前缀（用于区分不同实例）	否	`pg_backup_`

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密钥