coderat/borgmatic_mail

Borgmatic邮件版容器

镜像概述

本镜像基于b3vis/borgmatic扩展，集成邮件通知功能，用于自动化Borgbackup备份任务，可将crontab执行结果通过邮件发送，方便监控备份状态。支持定时配置、远程仓库连接、FUSE挂载恢复等核心能力。

核心功能

• 定时备份：通过crontab.txt自定义备份时间，自动执行Borgmatic任务。
• 邮件通知：利用msmtp发送备份结果邮件，支持配置邮件中继和收件人。
• 远程仓库：挂载SSH密钥实现远程Borg仓库的安全连接。
• FUSE恢复：具备SYS_ADMIN权限可挂载备份归档，快速恢复文件。
• 环境配置：支持时区、SSH参数、仓库密码、邮件中继等变量设置。

使用场景

• 服务器数据定时自动备份，需邮件提醒备份结果。
• 个人/团队数据备份，需要远程存储和状态监控。
• 需要快速挂载恢复备份文件的场景。

配置说明

卷挂载

• /mnt/source：挂载需备份的数据源（建议只读）。
• /mnt/borg-repository：挂载Borg备份仓库目录。
• /etc/borgmatic.d：挂载包含crontab.txt和config.yaml的配置目录。
• /root/.config/borg：存储Borg配置和加密密钥（需备份）。
• /root/.ssh：挂载SSH密钥用于远程仓库连接。
• /root/.cache/borg：存储Borg块缓存（非易失性）。

环境变量

• TZ：时区设置（如Asia/Shanghai）。
• BORG_RSH：SSH连接参数（如ssh -i /root/.ssh/id_ed25519 -p 22）。
• BORG_PASSPHRASE：仓库加密密码。
• MAIL_RELAY_HOST：邮件中继主机地址。
• MAIL_PORT：邮件中继端口（如587）。
• MAIL_USER：邮件中继登录用户名。
• MAIL_PASSWORD：邮件中继登录密码。
• MAIL_FROM：邮件发件人名称。

Docker部署示例

常规备份运行

bash
docker run \
  --detach --name borgmatic \
  -v /home:/mnt/source:ro \
  -v /opt/borgmatic/repo:/mnt/borg-repository \
  -v /opt/borgmatic/config:/etc/borgmatic.d/ \
  -v /opt/borgmatic/borg-config:/root/.config/borg \
  -v /opt/borgmatic/ssh:/root/.ssh \
  -v /opt/borgmatic/cache:/root/.cache/borg \
  -e TZ=Asia/Shanghai \
  coderat/borgmatic_mail

FUSE挂载恢复权限

若需挂载备份归档，需添加以下参数：

bash
--cap-add SYS_ADMIN \
--device /dev/fuse \
--security-opt label:disable \
--security-opt apparmor:unconfined

初始化加密仓库

bash
docker exec borgmatic \
sh -c "borgmatic --init --encryption repokey-blake2"

生成示例配置

bash
docker exec borgmatic \
sh -c "generate-borgmatic-config -d /etc/borgmatic.d/config.yaml"

Docker Compose使用

1. 准备配置：

   bash
   cp .env.template .env
   # 修改.env中的环境变量和卷路径
   

2. 启动备份容器：

   bash
   docker-compose up -d
   

3. 恢复备份：

   bash
   docker-compose down
   docker-compose -f docker-compose.yml -f docker-compose.restore.yml run borgmatic
   # 挂载备份：borg mount /mnt/borg-repository <挂载点>
   # 恢复文件后卸载：borg umount <挂载点> && exit
   

4. 解除仓库锁（若需）：

   bash
   docker exec borgmatic borg break-lock /mnt/borg-repository