存储桶复制

重新同步（灾难恢复）

重新同步主要用于在副本配置中利用健康部署，在某个 MinIO 部署发生部分或全部数据丢失后进行恢复。 使用 mc replicate resync 命令，可基于指定的源存储桶对远端目标（mc admin bucket remote）执行完整重新同步。

重新同步过程会根据所有已配置且包含 现有对象复制 的复制规则检查源存储桶中的所有对象。 对于每个匹配规则的对象，重新同步过程都会将其放入复制 队列，而不考虑该对象当前的 复制状态。

对于远端副本与源对象完全一致（包括对象元数据）的对象，MinIO 会跳过同步。 除此之外，MinIO 不会基于目标端已有内容对队列进行优先级调整或修改。

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

对于已配置 对象转换（分层） 的存储桶，复制重新同步会以未转换状态恢复对象，且不包含任何关联的转换元数据。 因此，任何先前已转换到远端存储的数据都会与远端 MinIO 部署永久断开关联。 对于在远端配置中将明确的人类可读前缀作为一部分指定的分层配置，你可以安全地清除该前缀中的已转换数据，以避免与这些“丢失”数据相关的成本。

删除操作的复制

MinIO 支持复制 删除 操作，即同步删除特定对象版本以及新的 删除标记。删除操作复制使用与其他所有复制操作相同的 复制流程。

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

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

对于复制删除某个特定对象版本的操作，在复制完成之前，MinIO 会将该对象版本标记为 PENDING。 一旦远端目标删除了该对象版本，MinIO 就会删除源端上的该对象。 虽然这一过程可确保接近同步的版本删除，但它可能导致在初始删除操作之后，列表操作仍返回该对象版本。 MinIO 使用 X-Minio-Replication-Delete-Status 跟踪删除版本的复制状态。

MinIO 仅复制由客户端显式发起的删除操作。 MinIO 不会 复制因应用 生命周期管理过期规则 而删除的对象。 对于 active-active 配置，请在 所有 复制存储桶上设置相同的过期规则，以确保对象过期行为一致。

现有对象的复制

默认情况下，MinIO 会将源存储桶中的现有对象复制到配置好的远端，类似于 AWS: Replicating existing objects between S3 buckets，但无需联系技术支持的额外成本。

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

你可以在配置或修改存储桶复制规则时禁用现有对象复制。 在创建或修改时，必须指定 所有 需要的复制特性：

• 对于新的复制规则，不要将 "existing-objects" 包含在 mc replicate add --replicate 指定的复制特性列表中。

• 对于现有复制规则，使用 mc replicate update --replicate 从现有复制特性列表中移除 "existing-objects"。 新规则会 替换 旧规则。

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

同步复制与异步复制

对于给定的远端目标，MinIO 支持指定异步复制（默认）或同步复制。

在异步复制模式下，MinIO 会在将对象放入 复制队列 之前 完成发起的 PUT 操作。 因此，发起请求的客户端可能会在对象完成复制 之前 就看到 PUT 操作成功。 虽然这可能导致远端对象陈旧或缺失，但它降低了因复制负载而导致写入变慢的风险。

在同步复制模式下，MinIO 会在完成发起的 PUT 操作 之前 尝试复制对象。 无论复制尝试是否成功，MinIO 都会返回一个成功的 PUT 操作结果。 这降低了写入变慢的风险，但代价是远端位置可能出现陈旧或缺失对象。

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

复制内部机制

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