rafsaf/ogion

Ogion

镜像概述

Ogion是一款用于执行定时数据库备份并将加密数据传输到安全公共云的工具，适用于家庭实验室、hobby项目等场景，可在k8s、docker、虚拟机等环境中运行。备份采用age格式加密（基于现代加密工具age），并使用lzip压缩（固定块大小设计，抵抗压缩侧信道***），确保数据安全。项目通过全面的集成测试保障可靠性，支持多种数据库目标、云存储提供商和通知方式。

核心功能

1. 支持的备份目标：
   • PostgreSQL（所有当前支持版本）
   • MariaDB（所有当前支持版本）
   • MySQL（所有当前支持版本）
   • 单文件
   • 目录
2. 支持的上传提供商：
   • Google Cloud Storage桶
   • S3兼容存储（AWS、Minio）
   • Azure Blob Storage
   • 本地调试（Debug）
3. 通知方式：

   • ---

   • 邮件（SMTP）
   • Slack
4. 架构支持：
   • linux/amd64
   • linux/arm64

使用场景

• 家庭实验室的数据库与文件备份
• 个人hobby项目的定时数据保护
• 小型生产环境的数据库备份（如作者用于生产项目plemiona-planer.pl的PRD/STG数据库）
• 自托管服务（Firefly III、Grafana、KeyCloak等）的数据备份

配置说明

通过环境变量配置核心参数：

• 数据库连接信息（如POSTGRESQL_DB_README包含主机、密码、cron规则等）
• AGE_RECIPIENTS：age加密的接收者密钥
• BACKUP_PROVIDER：备份存储提供商配置

Docker部署示例

以下是每天5点备份PostgreSQL数据库的docker-compose示例：

yml
# docker-compose.yml
services:
  db:
    image: postgres:17
    environment:
      - POSTGRES_PASSWORD=pwd
  ogion:
    image: rafsaf/ogion:latest
    environment:
      - POSTGRESQL_DB_README=host=db password=pwd cron_rule=0 0 5 * * port=5432
      - AGE_RECIPIENTS=age1q5g88krfjgty48thtctz22h5ja85grufdm0jly3wll6pr9f30qsszmxzm2
      - BACKUP_PROVIDER=name=debug

（注：此示例使用Debug提供商，备份文件存储在容器本地）

可靠性保障

Ogion通过100%的端到端集成测试确保可靠性：

1. 在真实数据库中创建测试数据
2. 使用官方客户端（pg_dump、mariadb-dump）执行备份
3. 压缩（lzip）+加密（age）处理
4. 上传到模拟云存储（Azurite/Azure、fake-gcs-server/GCS、Minio/S3）
5. 下载、解密、解压
6. 恢复数据并验证完整性 测试覆盖所有支持的数据库版本，且每日自动更新数据库版本以保持兼容性。