gtriggiano/gitea-backup-s3

gitea-backup-s3

Gitea代码仓库服务器提供dump命令，可将所有仓库、配置和数据库打包为单个.zip文件。本镜像通过定时任务执行该备份操作，并自动将结果文件传输至S3存储桶。

核心功能

• 定时触发Gitea数据备份（包含仓库、配置、数据库）
• 自动将备份文件上传至S3兼容存储服务（如AWS S3、Minio）
• 支持S3服务器端加密、签名版本配置
• 可自定义备份存储路径前缀

使用场景

• 企业或个人开发者需要定期备份Gitea数据以防止数据丢失
• 需要将Gitea备份文件存储到云端存储服务的场景

配置说明

卷挂载

需将Gitea容器中/data目录对应的主机文件夹或数据卷，挂载到本备份容器的/data目录，以访问Gitea数据。

环境变量（带*为必填）

• AWS_ACCESS_KEY_ID*: AWS访问密钥ID（或兼容存储的密钥）
• AWS_SECRET_ACCESS_KEY*: AWS密钥（或兼容存储的密钥）
• S3_BUCKET*: 目标S3存储桶名称
• S3_REGION*: S3存储区域（如eu-central-1）
• S3_ENDPOINT: 自定义S3服务端点（适用于Minio等私有存储）
• S3_S3V4: 设置为yes启用v4签名（部分区域如eu-central-1必须使用）
• S3_PREFIX: 存储路径前缀（无前后斜杠）
• S3_ENCRYPT: 设置为yes启用S3服务器端AES-256加密
• SCHEDULE: 备份定时规则（参考https://godoc.org/github.com/robfig/cron#hdr-Predefined_schedules%EF%BC%89%EF%BC%8C%E8%8B%A5%E6%9C%AA%E8%AE%BE%E7%BD%AE%E5%88%99%E7%AB%8B%E5%8D%B3%E6%89%A7%E8%A1%8C%E4%B8%80%E6%AC%A1%E5%90%8E%E9%80%80%E5%87%BA

部署示例

Docker Run命令

bash
docker run -d \
  --name gitea-backup \
  -v /path/to/gitea/data:/data \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e S3_BUCKET=your_bucket \
  -e S3_REGION=your_region \
  -e SCHEDULE="@daily" \
  gtriggiano/gitea-backup-s3

Docker Compose示例

yaml
version: '3'
services:
  gitea-backup:
    image: gtriggiano/gitea-backup-s3
    volumes:
      - /path/to/gitea/data:/data
    environment:
      AWS_ACCESS_KEY_ID: your_access_key
      AWS_SECRET_ACCESS_KEY: your_secret_key
      S3_BUCKET: your_bucket
      S3_REGION: your_region
      SCHEDULE: "@daily"