桶复制

重新同步（灾难恢复）

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

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

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

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

对于配置了 对象转换（分层） 的 Bucket，复制重新同步会将对象恢复为非转换状态，并且不包含关联的转换元数据。因此，之前转换到远程存储的任何数据都将永久与远程 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 **不**复制因应用 生命周期管理过期规则 而删除的对象。对于 主动-主动 配置，请在*所有*复制 Bucket 上设置相同的过期规则，以确保一致地应用对象过期。

现有对象的复制

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

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

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

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

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

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

同步与异步复制

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

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

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

在使用 mc admin bucket remote add 命令以及 add 标志配置远程目标时，必须显式启用同步复制。

复制内部机制

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