Backrest项目备份大文件时占用根目录空间问题分析

问题背景

在使用Backrest进行大文件备份时，用户遇到了根目录空间被占满的问题。具体表现为当尝试备份位于大容量HDD（挂载在/mnt/pools/slow）上约300GB的数据时，Docker的overlay存储驱动占用了根目录下/var/lib/docker/overlay的大量空间，导致根分区空间耗尽。

环境配置

用户系统环境配置如下：

• 操作系统：Ubuntu 22.04.4 LTS
• 存储配置：
  • 根分区：57GB SSD (ext4)
  • 快速存储池：221GB SSD (ZFS)
  • 慢速存储池：1.8TB HDD (ZFS)
• Docker存储驱动：overlay2
• Backrest版本：1.4.0

问题分析

经过深入分析，发现问题根源在于Backrest容器配置中的路径映射错误。具体表现为：

1. 用户在容器中挂载了主机路径/mnt/pools/slow/backups/backrest/repos到容器内的/repos
2. 但在Backrest的repo配置中，错误地将URI指定为主机路径/mnt/pools/slow/backups/backrest/repos/immich，而非容器内路径/repos/immich
3. 这种配置导致Backrest尝试在容器内部创建repo目录，而非使用挂载的卷

技术细节

Docker存储机制影响

当Backrest错误地在容器内部创建repo时，所有备份操作产生的临时文件都会存储在容器的可写层中。在overlay2存储驱动下，这些文件会占用/var/lib/docker/overlay的空间。对于大文件备份，这会快速耗尽根分区的空间。

路径映射原理

正确的路径映射应该遵循以下原则：

• 主机路径 → 容器内挂载点
• 容器内应用应使用挂载点路径访问数据

在Backrest配置中，URI应使用容器内挂载点路径，而非主机路径。

解决方案

修正Backrest的repo配置，将URI改为容器内挂载点路径：

{
  "id": "immich__local",
  "uri": "/repos/immich",
  ...
}

最佳实践建议

1. 路径映射检查：确保容器内应用使用的路径与挂载点一致
2. 存储监控：对大容量备份操作实施存储空间监控
3. 测试验证：在小规模数据上测试备份配置，确认路径正确性
4. 日志分析：定期检查容器日志，确认备份操作是否按预期执行

总结

Backrest作为备份工具，在配置时需要特别注意路径映射的正确性。错误的路径配置不仅会导致备份失败，还可能引发存储空间问题。通过理解Docker的存储机制和正确的路径配置方法，可以有效避免类似问题的发生。