存储桶复制

重新同步（灾难恢复）

重新同步主要支持在 MinIO 部署中部分或全部数据丢失后，使用副本配置中的健康部署进行恢复。使用 mc replicate resync 命令完全重新同步远程目标 (mc admin bucket remote)，使用指定的源存储桶。

重新同步过程会检查源存储桶中的所有对象，并与包含 现有对象复制 的所有配置的复制规则进行比较。对于与规则匹配的每个对象，重新同步过程会将该对象放入复制 队列 中，而不管对象的当前 复制状态 如何。

如果远程副本与源对象完全匹配（包括对象元数据），则 MinIO 会跳过同步这些对象。否则，MinIO 不会根据目标的现有内容优先处理或修改队列。

mc replicate resync 在存储桶级别运行，并且*不支持*前缀级别的粒度。在大型存储桶上启动重新同步可能会导致复制相关的负载和流量显著增加。请谨慎使用此命令，并且仅在必要时使用。

对于配置了 对象转换（分层） 的存储桶，复制重新同步会将对象恢复为非转换状态，并且没有关联的转换元数据。因此，之前转换到远程存储的任何数据将永久与远程 MinIO 部署断开连接。对于将显式的人类可读前缀指定为远程配置一部分的分层配置，您可以安全地清除该前缀中的已转换数据，以避免与“丢失”数据相关的成本。

删除操作的复制

MinIO 支持复制 删除 操作，其中 MinIO 会同步删除特定对象版本*和*新的 删除标记。删除操作复制使用与所有其他复制操作相同的 复制过程。

MinIO 要求显式启用版本化删除和删除标记复制。使用 mc replicate add --replicate 字段分别指定 delete 和 delete-marker 来启用版本化删除和删除标记复制。要同时启用两者，请使用逗号分隔符 delete,delete-marker 指定这两个字符串。

对于删除标记复制，MinIO 在删除操作创建删除标记后开始复制过程。MinIO 使用 X-Minio-Replication-DeleteMarker-Status 元数据字段来跟踪删除标记复制状态。在 主动-主动 复制配置中，如果两个集群同时为一个对象创建删除标记*或*如果一个或两个集群在复制事件同步之前处于停机状态，则 MinIO 可能会生成重复的删除标记。

对于复制特定对象版本的删除，MinIO 会将对象版本标记为 PENDING，直到复制完成。远程目标删除该对象版本后，MinIO 会删除源上的对象。虽然此过程可确保版本删除近乎同步，但它可能会导致列出操作在初始删除操作后返回对象版本。MinIO 使用 X-Minio-Replication-Delete-Status 来跟踪删除版本复制状态。

MinIO 仅复制显式客户端驱动的删除操作。MinIO*不会*复制从应用 生命周期管理过期规则 删除的对象。对于 主动-主动 配置，请在*所有*复制存储桶上设置相同的过期规则，以确保对象过期的一致应用。

现有对象的复制

默认情况下，MinIO 会将源存储桶中的现有对象复制到配置的远程存储桶，类似于 AWS：在 S3 存储桶之间复制现有对象，无需联系技术支持即可完成。

MinIO 将满足复制规则的所有对象或对象前缀标记为有资格同步到远程集群和存储桶。MinIO 仅排除那些没有版本 ID 的对象，例如在启用存储桶版本控制之前写入的对象。

您可以在配置或修改存储桶复制规则时禁用现有对象复制。您必须在创建或修改期间指定*所有*所需的复制功能

• 对于新的复制规则，请从指定给 mc replicate add --replicate 的复制功能列表中排除 "existing-objects"。

• 对于现有的复制规则，请使用 mc replicate update --replicate 从现有复制功能列表中删除 "existing-objects"。新规则将**替换**以前的规则。

禁用现有对象复制不会删除已复制到远程存储桶的任何对象。

同步与异步复制

MinIO 支持为给定的远程目标指定异步（默认）或同步复制。

使用异步复制，MinIO 会在将对象放入 复制队列 *之前*完成源 PUT 操作。因此，源客户端可能会在对象复制*之前*看到成功的 PUT 操作。虽然这可能导致远程对象陈旧或丢失，但它可以降低由于复制负载导致的写入操作缓慢的风险。

使用同步复制，MinIO 会在完成源 PUT 操作*之前*尝试复制对象。无论复制尝试是否成功，MinIO 都会返回成功的 PUT 操作。这降低了写入操作缓慢的风险，但可能会导致远程位置的对象陈旧或丢失。

配置远程目标时，必须显式启用同步复制，方法是使用 mc admin bucket remote add 命令并添加 add 标记。

复制内部机制

本节介绍复制的内部行为，对使用或实现复制并不重要。此文档仅供学习和教育目的。