btrfs-backup

• 变更日志

btrfs-backup 是一个可以用于备份一个或多个 btrfs 文件系统数据的程序。它依赖于 btrfs(8) 工具程序来执行其任务，并提供一个非常简单的接口，用于快速创建和传输 btrfs 快照。

至于 btrfs 文件系统本身，备份的单位是子卷。子卷的快照创建是基于需求的，也就是说，只有当检测到相应的子卷上有新数据可用时，才会创建新的快照。数据传输可以增量进行，也就是说，只需要发送最新快照状态的变化。

程序以仓库为推理单位。仓库是一个目录，用于包含新创建的以及已存在的快照。

在备份方面，涉及两个仓库：源仓库和目标仓库。通过从源到目标的快照文件增量传输，保持这两个仓库同步。在目标仓库上，随后将快照重新声明或存储在文件中。

用法

假设你有两个子卷，你想将它们备份到挂载在 /mnt/backup 的外部硬盘上

# Mount some backup drive.
$ mount /mnt/backup/
# Create a fake hierarchy of btrfs subvolumes for illustration purposes.
$ mkdir /.btrfs-root/
$ mkdir /.btrfs-root/subdir
$ btrfs subvolume create /.btrfs-root/subvol1
$ btrfs subvolume create /.btrfs-root/subdir/subvol2

/.btrfs-root/
├── subdir
│   └── subvol2
└── subvol1

备份

在这个配置中，备份可以非常简单

$ btrfs-backup backup \
    /.btrfs-root/subvol1 \
    /.btrfs-root/subdir/subvol2 \
    --destination /mnt/backup/

此命令会导致以下备份快照

/mnt/backup/
├── <hostname>_.btrfs-root-subdir-subvol2_2023-02-20_11:14:35_
└── <hostname>_.btrfs-root-subvol1_2023-02-20:11:14:35_

btrfs 文件系统上的备份工作方式是，在源文件系统上创建要备份的子卷的只读快照，然后发送到目标文件系统。上面显示的是目标文件系统上的快照。因为我们没有向命令提供 --source 参数，所以源文件系统上的快照与实际的子卷位于同一位置（即它们位于相同的父目录中）

/.btrfs-root/
├── <hostname>_.btrfs-root-subvol1_2023-02-20_11:14:35_
├── subdir
│   ├── <hostname>_.btrfs-root-subdir-subvol2_2023-02-20_11:14:35_
│   └── subvol2
└── subvol1

如果您想集中管理快照，请使用 --source 标志并提供指向 btrfs 文件系统上子卷所在目录的路径

# Create central snapshot location.
$ mkdir /snapshots
$ btrfs-backup backup \
    /.btrfs-root/subvol1 \
    /.btrfs-root/subdir/subvol2 \
    --source /snapshots \
    --destination /mnt/backup/

现在，快照不再位于子卷旁边

/.btrfs-root/
├── subdir
│   └── subvol2
└── subvol1

它们位于一个单独的目录中

/snapshots/
├── <hostname>_.btrfs-root-subdir-subvol2_2023-02-20_11:14:35_
└── <hostname>_.btrfs-root-subvol1_2023-02-20_11:14:35_

恢复

子卷可以以类似的方式恢复，使用 btrfs-backup 的 restore 子命令。

# Let's say all our source data is gone and only /mnt/backup still
# available.
$ rm -rf /.btrfs-root
$ btrfs-backup restore \
    /.btrfs-root/subvol1 \
    /.btrfs-root/subdir/subvol2 \
    --source /mnt/backup/

本质上，我们现在使用 /mnt/backup 作为源存储库，并恢复原始子卷状态以及同位置的快照（如果提供 --destination 参数，则与集中管理的快照类似工作）。

/.btrfs-root/
├── <hostname>_.btrfs-root-subvol1_2023-02-20_11:14:35_
├── subdir
│   ├── <hostname>_.btrfs-root-subdir-subvol2_2023-02-20_11:14:35_
│   └── subvol2
└── subvol1

清除

btrfs-backup 能够通过 purge 子命令识别并删除不再使用的快照。此子命令接受 --keep-for 参数，该参数理解持续时间指定，例如 2d（两天）、1w（一周）、5m（五个月）、1y（一年），并将删除超过该时间的快照。

例如，给定以下状态

/.btrfs-root/
├── <hostname>_.btrfs-root-subvol1_2023-01-31_19:56:07_
├── <hostname>_.btrfs-root-subvol1_2023-02-10_09:23:11_
├── <hostname>_.btrfs-root-subvol1_2023-02-20_11:14:35_
├── subdir
│   ├── <hostname>_.btrfs-root-subdir-subvol2_2023-01-31_19:56:07_
│   ├── <hostname>_.btrfs-root-subdir-subvol2_2023-02-10_09:23:11_
│   ├── <hostname>_.btrfs-root-subdir-subvol2_2023-02-20_11:14:35_
│   └── subvol2
└── subvol1

以下命令

$ date
> Mo 20. Feb 11:15:53 PST 2023
# Delete all snapshots older than two weeks.
$ btrfs-backup purge \
    /.btrfs-root/subvol1 \
    /.btrfs-root/subdir/subvol2 \
    --destination /mnt/backup/ \
    --keep-for 2w

将导致从 2023-01-31 到的快照被删除，因为它们已经超过两周了。

/.btrfs-root/
├── <hostname>_.btrfs-root-subvol1_2023-02-10_09:23:11_
├── <hostname>_.btrfs-root-subvol1_2023-02-20_11:14:35_
├── subdir
│   ├── <hostname>_.btrfs-root-subdir-subvol2_2023-02-10_09:23:11_
│   ├── <hostname>_.btrfs-root-subdir-subvol2_2023-02-20_11:14:35_
│   └── subvol2
└── subvol1

$ btrfs-backup backup --remote-command='ssh server'
$ btrfs-backup backup \
    /.btrfs-root/subvol1 \
    /.btrfs-root/subdir/subvol2 \
    --destination /mnt/backup/ \
    --remote-command='ssh server'