frekele/helicopterizer

Helicopterizer

开源的Docker容器备份与恢复解决方案，专为云环境设计！

镜像概述

Helicopterizer是一款开源工具，用于Docker容器的备份与恢复，支持将容器数据存储到云服务提供商（如AWS S3）。它提供灵活的备份策略，包括tarball打包、文件同步、定时任务调度等功能，帮助用户保护云环境中的容器数据。

核心功能

• 备份方式：支持tarball打包备份和文件同步备份两种模式；
• 定时任务：通过Cron表达式设置定时备份/恢复任务；
• 数据压缩：默认启用GZIP压缩，可自定义关闭；
• 云存储支持：当前支持AWS S3，未来计划支持Azure、Google Cloud等；
• 灵活配置：自定义数据路径、备份前缀、排除文件、存储桶自动创建等；
• 恢复选项：支持恢复前清空数据目录（需谨慎使用）。

使用场景

• 云环境中Docker容器的数据备份（如Jenkins、Nexus等应用容器）；
• 定时自动备份容器数据到AWS S3；
• 从云存储恢复容器数据到本地环境；
• 跨环境迁移容器数据。

配置说明

基础使用命令

bash
docker run -d [环境变量] [-v|--volumes-from] frekele/helicopterizer [backup|restore] [--tarball|--sync]

稳定版（生产环境）

bash
docker run -d frekele/helicopterizer:stable

开发版（最新）

bash
docker run -d frekele/helicopterizer:latest

环境变量配置

通用环境变量

AWS S3专用环境变量

使用示例

AWS S3备份（Tarball模式）

bash
docker run --rm \
-e STORAGE_PROVIDER=AWS \
-e AWS_ACCESS_KEY_ID=你的AWS访问密钥ID \
-e AWS_SECRET_ACCESS_KEY=你的AWS秘密访问密钥 \
-e AWS_S3_BUCKET_NAME=s3://my-bucket-backup/ \
-v /本地数据路径:/data:ro \
frekele/helicopterizer backup --tarball

AWS S3恢复（Tarball模式）

bash
docker run --rm \
-e STORAGE_PROVIDER=AWS \
-e AWS_ACCESS_KEY_ID=你的AWS访问密钥ID \
-e AWS_SECRET_ACCESS_KEY=你的AWS秘密访问密钥 \
-e AWS_S3_BUCKET_NAME=s3://my-bucket-backup/ \
-e BACKUP_VERSION='2024-01-01T12:00:00Z' \
-v /本地数据路径:/data:rw \
frekele/helicopterizer restore --tarball

定时备份（每小时一次）

bash
docker run -d \
-e STORAGE_PROVIDER=AWS \
-e AWS_ACCESS_KEY_ID=你的AWS访问密钥ID \
-e AWS_SECRET_ACCESS_KEY=你的AWS秘密访问密钥 \
-e AWS_S3_BUCKET_NAME=s3://my-bucket-backup/ \
-e CRON_SCHEDULE='0 * * * *' \
-v /本地数据路径:/data:ro \
frekele/helicopterizer backup --tarball

许可证

Helicopterizer基于MIT许可证开源，详情请查看项目仓库中的LICENSE文件。

更多信息请访问项目GitHub仓库：https://github.com/frekele/helicopterizer