Debian 上 MinIO 数据恢复流程

一 恢复前准备

• 立刻停止写入：暂停业务或停止 MinIO 服务，避免新写入覆盖可恢复数据或干扰修复过程。
• 保护现场：对现有磁盘做只读快照或整盘镜像，优先在副本上尝试恢复；记录 MinIO 版本、部署模式（单机/分布式/纠删码/副本）、磁盘/节点拓扑。
• 明确目标：按“对象/桶级恢复”与“整库/磁盘级恢复”两类目标选择路径，避免无计划的盲目操作。
• 准备工具：确保 mc（MinIO Client） 可用，且具有对源/目标桶的 管理员权限；准备好新磁盘（如需更换）。
• 风险提示：对象存储并非传统文件系统，MinIO 本身不提供“通用文件级反删除”功能；若底层文件系统损坏或对象被覆盖，需依赖备份或专业恢复手段。

二 场景化恢复路径

• 纠删码/副本自修复（分布式或纠删码部署）
  1. 更换故障磁盘：先卸载故障盘，按原 标签/UUID 挂载新盘（建议使用 XFS，也可用 ext4），保持与旧盘一致的挂载点；更新 /etc/fstab 后执行 mount -a。
  2. 启动/观察：MinIO 会自动检测新盘并开始修复；用 journalctl -u minio 或 mc admin heal 观察修复进度与健康状态。
  3. 容忍度提示：纠删码 EC:N 可容忍最多 N/2 个驱动器或节点丢失并仍可读写；超过阈值将不可用，需先恢复至阈值内再修复。
• 有备份时的恢复（推荐路径）
  1. 桶/对象级：用 mc cp -r 从备份位置恢复到目标桶，例如：
     mc cp -r /backup/bucket-demo/ myminio/bucket-demo/
  2. 全量/增量备份：若采用 rsync 等形成“全量+增量”目录结构，先恢复最近一次全量，再按时间顺序回放增量；可用脚本选择备份版本并自动解压与回放。
• 无备份且为文件系统损坏（仅限底层文件系统层面）
  1. 停止 MinIO，避免继续写入；
  2. 在只读副本或镜像上尝试开源工具（如 extundelete、PhotoRec）进行文件级恢复；
  3. 恢复的文件再按桶结构上传回 MinIO。该方式成功率受覆盖与文件系统类型影响，必要时联系专业机构。

三 常用命令示例

• 配置别名
  mc alias set src http://192.168.1.10:9000 ACCESS_KEY SECRET_KEY
  mc alias set dst http://192.168.1.20:9000 ACCESS_KEY SECRET_KEY
• 桶级恢复
  mc cp -r src/bucket-demo/ dst/bucket-demo/
• 全量/增量目录恢复（示例）
  tar -xzvf 2024-03-15_full.tar.gz -C /restore/tmp
  mc cp -r /restore/tmp/full/data/ dst/bucket-demo/

  如有增量：按时间顺序 mc cp -r /restore/tmp/incremental/… dst/bucket-demo/

• 修复与监控
  mc admin heal dst
  journalctl -u minio -f

四 验证与后续

• 完整性校验：抽样下载关键对象进行 哈希校验（如 sha256sum）；对多部分上传对象，校验 ETag/分片数量 是否一致。
• 权限与元数据：核对 桶策略、对象 ACL、版本ing、生命周期规则 是否恢复到位。
• 监控告警：观察 mc admin heal 直至完成，确认集群 Degraded/Healing 状态已清除；完善监控与日志审计，便于后续快速定位。
• 预防建议：
  • 建立定期备份（如 mc mirror 或 rsync“全量+增量”），并做离线/异地留存；
  • 采用 纠删码/副本 提供冗余，部署 多节点/多站点 提升可用性；
  • 使用 基于标签/UUID 的挂载 与一致的驱动器顺序，降低替换磁盘时的配置风险。