avencera/postgres-s3-backup
avencera
自动构建
用于将PostgreSQL数据库备份到S3的小型脚本集，支持定期备份。
下载次数: 0状态：自动构建维护者：avencera仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
postgres-backup-s3
镜像概述
postgres-backup-s3是一个用于将PostgreSQL数据库备份到Amazon S3存储的Docker镜像，提供简单的脚本集合，支持手动备份和基于定时任务的自动定期备份。
核心功能与特性
- 支持将PostgreSQL数据库备份文件存储到Amazon S3
- 提供手动触发备份和自动定期备份两种模式
- 可配置S3存储路径（通过前缀指定）
- 支持自定义PostgreSQL备份选项（如指定模式、包含二进制大对象等）
- 轻量级设计，易于集成到现有Docker环境
使用场景
适用于需要定期备份PostgreSQL数据库并将备份文件安全存储到云端的场景，包括：
- 生产环境数据库的日常备份
- 开发/测试环境数据的定期保护
- 需要异地存储备份的业务需求
使用方法
Docker 运行
直接通过Docker命令执行备份：
sh$ docker run -e S3_ACCESS_KEY_ID=密钥 -e S3_SECRET_ACCESS_KEY=密钥 -e S3_BUCKET=我的桶 -e S3_PREFIX=备份 -e POSTGRES_DATABASE=数据库名 -e POSTGRES_USER=用户 -e POSTGRES_PASSWORD=密码 -e POSTGRES_HOST=localhost avencera/postgres-s3-backup
容器内手动执行
进入容器后手动触发备份脚本：
shsh backup.sh
Docker Compose 配置
集成到现有服务架构中：
yamlpostgres: image: docker.xuanyuan.run/postgres environment: POSTGRES_USER: 用户 POSTGRES_PASSWORD: 密码 pgbackups3: image: docker.xuanyuan.run/avencera/postgres-s3-backup links: - postgres environment: SCHEDULE: '@daily' # 每日自动备份 S3_REGION: 区域 S3_ACCESS_KEY_ID: 密钥 S3_SECRET_ACCESS_KEY: 密钥 S3_BUCKET: 我的桶 S3_PREFIX: 备份 POSTGRES_DATABASE: 数据库名 POSTGRES_USER: 用户 POSTGRES_PASSWORD: 密码 POSTGRES_EXTRA_OPTS: '--schema=public --blobs' # 额外备份选项
配置说明
环境变量参数
| 环境变量 | 描述 |
|---|---|
| S3_ACCESS_KEY_ID | Amazon S3访问密钥ID |
| S3_SECRET_ACCESS_KEY | Amazon S3密钥 |
| S3_BUCKET | 存储备份的S3桶名称 |
| S3_PREFIX | S3中的备份文件前缀（路径） |
| S3_REGION | S3区域（可选，未指定时使用默认区域） |
| POSTGRES_DATABASE | 要备份的PostgreSQL数据库名称 |
| POSTGRES_USER | PostgreSQL数据库用户名 |
| POSTGRES_PASSWORD | PostgreSQL数据库密码 |
| POSTGRES_HOST | PostgreSQL数据库主机地址（Docker Compose中可使用服务名，如postgres） |
| SCHEDULE | 定期备份计划（cron语法，如@daily表示每日备份） |
| POSTGRES_EXTRA_OPTS | 传递给pg_dump的额外选项（如--schema=public --blobs） |
自动定期备份
通过设置SCHEDULE环境变量实现自动备份。支持的预定义计划包括：
@daily：每日备份@weekly：每周备份@monthly：每月备份@yearly：每年备份
自定义cron表达式格式为分 时 日 月 周，例如0 3 * * *表示每天凌晨3点执行备份。更多定时规则可参考http://godoc.org/github.com/robfig/cron#hdr-Predefined_schedules%E3%80%82
项目来源
本镜像基于以下项目分叉：https://github.com/schickling/dockerfiles/tree/master/postgres-backup-s3
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 postgres-s3-backup 镜像标签
docker pull docker.xuanyuan.run/avencera/postgres-s3-backup:<标签>
DockerHub 原生拉取命令
docker pull avencera/postgres-s3-backup:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"