skyfay/dbackup

DBackup

镜像概述和主要用途

DBackup是一个全面的自托管备份解决方案，旨在自动化和保护数据库备份。它提供AES-256-GCM加密、灵活的存储选项和智能保留策略，确保数据始终受到保护且可恢复。无论是运行单个MySQL数据库还是管理多个PostgreSQL、MongoDB和SQL Server实例，DBackup都提供统一界面，包含实时监控、细粒度访问控制和无缝恢复功能。设计上无供应商锁定——每个备份都是标准数据库转储（SQL、BSON、RDB等），使用开放的AES-256-GCM加密，即使DBackup不可用，也可使用Node.js脚本和恢复工具包中的密钥解密恢复。

核心功能和特性

数据库备份

• 7种数据库引擎：支持MySQL、MariaDB、PostgreSQL、MongoDB、SQLite、Redis和Microsoft SQL Server
• 选择性数据库备份：按任务选择要备份的数据库，无需为每个数据库创建单独源
• 多数据库任务：在单个任务中从单个源备份多个数据库，采用统一TAR归档格式
• AES-256-GCM加密：通过托管加密配置文件、密钥轮换和可下载的恢复工具包进行备份加密，支持离线解密
• GZIP & Brotli压缩：内置压缩功能，减少备份大小和存储成本

存储与目标

• 13+种存储适配器：S3、Cloudflare R2、Hetzner、Google Drive、Dropbox、OneDrive、SFTP、FTP、WebDAV、SMB、Rsync和本地文件系统
• 多目标任务：同时将每个备份上传到多个存储目标，实现冗余或异地备份
• 存储资源管理器：浏览所有目标中的备份文件，检查元数据，下载文件或生成安全的直接下载链接
• 存储监控与警报：针对使用峰值、存储限制警告和指定时间窗口内缺失备份的每个目标警报

恢复与恢复

• 一键恢复：直接从存储资源管理器恢复到任何配置的数据库目标
• 数据库重映射：以不同名称恢复数据库或将多个数据库映射到新目标
• 版本兼容性检查：恢复前验证，在执行前警告版本不匹配
• SHA-256完整性验证：备份时生成校验和，恢复前验证
• 无供应商锁定：备份是使用开放AES-256-GCM加密的标准数据库转储，仅需Node.js即可手动解密和导入，无需DBackup
• 恢复工具包：可下载的ZIP文件，包含加密密钥和独立解密脚本，用于无DBackup的灾难恢复

监控与可见性

• 实时备份进度：实时进度跟踪，显示备份和恢复操作期间的具体情况
• 交互式仪表板：活动图表、任务状态概览、KPI卡片和自动刷新的活动源
• 数据库资源管理器：直接从DBackup浏览数据库、表和实时数据，支持服务器端分页、全文搜索、模式检查和所有7种数据库引擎的深度链接URL
• 存储使用历史：通过面积图和趋势指标跟踪存储随时间的增长
• 执行历史：每个备份和恢复的完整日志，包含持续时间、文件大小、状态和错误详情

通知

• 9种通知渠道：、Slack、Teams、、Gotify、ntfy、Webhook、SMS（Twilio）和Email（SMTP）
• 按任务通知设置：为每个备份任务单独配置触发的通知渠道
• 系统事件通知：通过所有渠道获取有关用户登录、账户创建、恢复结果、存储警报、更新可用性和系统错误的通知
• 重复间隔：为重复警报（存储警告、更新通知）配置提醒间隔

调度与保留

• 基于Cron的调度：灵活的任务调度，带有可视化调度选择器（简单模式+ Cron模式）
• GFS保留策略：祖父-父亲-儿子轮换，具有按目标保留设置
• 自动配置备份：将整个DBackup配置自我备份到任何存储适配器

访问控制与安全

• SSO / OIDC：OpenID Connect，带有针对Authentik、PocketID、Keycloak的预构建适配器和通用OIDC选项
• RBAC：具有细粒度权限的用户组、受保护的SuperAdmin组和审计日志
• 2FA / Passkeys：双因素认证和WebAuthn密钥支持
• 可配置速率限制：可从设置UI调整的每类别速率限制（认证、API读取、API写入）

API与自动化

• REST API：通过API触发备份、轮询执行、管理适配器和浏览存储
• 细粒度API密钥：用于CI/CD管道和脚本的范围权限和过期日期
• 现成示例：API文档中包含cURL、Bash和Ansible示例

设计简洁性

• 直观UI：干净现代的界面，使复杂的备份工作流变得简单
• 快速设置向导：引导式7步首次运行设置，让您在几分钟内运行第一个备份
• 高度可配置：会话生命周期、速率限制、保留期、通知偏好、系统任务等
• Docker就绪：多架构镜像（AMD64/ARM64）、健康检查、优雅关闭和可配置的PUID/PGID

使用场景和适用范围

适用于需要自动化数据库备份、确保数据安全和可恢复性的个人开发者、企业IT团队和自托管用户。特别适合管理多个不同类型数据库实例、需要异地备份冗余、要求严格数据加密和合规性的场景。无论是小型应用还是大型企业环境，DBackup都能提供灵活的备份策略和可靠的恢复机制。

使用方法和配置说明

快速开始

支持平台：AMD64 (x86_64) • ARM64 (aarch64)

Docker Compose配置

yaml
# docker-compose.yml
services:
  dbackup:
    image: docker.xuanyuan.run/skyfay/dbackup:latest
    container_name: dbackup
    restart: always
    ports:
      - "3000:3000"
    environment:
      - ENCRYPTION_KEY=       # 使用命令生成: openssl rand -hex 32
      - BETTER_AUTH_URL=https://localhost:3000
      - BETTER_AUTH_SECRET=   # 使用命令生成: openssl rand -base64 32
      # 所有其他环境变量: https://docs.dbackup.app/user-guide/installation#environment-variables
    volumes:
      - ./data:/data              # 所有持久化数据（数据库、存储、证书）
      - ./backups:/backups        # 可选：用于本地备份

启动命令

bash
docker-compose up -d

启动后，打开https://localhost:3000%E5%B9%B6%E5%88%9B%E5%BB%BA%E7%AE%A1%E7%90%86%E5%91%98%E8%B4%A6%E6%88%B7%EF%BC%88%E9%A6%96%E6%AC%A1%E8%AE%BF%E9%97%AE%E6%97%B6%E6%8E%A5%E5%8F%97%E8%87%AA%E7%AD%BE%E5%90%8D%E8%AF%81%E4%B9%A6%E8%AD%A6%E5%91%8A%EF%BC%89%E3%80%82

环境变量说明

支持的数据库

支持的存储目标

支持的通知渠道

文档与支持

完整文档可在https://docs.dbackup.app%E8%8E%B7%E5%8F%96%EF%BC%9A

• https://docs.dbackup.app/user-guide/getting-started - 安装、配置、使用
• https://api.dbackup.app - 交互式REST API文档
• https://docs.dbackup.app/developer-guide/ - 架构、适配器、贡献
• https://docs.dbackup.app/changelog - 发布历史
• https://docs.dbackup.app/roadmap - 计划功能

社区支持：

• ：加入社区 []
• 问题反馈：在https://github.com/Skyfay/DBackup/issues%E6%8A%A5%E5%91%8A%E9%94%99%E8%AF%AF%E6%88%96%E8%AF%B7%E6%B1%82%E5%8A%9F%E8%83%BD
• 安全漏洞：通过***报告（请勿公开提交安全问题）

许可证

GNU General Public License v3.0