tines/tines-pg-dump-binary

PostgreSQL 二进制备份恢复工具镜像

镜像概述

本Docker镜像集成了pg_dumpbinary和pg_dumprestore工具，专门用于PostgreSQL数据库的二进制备份与恢复操作。通过容器化方式提供轻量级、可移植的数据库备份解决方案，简化PostgreSQL数据备份与恢复流程。

核心功能与特性

• 工具集成：内置pg_dumpbinary（二进制备份工具）和pg_dumprestore（二进制恢复工具）
• 兼容性：支持主流PostgreSQL版本的二进制备份与恢复
• 轻量级：基于精简基础镜像构建，降低资源占用
• 灵活性：支持自定义数据库连接参数、备份路径及备份选项

使用场景

• PostgreSQL数据库的定期全量/增量二进制备份
• 跨环境数据库迁移（如开发环境到生产环境）
• 数据库故障后的快速恢复操作
• 大型PostgreSQL数据库的高效备份（相比文本备份更快）

使用方法

前置要求

• 已安装Docker环境
• 目标PostgreSQL数据库实例网络可达
• 具备数据库备份/恢复权限的用户账号

环境变量配置

备份操作示例

bash
docker run --rm \
  -e POSTGRES_HOST=postgres-server \
  -e POSTGRES_PORT=5432 \
  -e POSTGRES_USER=backupuser \
  -e POSTGRES_PASSWORD=securepassword \
  -e POSTGRES_DB=myappdb \
  -v /host/backup/path:/backup \
  pg-dumpbinary-image \
  pg_dumpbinary -h $POSTGRES_HOST -p $POSTGRES_PORT -U $POSTGRES_USER -d $POSTGRES_DB -f $BACKUP_DIR/backup_$(date +%Y%m%d_%H%M%S).dump

恢复操作示例

bash
docker run --rm \
  -e POSTGRES_HOST=postgres-server \
  -e POSTGRES_PORT=5432 \
  -e POSTGRES_USER=restoreuser \
  -e POSTGRES_PASSWORD=securepassword \
  -e POSTGRES_DB=restoredb \
  -v /host/backup/path:/backup \
  pg-dumpbinary-image \
  pg_dumprestore -h $POSTGRES_HOST -p $POSTGRES_PORT -U $POSTGRES_USER -d $POSTGRES_DB -f $BACKUP_DIR/backup_20240101_120000.dump

注意事项

1. 宿主机备份目录需提前创建并赋予适当权限
2. 恢复操作前建议停止目标数据库的写入服务，避免数据冲突
3. 大型数据库备份时建议增加--progress参数监控进度
4. 敏感信息（如密码）建议通过Docker Secrets或环境变量文件传递，避免明文暴露