jaaaco/s3-backup-restore

S3备份/恢复容器

该容器用于将数据备份到AWS S3或从S3恢复数据。默认启动时处于等待模式，可通过docker exec命令触发备份或恢复操作；也可启用定时任务模式，按指定Cron表达式自动执行备份。

核心功能

• 支持手动执行备份和恢复操作
• 支持定时任务自动备份（配置CRON_SCHEDULE）
• 结合S3版本控制和生命周期规则管理备份文件的保留周期

使用场景

• 网站应用（如WordPress）的数据定期备份
• 数据库文件的安全备份与恢复
• 本地数据到AWS S3的存储与恢复需求

配置说明

必要环境变量

• AWS_ACCESS_KEY_ID: 拥有S3 put-object和get-object权限的AWS用户密钥ID
• AWS_SECRET_ACCESS_KEY: 对应的AWS用户密钥
• S3BUCKET: 目标S3桶名称

可选环境变量

• FILEPREFIX: 备份文件前缀，默认值为"backup"
• CRON_SCHEDULE: 定时任务的Cron表达式，默认值为"4 4 * * *"（每天凌晨4点04分）

部署示例

Docker Compose配置

yaml
version: '3.3'
services:
  app:
    image: wordpress
    environment:
      WORDPRESS_DB_HOST: mysql
      WORDPRESS_DB_PASSWORD: password
    volumes:
      - data-volume:/var/www/html
  mysql:
    image: mysql:5.7
    volumes:
      - "${pwd}/my.cnf:/etc/mysql/my.cnf"
    environment:
      MYSQL_ROOT_PASSWORD: password
  files-backup:
    image: jaaaco/s3-backup-restore
    depends_on:
      - app
    volumes:
      - data-volume:/data
    environment:
      S3BUCKET: <你的S3桶名称>
      AWS_ACCESS_KEY_ID: <你的AWS密钥ID>
      AWS_SECRET_ACCESS_KEY: <你的AWS密钥>
      FILEPREFIX: my-app-files
      CRON_SCHEDULE: 4 4 * * *
volumes:
  data-volume:

手动操作命令

执行备份

bash
docker exec <运行中的容器ID> /command backup

从最新备份恢复

bash
docker exec <运行中的容器ID> /command restore

启用定时任务

在docker-compose.yml的files-backup服务中添加command: /command cron即可启用定时备份功能。