0xff/postgres-backup

0xff/postgres-backup

这是一个轻量级的PostgreSQL每日备份解决方案，基于dcron（定时任务工具）和pg_dump（PostgreSQL官方备份工具）构建，依托Alpine Linux实现极小的镜像体积。

核心功能

• 每日自动执行PostgreSQL备份任务
• 支持多种备份格式（SQL文本、tar归档、自定义格式）
• 备份文件自动轮换（默认保留7天，可通过配置调整）
• 兼容libpq环境变量，方便数据库连接配置
• 轻量级镜像，资源占用低

使用场景

• 开发/测试环境中PostgreSQL数据库的日常备份需求
• 小型生产环境的数据定期保护
• 需要简单配置即可实现自动备份的场景

配置说明

基础使用（docker-compose）

yml
version: "2.2"
services:
  db:
    image: postgres:11-alpine
    environment:
      POSTGRES_PASSWORD: "9p4O6ICIGf9hmdA1GJFwDN8"
  backup:
    image: 0xff/postgres-backup
    environment:
      PGPASSWORD: "9p4O6ICIGf9hmdA1GJFwDN8"
    volumes:
      - ./pg-backups:/pg-backups

执行后，备份文件会存储在./pg-backups目录，默认保留7天，超过后自动覆盖旧备份。可通过环境变量自定义配置（默认值参考镜像Dockerfile），同时支持传递libpq环境变量。

高级使用

默认备份为SQL格式且保留7天，若需调整格式或保留周期，可修改PGDUMPOPTIONS环境变量。例如生成tar格式并保留一年的备份：

yml
  backup:
    environment:
      PGDUMPOPTIONS: "-F t -f /pg-backups/backup-$(date +%j).tar"

注意：在docker-compose.yml中需用$表示单个***符号，%j为日期格式（一年中的第几天），实现一年备份轮换。更多示例见镜像的example.yml。

恢复备份

进入容器后，使用pg_restore（tar/自定义格式）或psql（SQL格式）恢复：

tar/自定义格式恢复

查看备份内容：

sh
docker-compose exec backup pg_restore -l /pg-backups/backup-1.tar

恢复（覆盖现有数据）到postgres数据库：

sh
docker-compose exec backup pg_restore -d postgres --clean --if-exists /pg-backups/backup-1.tar

SQL格式恢复

默认SQL备份含--clean --if-exists参数，恢复会覆盖数据：

sh
docker-compose exec backup psql -f /pg-backups/backup-1.sql