桶复制

重新同步（灾难恢复）

重新同步主要支持在 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 标志配置远程目标时，必须显式启用同步复制。

复制内部机制

本节记录了复制的内部行为，对于使用或实现复制并不关键。提供此文档仅用于学习和教育目的。