Skip to content

Latest commit

 

History

History
87 lines (71 loc) · 3.62 KB

README_cn.md

File metadata and controls

87 lines (71 loc) · 3.62 KB

bdchecker

概述

bdchecker (Backup Data Checker) 是用于个人冷备数据检查的工具, 帮助你及时发现数据的损坏

为什么需要它

想象一下, 我们有一些数据需要进行冷备, 可能是每天压缩后的某个金融市场的原始行情数据; 或是一些个人拥有的经典电影的电子版本; 抑或是一些常年用不到的密钥;我们先列出一些方案:

方案 单个存储期限级别
固态盘 几年至十几年
机械盘 10年+
磁带 30年+
打孔纸带 千年
刻在石头上 (罗辑把拐杖高举过头, 庄严地喊道) 百万年

毫无疑问, 若是有足够的财力, 把信息刻在石头上并妥当存储, 除非遭到了二向箔攻击, 否则应该十分安全;但是对于个人而言, 从石头上读取信息带来的成本应该是远大于我们需要保存的数据的价值.
那么当考虑数据的易于读写性的时候, 明显硬盘是最为方便的;但是这带来了额外的要求, 那便是我们需要定期的检查数据是否出现了损坏
综上所述,一个简单明了的冷备方案便是

  1. 使用不同生产批次的硬盘进行多备份
  2. 定期检查文件是否出现损坏
  3. 出现损坏时可用其余的备份文件来修复

bdchecke 便是用来实现定期检查文件是否出现损坏的小工具

安装

  • 使用 pip 安装
pip install bdchecker
  • 直接从 Releases 中获取, 解压并使用

使用

bdchecker 包含三个命令, 分别为

  • gen: 扫描目录, 并递归遍历生成该目录下所有新增文件的 hash 信息, 放置在目录中的 .bdchecker.meta 文件夹中
  • clean: 扫描目录, 从 hash 信息中清理掉已删除的文件
  • check: 扫描目录, 查找出现损坏的文件 (注意, 此操作会计算所有文件的 hash 值, 较为耗费时间)

示例目录

假设当前有如下目录结构

data
├──── a.txt
├──── b.txt
└──── c
      ├──── c1.txt
      └──── c2.txt

gen 示例

生成信息

bdchecker gen -d data -v 1
  • -d: 表示要生成信息的目录
  • -v: 表示日志输出级别, 越高输出越详细

完成后, 可以看到屏幕上日志输出: dump meta info to data/.bdchecker.meta/sha256.csv
当目录中没有新增文件时, 重复执行 gen 命令并不会真正的去生成文件的 hash 信息

clean 示例

删除 data/c/c2.txt, 并运行

bdchecker clean -d data -v 1

可以在日志倒数几行看到: clean missing file's meta info: c/c2.txt, 表示当前我们已经成功清理了文件对应的 hash 信息

check 示例

运行

bdchecker check -d data -v 1

日志的最后一行出现: all check pass, 代表没有新增/删除的文件, 且所有的文件都没有损坏

现在让我们稍微更改一下文件 a.txt,随便更改一下其中的内容,再次运行

bdchecker check -d data -v 1

此时,日志出现错误信息: check failed: a.txt, old hash: ..., cur hash: ...,表示 a.txt 的内容出现了改变

迁移与对比

bdchecker 生成的 hash 信息会保存在目录中的 .bdchecker.meta 目录中, 所以迁移时直接整个文件夹迁移即可
当已经有多份冷备数据存在, 且并没有生成过 hash 值时; 此时可以对每份冷备数据都使用 bdchecker gen 命令来生成 hash 值, 接着对比两份文件即可. 由于生成文件行是已经排序的, 所以可以直接使用 diff 之类的命令进行对比