svensp/cloudbackup

backup 镜像文档

镜像概述和主要用途

backup 镜像旨在简化Hetzner Storagebox上的备份管理流程。在云环境中，每个应用通常拥有独立的数据库和文件存储，传统备份方案需为每个服务单独配置，存在重复工作和管理分散的问题。本镜像不替代现有备份工具，而是通过抽象存储接口、统一管理入口和集成专业备份软件，解决多应用场景下的备份复杂性，尤其适用于需要集中管理数据库和文件备份的场景。

核心功能和特性

1. 存储接口抽象
   支持sftp或s3存储协议（参考实现针对Hetzner Storagebox优化），可灵活对接不同存储后端。

2. 统一备份管理
   提供单一入口访问所有备份，无需为每个应用维护独立备份流程。

3. 多类型备份支持

   • 数据库备份：集成Mariabackup，针对MariaDB优化，支持InnoDB引擎的快速备份。
   • 文件备份：集成Borgbackup，通过数据 deduplication 技术实现高效增量备份。

4. 易于扩展
   简化新应用备份仓库的添加流程，适应云环境中服务动态变化的需求。

使用场景和适用范围

• 云环境中多应用（如微服务架构）的备份管理，每个应用有独立数据库和文件存储。
• 使用Hetzner Storagebox作为备份存储的用户。
• 需要同时管理数据库（MariaDB）和文件备份的场景。
• Kubernetes集群环境下的定时备份任务（提供Kubernetes部署示例）。

使用方法和配置说明

安装方式

推荐通过Docker容器使用，也可通过源码安装（需手动安装依赖）。

Docker容器使用（推荐）

镜像提供多种使用示例，位于 examples/docker-backup 目录，包含Docker备份脚本。基本使用流程如下：

1. 准备配置文件
   根据备份需求（数据库或文件）配置存储连接信息（如Hetzner Storagebox的sftp凭证）。

2. 运行容器

   bash
   docker run -v /path/to/local/config:/config \
              -v /path/to/backup/source:/backup-source \
              backup:latest \
              --config /config/backup.conf \
              --type [mysql|file]
   

Kubernetes部署

提供Kubernetes部署示例（位于 examples/kubernetes 目录），包括：

• metrics：Prometheus指标部署示例
• mysql：MySQL定时备份CronJob示例
• files：文件备份CronJob示例

配置参数

配置文件需包含以下核心参数：

• storage_type：存储类型（sftp/s3）
• storage_host：存储服务器地址（如Hetzner Storagebox主机名）
• storage_user：存储访问用户名
• storage_password：存储访问密码
• backup_type：备份类型（mysql/file）
• backup_source：备份源路径（本地文件路径或数据库连接信息）

集成的备份软件

Mariabackup

Mariabackup是Percona Xtrabackup的分支，专为MariaDB优化。其工作原理是：

• 复制文件系统中的数据库文件
• 通过二进制日志读取文件的实时变更
• 结合两者创建一致性备份

优势：对InnoDB引擎支持良好，备份速度快，支持增量备份。

Borgbackup

Borgbackup是一款deduplicating备份工具，工作机制如下：

• 将文件分割为固定大小的块
• 计算每个块的哈希值并存储唯一块
• 增量备份时仅存储变化的块

优势：相比传统增量备份，减少存储空间占用，提高备份效率，尤其适用于大文件的频繁更新场景。