mc admin heal

说明

mc admin heal 命令会扫描受损或损坏的对象，并对这些对象执行自愈。

mc admin heal 资源开销较大，通常不需要手动执行，即使在驱动器故障或数据损坏事件之后也是如此。

作为正常运行的一部分，MinIO 会：

• 在每次 POST 或 GET 操作时，自动修复因静默位腐坏、驱动器故障或其他问题而受损的对象。
• 使用 scanner 周期性执行后台对象自愈。
• 在更换驱动器后积极执行对象自愈。

有关 MinIO 如何执行对象自愈的更多详细信息，请参阅 对象自愈。

语法

mc admin heal 使用以下语法：

mc admin heal [FLAGS] TARGET             \
                      [--all-drives, -a] \
                      [--dry-run, -n]    \
                      [--force]          \
                      [--verbose, -v]

mc admin heal 支持以下参数：

TARGET

mc-cmd

Required

执行对象自愈的存储桶或存储桶前缀的完整路径。 指定已配置的 MinIO 部署的 alias 作为该路径的前缀。 例如：

mc admin heal play/mybucket/myprefix

如果 TARGET 存储桶或存储桶前缀存在活动的自愈扫描，命令将返回该扫描的状态。

--all-drives, -a

mc-cmd

Optional

选择所有驱动器并显示详细信息。

--dry-run, -n

mc-cmd

Optional

仅检查对象并报告驱动器与分片的健康状态，不修改或删除磁盘上的任何数据。

--force

mc-cmd

Optional

禁用警告提示。

--verbose, -v

mc-cmd

Optional

显示离线和故障驱动器的自愈信息。

行为说明

在 SILO 20261109（RELEASE.2026-11-09T00-00-00Z）与 mcli 20261109 中：

• mc admin heal --dry-run（-n）严格保持只读，不会删除磁盘上悬空或损坏的数据（PR #280）。
• 服务端将 xl.meta 校验和错误归类为可自愈状态，使受损元数据分片能够得到修复（#309）。
• 当排队中的生命周期过期因版本历史不完整或损坏而被拒绝时，服务端会将相应对象版本加入自愈队列（#303）。
• mcli 可将自愈字节进度清晰格式化至 EiB 量级。

自愈颜色

某些版本的 MinIO 使用颜色标识来区分不同自愈状态的对象。

颜色含义已更新。

• 绿色表示存储桶健康。
• 黄色表示存储桶在一个或多个驱动器上需要执行自愈。
• 红色表示一个或多个驱动器处于不健康状态。
• 灰色表示自愈状态不确定。