educandu/backup-restore-runner

MongoDB与S3备份恢复工具镜像

镜像概述

该Docker镜像提供了一套完整的工具集，用于MongoDB数据库的备份、恢复操作，以及与S3兼容存储桶的数据同步。通过容器化部署，简化了跨环境的数据备份与恢复流程，确保数据安全性和可移植性。

核心功能与特性

• MongoDB备份：支持全量备份MongoDB数据库，生成BSON格式备份文件
• S3集成：将备份文件自动上传至S3兼容存储桶，支持加密存储
• 恢复功能：从本地备份文件或S3存储桶恢复MongoDB数据
• 灵活性：支持自定义备份策略（如定时备份）和存储配置
• 轻量级：基于精简基础镜像，资源占用低，部署便捷

使用场景

• MongoDB数据库的日常备份与容灾
• 跨环境数据迁移（如开发环境到生产环境）
• 云环境与本地存储之间的数据同步
• 定期数据归档与长期保存

使用方法与配置说明

环境变量配置

Docker Run部署示例

单次备份

bash
docker run -d \
  -e MONGODB_URI="mongodb://user:password@mongodb-host:27017/mydb" \
  -e S3_ACCESS_KEY="your-access-key" \
  -e S3_SECRET_KEY="your-secret-key" \
  -e S3_BUCKET="my-backup-bucket" \
  -e S3_REGION="us-west-2" \
  --name mongodb-s3-backup \
  [镜像名称] backup

定时备份（每天凌晨2点执行）

bash
docker run -d \
  -e MONGODB_URI="mongodb://user:password@mongodb-host:27017/mydb" \
  -e S3_ACCESS_KEY="your-access-key" \
  -e S3_SECRET_KEY="your-secret-key" \
  -e S3_BUCKET="my-backup-bucket" \
  -e CRON_SCHEDULE="0 2 * * *" \
  --name mongodb-s3-backup-cron \
  [镜像名称] cron

从S3恢复数据

bash
docker run -d \
  -e MONGODB_URI="mongodb://user:password@mongodb-host:27017/mydb" \
  -e S3_ACCESS_KEY="your-access-key" \
  -e S3_SECRET_KEY="your-secret-key" \
  -e S3_BUCKET="my-backup-bucket" \
  -e BACKUP_FILE="20240520_backup.bson" \  # 指定S3中的备份文件名
  --name mongodb-s3-restore \
  [镜像名称] restore

Docker Compose配置示例

yaml
version: '3'
services:
  mongodb-backup:
    image: [镜像名称]
    environment:
      - MONGODB_URI=mongodb://user:password@mongodb:27017/mydb
      - S3_ACCESS_KEY=your-access-key
      - S3_SECRET_KEY=your-secret-key
      - S3_BUCKET=my-backup-bucket
      - S3_REGION=us-west-2
      - CRON_SCHEDULE=0 0 * * *  # 每天凌晨执行备份
    depends_on:
      - mongodb
    restart: always

  mongodb:
    image: mongo:latest
    ports:
      - "27017:27017"
    volumes:
      - mongodb_data:/data/db

volumes:
  mongodb_data:

注意事项

• 确保MongoDB服务与容器网络互通，或通过--network参数指定网络
• S3存储桶需配置适当的访问权限，确保容器可以读写
• 定时备份需确保容器持续运行（建议使用restart: always策略）
• 备份文件建议加密存储，可通过S3服务端加密功能实现