Linux Btrfs如何用发送与接收传输快照,怎样确认目标端数据完整
已有 Btrfs 数据卷需要异机保存时,可以用 btrfs send 将只读子卷快照编码成数据流,再由目标端的 btrfs receive 重建快照。要确认传输完整,不能只看命令是否退出成功:还应核对发送流校验值、目标子卷状态与 UUID,并按数据重要性抽样或全量比较文件内容。
现状与条件
先确认两端使用 Btrfs,且操作对象是子卷快照,而非普通目录。以下示例中,源端子卷位于 /mnt/src/@data,快照放在 /mnt/src/snaps;目标端挂载点为 /mnt/dst,接收目录为 /mnt/dst/incoming。实际操作时应替换为已确认的路径。
findmnt -T /mnt/src
findmnt -T /mnt/dst
btrfs filesystem show /mnt/src
btrfs filesystem show /mnt/dst
btrfs subvolume list -p /mnt/src
确认 findmnt 显示的文件系统类型为 btrfs,并检查快照路径与接收目录确实位于预期文件系统。目标接收目录应存在、可写,并位于 Btrfs 文件系统中:
mkdir -p /mnt/dst/incoming
test -w /mnt/dst/incoming && echo "接收目录可写"
发送用的子卷快照必须是只读快照。生产数据若有数据库或其他需要应用层一致性的服务,应先按其数据保护要求执行刷新、短暂停写或备份钩子;Btrfs 快照提供的是文件系统时间点视图,不会自动保证应用事务已落盘。
开始传输前还要确认目标空间充足。发送流大小受数据变化、压缩和文件系统布局影响,不能简单视为快照目录的固定大小;应结合现有容量、历史流量和保留策略预留余量。Btrfs 和 btrfs-progs 版本也应纳入维护记录,跨版本传输前先在测试快照上验证。
围绕 Btrfs 快照的异机留存与增量传输,A5数据提供中国香港、日本、美国等地区的物理服务器,可作为业务源端或快照接收端的部署资源。香港存储系列配备大容量企业级硬盘,日本 CTG 系列也有大容量 HDD 方案;各地区另有 SSD、NVMe 及不同线路、带宽配置,为快照存放和跨机传输提供相应的硬件与网络基础。
日常操作:创建并发送快照
创建只读快照
快照名称最好带有明确时间或批次标识,避免覆盖已有数据。下面的名称仅为示例:
SNAP=/mnt/src/snaps/data-2025-03-08
btrfs subvolume snapshot -r /mnt/src/@data "$SNAP"
btrfs property get -ts "$SNAP" ro
btrfs subvolume show "$SNAP"
ro=true 表示该快照为只读状态。记录 btrfs subvolume show 输出中的 UUID、生成代数和路径,供接收后核对。若快照目录已存在,不要直接复用或覆盖;先确认它属于哪个备份批次以及是否仍被增量发送引用。
首次发送:完整快照
首次传输没有可用的共同父快照时,发送完整快照。把发送流写入文件,便于校验、断点后的重新传输和留存操作记录:
STREAM=/var/tmp/data-2025-03-08.btrfs-send
btrfs send "$SNAP" > "$STREAM"
sha256sum "$STREAM" > "$STREAM.sha256"
流文件可能较大,应先检查临时目录所在文件系统的剩余空间:
df -h /var/tmp
du -h "$STREAM"
将流文件及其校验文件传到目标端。例如:
scp "$STREAM" "$STREAM.sha256" backup-host:/var/tmp/
在目标端校验文件后再接收:
cd /var/tmp
sha256sum -c data-2025-03-08.btrfs-send.sha256
btrfs receive /mnt/dst/incoming < /var/tmp/data-2025-03-08.btrfs-send
校验文件与数据流应来自同一发送批次;若两者分别经过不可信或可能改写文件的环节,校验结果不能证明源端生成的流未被替换。流校验通过后,btrfs receive 才会在接收目录中创建对应子卷。
后续发送:增量快照
如果目标端已保存前一个快照的接收副本,可以发送两个快照之间的增量。源端的父快照和新快照必须对应同一条快照链,目标端也必须保留该父快照的接收副本。
PARENT=/mnt/src/snaps/data-2025-03-01
NEXT=/mnt/src/snaps/data-2025-03-08
btrfs property get -ts "$PARENT" ro
btrfs property get -ts "$NEXT" ro
btrfs send -p "$PARENT" "$NEXT" > /var/tmp/data-2025-03-08.inc
sha256sum /var/tmp/data-2025-03-08.inc > /var/tmp/data-2025-03-08.inc.sha256
传输校验通过后,在目标端接收:
cd /var/tmp
sha256sum -c data-2025-03-08.inc.sha256
btrfs receive /mnt/dst/incoming < /var/tmp/data-2025-03-08.inc
增量发送通常可减少传输量,但依赖父快照链。源端或目标端若删除、改动或丢失作为基准的快照,增量接收可能失败;不要通过手工修改 UUID 或把无关快照当作父快照来绕过检查。无法确认父快照关系时,保留现有目标数据,改做一次完整发送。

结果检查:确认接收状态与数据
核对接收子卷和快照关系
先列出目标端子卷,找到本次接收生成的路径,再查看其属性与详细信息:
btrfs subvolume list -p /mnt/dst
btrfs property get -ts /mnt/dst/incoming/data-2025-03-08 ro
btrfs subvolume show /mnt/dst/incoming/data-2025-03-08
正常接收的子卷应为只读。对完整发送,目标端子卷的接收 UUID 信息可用于和源端快照信息核对;对增量发送,还要确认目标端所依赖的父快照仍存在。不同版本命令输出字段可能有差异,因此应保存两端的 btrfs subvolume show 输出,不要只凭路径名称判断快照身份。
若发送命令、文件传输和接收命令均成功,且目标端子卷状态与 UUID 关系符合预期,说明传输流程完成;这仍不能替代对文件内容的核验。
按风险选择内容校验
对重要数据,可用 rsync 以校验和方式比较源快照与接收副本。以下命令为预演模式,不会修改目标数据:
rsync -aHAXnci --delete --numeric-ids \
/mnt/src/snaps/data-2025-03-08/ \
/mnt/dst/incoming/data-2025-03-08/
若没有输出差异,表示在 rsync 可检查的文件内容、属性范围内未发现差异。-c 会读取文件内容计算校验和,比只比较文件大小和修改时间更可靠,但会增加两端磁盘读取负载和校验时间。-n 表示不执行同步;此处即使带有 --delete 也只是显示差异,不会删除目标文件。移除 -n 后会变成实际同步操作,不应作为常规验收命令使用。
对于大型数据集,可先比较关键目录、关键文件或抽样文件,再安排全量校验。抽样只能说明所检查的部分一致,不能据此宣称全量内容一致。若文件权限、ACL、扩展属性或特殊文件也属于验收范围,应确认两端工具和权限支持对应检查;不能只凭普通文件内容一致推断所有元数据一致。
还可在目标端对其 Btrfs 文件系统执行 scrub,以检查文件系统校验和及可恢复性相关问题:
btrfs scrub start -B /mnt/dst
scrub 检查的是指定文件系统的数据校验情况,不是源端与目标端逐文件比较;对含有多个子卷的文件系统,扫描范围也不是只限于本次接收的快照。它会产生额外磁盘 I/O,应结合业务负载安排。存在冗余副本时,scrub 是否能够修复错误取决于底层冗余与错误类型。

异常处理:按低风险顺序排查
发送失败或返回非零状态:先检查快照是否为只读子卷、源路径是否正确、源文件系统是否可读,以及临时目录是否有空间。重新运行命令前先确认旧流文件是否完整;不要把未完成的流当作有效备份继续传输。
校验值不匹配:先停止接收,不要对该流执行 btrfs receive。重新从源端计算校验值,区分源端生成文件损坏、传输不完整和目标文件被改写等情况;确认原因后重新传输并再次校验。
增量接收提示父快照不匹配或不存在:检查源端父快照、新快照和目标端对应接收副本的 btrfs subvolume show 信息。父快照缺失时,应恢复正确的父快照,或改为发送完整快照;不要删除现有父快照后继续发送后续增量。
接收中断或目标端报空间不足:先检查目标空间、挂载状态、内核日志及接收目录中的子卷列表。中断后可能留下未完成的接收对象。确认该对象确属失败批次、没有被其他任务使用且没有后续增量依赖后,才考虑清理。删除子卷会永久移除该对象及其中的数据,操作前应核对完整路径并保留必要备份。
必要恢复与上线验收
收到的快照通常保持只读,适合作为备份副本保留。若要基于它恢复出可写工作副本,先保留原接收快照,再创建新的可写子卷:
btrfs subvolume snapshot \
/mnt/dst/incoming/data-2025-03-08 \
/mnt/dst/restored/data-2025-03-08-work
btrfs property get -ts /mnt/dst/restored/data-2025-03-08-work ro
确认输出为 ro=false 后,再按业务恢复流程挂载或交由应用使用。此操作会额外占用空间,实际增量占用取决于后续写入;不要为了让备份可写而直接改动原接收快照。若恢复结果有误,停止使用新的工作副本,保留接收快照和相关日志,再按已验证的恢复方案处理。
每次维护完成后,至少核对以下项目:
- [ ] 源快照为只读子卷,名称与备份批次记录一致。
- [ ] 首次传输使用完整发送;增量传输的父快照在源端和目标端均存在。
- [ ] 发送流校验值通过,目标接收命令正常完成。
- [ ] 目标端子卷为只读,UUID 与快照链关系符合预期。
- [ ] 已按数据重要性完成抽样或全量内容比较,并记录校验范围。
- [ ] 目标空间、接收日志和必要的文件系统检查结果已留存。
- [ ] 恢复演练使用独立可写副本,原始只读接收快照仍保留。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5605.html



