baunach/postgres-backup

Postgres数据库备份镜像

镜像概述

该镜像基于标准Postgres镜像构建，主要用于Postgres数据库的备份，并支持通过aws cli将备份文件推送到S3兼容存储服务。当配置AWS_S3_BUCKET和AWS_S3_PATH环境变量时，aws cli会自动安装并启用S3备份功能。

核心功能与特性

• 基于标准Postgres镜像，确保与Postgres数据库的兼容性
• 支持将数据库备份文件推送到S3兼容存储服务
• 自动安装aws cli（当配置S3相关环境变量时）
• 通过环境变量灵活配置数据库连接信息和存储参数

使用场景

适用于需要定期备份Postgres数据库，并希望将备份文件存储到S3兼容对象存储的场景，如生产环境数据库备份、数据容灾等。

使用方法

环境变量配置

创建.env文件，配置数据库连接信息及（可选）S3存储参数：

bash
# Postgres数据库连接信息
POSTGRES_BACKUP_SOURCE_DB_HOST=localhost          # 数据库主机地址
POSTGRES_BACKUP_SOURCE_DB_PORT=5432               # 数据库端口
POSTGRES_BACKUP_SOURCE_USER=postgres              # 数据库用户名
POSTGRES_BACKUP_SOURCE_PASSWORD=mypassword        # 数据库密码
POSTGRES_BACKUP_SOURCE_DB_NAME=source_db          # 要备份的数据库名称

# 若使用S3存储，添加以下参数
POSTGRES_BACKUP_AWS_ACCESS_KEY_ID=                # AWS访问密钥ID
POSTGRES_BACKUP_AWS_SECRET_ACCESS_KEY=            # AWS密钥
POSTGRES_BACKUP_AWS_DEFAULT_REGION=               # AWS区域
POSTGRES_BACKUP_AWS_S3_BUCKET=                    # S3存储桶名称
POSTGRES_BACKUP_AWS_S3_PATH=                      # S3存储路径

运行容器

使用docker run命令运行容器，指定环境变量文件、本地备份目录挂载及网络：

bash
docker run --rm --env-file .env -v /desired/backup/path:/backup --network desired-network docker.xuanyuan.run/baunach/postgres-backup:latest

参数说明：

• --rm：容器退出后自动删除
• --env-file .env：加载环境变量配置文件
• -v /desired/backup/path:/backup：挂载本地目录到容器内的/backup目录，用于存储备份文件
• --network desired-network：指定与Postgres数据库相同的网络，确保容器可访问数据库
• baunach/postgres-backup:latest：镜像名称及标签（可指定特定版本如18.0）

配置参数说明