airfocusio/mongo-backup

mongo-backup镜像说明

镜像概述

本镜像提供MongoDB数据库的备份与恢复功能，支持将备份文件上传至S3兼容的对象存储服务，并可对备份文件进行GPG加密，同时具备清理指定时间前旧备份的能力，适用于数据库日常备份与灾难恢复场景。

核心功能

1. 备份MongoDB指定数据库的数据
2. 从S3兼容存储恢复指定的备份文件
3. 使用GPG对备份文件进行加密保护
4. 自动清理S3存储中超过指定时间的旧备份

使用场景

• 定期自动备份MongoDB数据库，保障数据安全
• 数据库灾难恢复时，从S3存储恢复历史备份
• 跨环境迁移MongoDB数据（通过备份与恢复操作）

配置说明

需通过环境变量配置以下参数：

• HOST: MongoDB服务器地址（如localhost）
• PORT: MongoDB端口（默认27017）
• DATABASE: 需备份/恢复的数据库名称
• USERNAME: MongoDB认证用户名（可选）
• PASSWORD: MongoDB认证密码（可选）
• AUTH_DATABASE: 认证数据库（默认admin）
• S3_HOST: S3兼容存储的地址（如[***]
• S3_ACCESS_KEY_ID: S3存储的访问密钥ID
• S3_ACCESS_KEY_SECRET: S3存储的访问密钥Secret
• S3_DIRECTORY: S3存储中存放备份的目录路径
• S3_CLEAN_OLDER_THAN: 清理超过指定时间的旧备份（如30d表示30天）
• S3_GPG_ENCRYPTION_PASSPHRASE: GPG加密的密码（可选）

部署示例

备份操作

bash
docker run --rm \
  -e HOST=localhost \
  -e PORT=27017 \
  -e DATABASE=mydatabase \
  -e USERNAME=user \
  -e PASSWORD=pass \
  -e AUTH_DATABASE=admin \
  -e S3_HOST=https://fra1.digitaloceanspaces.com \
  -e S3_ACCESS_KEY_ID=id \
  -e S3_ACCESS_KEY_SECRET=secret \
  -e S3_DIRECTORY=myspace/mongo-backup \
  -e S3_CLEAN_OLDER_THAN=30d \
  -e S3_GPG_ENCRYPTION_PASSPHRASE=secret \
  docker.xuanyuan.run/airfocusio/mongo-backup:4.0.9 \
  backup

恢复操作

bash
docker run --rm \
  -e HOST=localhost \
  -e PORT=27017 \
  -e DATABASE=mydatabase \
  -e USERNAME=user \
  -e PASSWORD=pass \
  -e AUTH_DATABASE=admin \
  -e S3_HOST=[***] \
  -e S3_ACCESS_KEY_ID=id \
  -e S3_ACCESS_KEY_SECRET=secret \
  -e S3_DIRECTORY=myspace/mongo-backup \
  airfocusio/mongo-backup:4.0.9 \
  restore 2019/2019-01/2019-01-01/2019-01-01-010203-mydatabase.mongodb.gz