SILO 20261109 正式版变化： SILO 20261109 在复制删除中保留目标端 Object Lock 保留期与 legal hold（提交 7e9ee6bef），不再复制生命周期规则产生的删除标记与版本清除以匹配 AWS S3 语义（提交 1bd0b1b04），并防止在复制工作线程池缺失时采集复制工作线程指标触发 panic，同时保留历史均值与峰值计数（提交 099b7ddf3）。

20261026 正式版变化： 分片上传复制现已为可合并的 CRC 校验和算法保留 FULL_OBJECT 校验和类型（旧版未传递该头部，导致目标端默认创建 COMPOSITE 分片上传并在完成阶段拒绝整对象 CRC）。该修复位于 Server 20261026中，升级发送端 Server 后请核对待处理/失败副本及目标端校验和。

MinIO 支持在源存储桶与目标存储桶之间进行服务端和客户端对象复制。

• 服务端存储桶复制： 为每个存储桶配置规则，以便在部署之间自动同步对象。配置存储桶复制规则的部署充当“源”，而配置的远端部署充当“目标”。SILO 会在对象写入操作（例如 PUT）期间应用规则，并自动同步新对象及对象变更（例如新对象版本或对象元数据更新）。服务端存储桶复制要求源集群和远端目标集群运行相同版本。
• 客户端存储桶复制： 使用 mc mirror 在同一 S3 兼容集群内的存储桶之间，或在两个相互独立的 S3 兼容集群之间同步对象（包括 SILO 到 S3 等配置）。

服务端存储桶复制

MinIO 服务端存储桶复制是一种自动化的存储桶级配置，用于在源存储桶和目标存储桶之间同步对象。 MinIO 服务端复制 要求 源存储桶和目标存储桶分别位于两个独立的 MinIO 集群中，且运行相同的 MinIO 服务端版本。

对于写入存储桶的每次操作，MinIO 都会检查该存储桶上配置的所有复制规则，并应用已配置优先级最高的匹配规则。 MinIO 会同步新对象以及对象变更，例如新的对象版本或对象元数据变更。 这也包括启用或修改对象锁定或保留设置等元数据操作。

MinIO 服务端存储桶复制在功能上类似于 Amazon S3 replication，同时增加了以下 MinIO 专有特性：

• 源存储桶和目标存储桶名称可以相同，从而支持 Splunk 或 Veeam BC/DR 等站点到站点用例。
• 相比 S3 存储桶复制配置，实现更简化，无需配置 AccessControlTranslation、Metrics 和 SourceSelectionCriteria 等设置。
• 支持源存储桶与目标存储桶之间对象的 Active-Active（双向）复制。
• 支持在三个或更多 MinIO 部署之间进行对象的多站点复制

重新同步（灾难恢复）

重新同步主要用于在副本配置中利用健康部署，在某个 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 跟踪删除版本的复制状态。

在 SILO 20261109 中，复制删除保留目标端的 Object Lock legal hold 与保留期（提交 7e9ee6bef）。源端绕过 GOVERNANCE 保留期发起的物理清除不会赋予目标端绕过权限；只要目标端版本仍受有效保留期或 legal hold 保护，目标端就会拒绝复制清除并由源端重试。

SILO 仅复制由客户端显式发起的删除操作；由生命周期管理过期规则生成的删除标记与版本清除不会被复制（提交 1bd0b1b04），行为与 AWS S3 一致。如需副本存储桶保持一致的对象过期行为，请在源存储桶与目标存储桶上独立配置生命周期规则（在 active-active 配置中请在所有复制存储桶上配置相同的过期规则）。

MinIO 会在源存储桶和远端存储桶上裁剪空对象前缀

如果删除操作移除了某个存储桶前缀中的最后一个对象，MinIO 会递归删除该前缀中所有为空的部分，直到存储桶根目录。 MinIO 仅对在对象写入过程中 隐式 创建的前缀应用这种递归删除行为，也就是说，该前缀不是通过 mc mb 之类的显式目录创建命令创建的。

如果复制规则启用了删除操作复制，那么复制过程在目标 MinIO 集群上 也会 应用这种隐式前缀裁剪行为。

例如，考虑一个名为 photos 的存储桶，其中包含以下对象前缀：

• photos/2021/january/myphoto.jpg
• photos/2021/february/myotherphoto.jpg
• photos/NYE21/NewYears.jpg

photos/NYE21 是 唯一一个 使用 mc mb 显式创建的前缀。 其他所有前缀都是在写入位于该前缀下的对象时 隐式 创建的。

• 某个命令删除了 myphoto.jpg。MinIO 会自动裁剪空的 /january 前缀。
• 随后某个命令删除了 myotherphoto.jpg。MinIO 会自动裁剪 /february 前缀以及此时已为空的 /2021 前缀。
• 某个命令删除了 NewYears.jpg 对象。MinIO 会保留 /NYE21 前缀，因为它是 显式 创建的。

现有对象的复制

默认情况下，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 标志显式启用同步复制。

复制内部机制

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

复制流程

MinIO 使用一个复制排队系统，并由多个并发复制工作线程处理该队列。MinIO 会持续执行复制并从队列中移除对象，同时扫描新的未复制对象并将其加入队列。在 SILO 20261109 中，当复制工作线程池不存在时，复制工作线程指标不再触发 panic，并继续保留历史平均值与峰值计数（提交 099b7ddf3）。

MinIO 会根据对象的复制状态设置 X-Amz-Replication-Status 元数据字段：

复制流程通常具有以下几种流转路径之一：

• PENDING -> COMPLETED
• PENDING -> FAILED -> COMPLETED