启用多站点服务端存储桶复制

本页中的过程用于在多个 MinIO 部署之间配置自动化的服务端存储桶复制。多站点 Active-Active 复制基于 启用双向服务端存储桶复制 过程,并增加了额外注意事项,以确保所有站点上的复制行为可预测。

Active-Active 复制可在多个远程部署之间同步数据。

多站点 Active-Active 复制配置可以跨越多个机架、数据中心或地理位置。多站点配置的部署与维护复杂度通常会随着站点数量和每个站点规模的增加而提高。计划实施多站点复制的企业应考虑借助 MinIO SUBNET 支持,以获取应对此类用例所需的专业知识、规划能力和工程资源。

要求

你必须满足 Bucket Replication Requirements 中描述的所有存储桶复制基础要求。

此外,要创建多站点存储桶复制配置,你还必须满足以下额外要求:

访问所有集群

要设置多站点 Active-Active 存储桶复制,你必须具备访问所有部署的网络连通性,以及具有正确权限的登录凭证。

你可以通过安装 mc 并使用命令行访问这些部署。 使用 mc alias set 命令为每个 MinIO 部署创建别名。

创建别名时,需要指定该部署上某个用户的 access key。 该用户必须具有在该部署上创建和管理用户及策略的权限。

具体来说,请确保该用户至少具有以下权限:

注意事项

点击展开以下任意条目:

使用一致的复制设置

MinIO 支持自定义复制配置,以启用或禁用以下复制行为:

为存储桶配置复制规则时,请确保参与多站点复制的所有 MinIO 部署使用相同的复制行为,以保证对象同步的一致性和可预测性。

现有对象复制

MinIO 支持自动复制存储桶中的现有对象。

MinIO 要求使用 mc replicate add --replicatemc replicate update --replicate 显式启用现有对象复制,并包含 existing-objects 复制功能标志。 本过程包含用于启用现有对象复制的必需标志。

删除操作复制

MinIO 支持将 delete operations 复制到目标存储桶。 具体来说,MinIO 可以复制版本控制中的 Delete Markers,以及删除指定版本对象的操作:

  • 对对象执行删除操作时,MinIO 复制也会在目标存储桶上创建删除标记。
  • 对对象的某个版本执行删除操作时,MinIO 复制也会在目标存储桶上删除这些版本。

MinIO 要求使用 mc replicate add --replicatemc replicate update --replicate 显式启用删除操作复制。 本过程包含用于启用删除操作和删除标记复制的必需标志。

MinIO 不会 复制因应用 lifecycle management expiration rules 而产生的删除操作。 请在所有复制站点上为该存储桶配置一致的过期规则,以确保对象过期策略得到一致应用。

过程

对于参与多站点复制配置的每个 MinIO 部署,都需要重复执行本过程中的步骤。根据部署数量的不同,该过程在实施时可能需要投入大量时间并格外谨慎。MinIO 建议在尝试执行文档中的步骤之前,先完整阅读本过程。

使用命令行 mc 配置多站点存储桶复制

本过程使用占位符 ALIAS 来引用每个被配置为复制端点的 MinIO 部署的 alias。 请将这些值替换为各个 MinIO 部署对应的实际别名。

本过程假设每个别名都对应一个具备 necessary replication permissions 的用户。

1) 创建新的存储桶复制规则

使用 mc replicate add 命令,为每个 MinIO 部署添加新的复制规则。

mc replicate add ALIAS/BUCKET \
   --remote-bucket 'https://USER:PASSWORD@HOSTNAME:PORT/BUCKET' \
   --replicate "delete,delete-marker,existing-objects"
  • ALIAS 替换为源 MinIO 部署的 别名。 该名称 必须 与上一步创建远端目标时指定的存储桶名称一致。

  • BUCKET 替换为源部署上要作为复制源的存储桶名称。

  • 使用 --remote-bucket 指定 ALIAS/BUCKET 要复制到的远端 MinIO 部署和存储桶。

    USER:PASSWORD 必须对应远端部署上具有 所需复制权限 的用户。

    HOSTNAME:PORT 必须能解析到远端部署上可访问的 MinIO 实例。 BUCKET 必须已存在,并满足其他所有 复制要求

  • --replicate "delete,delete-marker,existing-objects" 标志会启用以下复制功能:

    有关更完整的文档,请参阅 mc replicate add --replicate。 省略任意字段即可禁用对应组件的复制。

可按需为 mc replicate add 指定其他受支持的可选参数。

对于参与多站点复制配置的每个远程 MinIO 部署,都要重复执行这些命令。 例如,一个由 MinIO 部署 minio1minio2minio3 组成的多站点复制配置,需要在每个部署上针对每个远程端重复执行此步骤。

具体来说,在这种场景下,需要在每个部署上执行两次此步骤:

  • minio1 部署上,为 minio2 创建一条规则,再为 minio3 单独创建另一条规则。
  • minio2 部署上,为 minio1 创建一条规则,再为 minio3 单独创建另一条规则。
  • minio3 部署上,为 minio1 创建一条规则,再为 minio2 单独创建另一条规则。

2) 验证复制配置

在其中一个部署上,使用 mc cp 将新对象复制到已启用复制的存储桶中。

mc cp ~/foo.txt ALIAS/BUCKET

使用 mc ls 验证目标存储桶中存在该对象:

mc ls ALIAS/BUCKET

在每个部署上重复执行此测试:复制一个新的唯一文件,并检查该文件是否已复制到其他每个部署。

你也可以使用 mc stat 检查该文件,以查看对象当前的 replication stage

最后修改 August 2, 2026: init commit (8338d5b)

本页部分内容改编自 MinIO 对象存储文档,© 2020–至今 MinIO, Inc.,依据 CC BY 4.0 授权,由 Silo 项目转换与维护。归属与署名

本页为非官方中文翻译。如与英文原文有出入,以英文原文为准。