mc replicate add

变更: RELEASE.2022-12-24T15-21-38Z

mc replicate add 替代了 mc admin bucket remote add 命令。

MinIO 会根据给定的文件路径或资源位置（例如 IP 或 DNS 地址）自动创建远程目标。定义远程目标的用户不再需要为远程存储桶确定 ARN。

语法

mc replicate add 命令会为 MinIO 部署中的存储桶创建一条新的服务端复制规则。

远程存储桶必须位于与本地部署运行相同 MinIO 版本的 MinIO 部署上。

说明

mc mirror 仅同步对象的当前版本，而 mc replicate 会同步对象的所有版本、版本信息和元数据。

创建规则后，MinIO 部署会自动开始将新对象同步到远程 MinIO 部署。你也可以选择配置对现有对象、删除操作和已完全删除对象的同步。

以下命令为 myminio MinIO 部署上的 mydata 存储桶添加一条新的复制规则：

mc replicate add                                                     \
   --remote-bucket https://user:secret@minio.mysite.tld:9001/bucket  \
   --replicate "delete,delete-marker,existing-objects"               \
   myminio/mydata

该复制规则会将带版本的删除操作、删除标记和现有对象同步到远程 MinIO 部署。

变更: mc

RELEASE.2024-03-03T00-13-08Z

你可以在 --remote-bucket 参数中使用已配置的 ALIAS。

该命令语法如下：

mc [GLOBALFLAGS] replicate add                     \
                 --remote-bucket string          \
                 [--bandwidth "string"]            \
                 [--disable]                       \
                 [--disable-proxy]                 \
                 [--healthcheck-seconds integer]   \
                 [--id "string"]                   \
                 [--limit-upload "string"]         \
                 [--limit-download "string"]       \
                 [--path "string"]                 \
                 [--region "string"]               \
                 [--replicate "string"]            \
                 [--storage-class "string"]        \
                 [--sync]                          \
                 [--tags "string"]                 \
                 [--priority int]                  \
                 ALIAS

方括号 [] 表示可选参数。
同一行中的参数彼此相互依赖。
使用管道符 | 分隔的参数彼此互斥。

请先将示例复制到文本编辑器中并按需修改，再在终端 / shell 中运行命令。

参数

`ALIAS`

mc-cmd

Required

MinIO 部署的 alias，以及要在其上创建复制规则的存储桶或存储桶前缀的完整路径。例如：

mc replicate add --remote-bucket https://user:secret@myminio.cloudprovider.tld:9001/bucket play/mybucket

`--remote-bucket`

mc-cmd

Required

变更: mc

RELEASE.2024-03-03T00-13-08Z

--remote-bucket 支持指定已有的 alias。

指定远程位置的凭证、目标部署和存储桶。该值可以是 IP 地址、URL 或 alias/bucket。

例如，基于 URL 的目标可能如下所示：

https://user:secret@myminio.cloudprovider.tld:9001/bucket

基于 alias 的目标可能如下所示：

--remote-bucket minio-target/my-bucket

`--bandwidth`

mc-cmd

Optional

将带宽速率限制为不超过指定值，单位可为 KiB/s、MiB/s 或 GiB/s。有效单位包括：

B 表示 bytes
K 表示 kilobytes
G 表示 gigabytes
T 表示 terabytes
Ki 表示 kibibytes
Gi 表示 gibibytes
Ti 表示 tebibytes

例如，要将带宽速率限制为不超过 1 GiB/s，可使用以下参数：

--limit-upload 1Gi

若未指定，MinIO 不会限制带宽速率。

`--disable`

mc-cmd

Optional

以“disabled”状态创建复制规则。在使用 mc replicate update 将其启用之前，MinIO 不会按该规则开始复制对象。

在复制禁用期间创建的对象，在启用规则后不会立即具备复制资格。你必须在传给 mc replicate update --replicate 的复制功能列表中包含 "existing-objects"，以显式启用现有对象复制。更多信息请参见现有对象的复制。

`--disable-proxy`

mc-cmd

Optional

在定义存储桶之间的 active-active 复制时，不使用代理。

默认情况下，MinIO 使用代理。

`--healthcheck-seconds`

mc-cmd

Optional

两次远程存储桶健康检查之间的时间间隔（秒）。

若未指定，MinIO 使用 60 秒间隔。

`--id`

mc-cmd

Optional

为复制规则指定唯一 ID。如果未指定，MinIO 会自动生成一个 ID。

`--limit-download`

mc-cmd

Optional

将下载速率限制为不超过指定值，单位可为 KiB/s、MiB/s 或 GiB/s。有效单位包括：

B 表示 bytes
K 表示 kilobytes
G 表示 gigabytes
T 表示 terabytes
Ki 表示 kibibytes
Gi 表示 gibibytes
Ti 表示 tebibytes

例如，要将下载速率限制为不超过 1 GiB/s，可使用以下参数：

--limit-download 1G

若未指定，MinIO 使用不限速的下载速率。

`--limit-upload`

mc-cmd

Optional

将上传速率限制为不超过指定值，单位可为 KiB/s、MiB/s 或 GiB/s。有效单位包括：

B 表示 bytes
K 表示 kilobytes
G 表示 gigabytes
T 表示 terabytes
Ki 表示 kibibytes
Gi 表示 gibibytes
Ti 表示 tebibytes

例如，要将上传速率限制为不超过 1 GiB/s，可使用以下参数：

--limit-upload 1G

若未指定，MinIO 使用不限速的上传速率。

`--path`

mc-cmd

Optional

为远程存储桶启用 path-style 查找支持。

有效值包括：

on - 使用路径查找来定位远程存储桶
off - 使用资源定位符风格（如域名或 IP 地址）查找来定位远程存储桶
auto - 由 MinIO 自动识别用于定位远程存储桶的正确查找类型

未定义时，MinIO 使用 auto 值。

`--priority`

mc-cmd

Optional

指定复制规则的整数优先级。该值必须在源存储桶的所有其他规则中保持唯一。值越高表示优先级越高。

默认值为 0。

`--region`

mc-cmd

Optional

要将内容复制到的目标存储桶区域。

`--replicate`

mc-cmd

Optional

指定一个由逗号分隔的值列表，以启用扩展复制功能。

delete - 指示 MinIO 将 DELETE 操作复制到目标存储桶。
delete-marker - 指示 MinIO 将删除标记复制到目标存储桶。
existing-objects - 指示 MinIO 复制在启用复制前创建的对象，或在复制暂停期间创建的对象。
metadata-sync - 指示 MinIO 为每个对象复制元数据。仅适用于 active-active 复制场景。
省略此值会使 MinIO 停止将仅元数据变更回传到源端。

若未指定，MinIO 会同步所有选项。

`--storage-class`

mc-cmd

Optional

指定应用到复制对象上的 MinIO storage class。

`--sync`

mc-cmd

Optional

为该远程目标启用同步复制。

默认情况下，MinIO 使用异步复制。

`--tags`

mc-cmd

Optional

指定一个或多个以和号 & 分隔的键值对标签，MinIO 用其筛选要复制的对象。例如：

mc replicate add --tags "TAG1=VALUE&TAG2=VALUE&TAG3=VALUE" ALIAS

MinIO 会将复制规则应用到标签集合包含指定复制标签的任何对象。

全局参数

此命令支持全局标志中的任意选项。

示例

配置存储桶复制

以下 mc replicate add 命令会创建一个复制配置，将所有新对象、现有对象、删除操作和删除标记同步到远程目标：

mc replicate add myminio/mybucket \
   --remote-bucket https://user:secret@minio.mysite.tld/remotebucket \
   --replicate "delete,delete-marker,existing-objects"

将 myminio/mybucket 替换为 ALIAS 及要创建复制配置的完整存储桶路径。
将 --remote-bucket 的值替换为远程目标的 URL 或路径。如果使用文件路径格式的位置，请使用 --path on 选项。
--replicate 参数会指示 MinIO 将所有删除操作、删除标记和现有对象复制到远程端。关于复制行为的更多信息，请参见删除操作的复制和现有对象的复制。

为历史数据记录配置存储桶复制

以下 mc replicate add 命令会创建一个新的存储桶复制配置，将所有新对象和现有对象同步到远程目标：

mc replicate add myminio/mybucket \
   --remote-bucket https://user:secret@minio.mysite.tld/remotebucket \
   --replicate "existing-objects"

将 myminio/mybucket 替换为 ALIAS 及要创建复制配置的完整存储桶路径。
将 --remote-bucket 的值替换为远程目标的位置。如果使用文件路径格式的位置，请使用 --path on 选项。
--replicate 参数会指示 MinIO 将所有现有对象复制到远程端。关于复制行为的更多信息，请参见现有对象的复制。

生成的远程副本表示远程端对象的历史记录，源端的删除操作不会影响该远程副本。

行为

服务端复制要求源端和目标端均为 MinIO

MinIO 服务端复制仅适用于 MinIO 部署之间。源端和目标端部署都必须运行 MinIO。

若要在任意兼容 S3 的服务之间配置复制，请使用 mc mirror。

在源存储桶和目标存储桶上启用版本控制

MinIO 依赖版本控制提供的不可变性保护，在源端与复制目标之间同步对象。

在开始此流程前，使用 mc version enable 命令在源存储桶和目标存储桶两端启用版本控制：

mc version enable ALIAS/PATH

将 ALIAS 替换为 MinIO 部署的 alias。
将 PATH 替换为要启用版本控制的存储桶。

所需权限

MinIO 强烈建议专门创建用于支持存储桶复制操作的用户。关于向 MinIO 部署添加用户和策略的更完整文档，请参见 mc admin user 和 mc admin policy。

以下策略提供在部署上配置并启用复制所需的权限。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "admin:SetBucketTarget",
                "admin:GetBucketTarget",
                "admin:ListBatchJobs",
                "admin:DescribeBatchJob",
                "admin:StartBatchJob",
                "admin:CancelBatchJob"
            ],
            "Effect": "Allow",
            "Sid": "EnableRemoteBucketConfiguration"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket",
                "s3:ListBucketMultipartUploads",
                "s3:GetBucketLocation",
                "s3:GetBucketVersioning",
                "s3:GetObjectRetention",
                "s3:GetObjectLegalHold",
                "s3:PutReplicationConfiguration"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicationRuleConfiguration"
        }
    ]
}

"EnableRemoteBucketConfiguration" 语句授予创建远程目标以支持复制的权限。
"EnableReplicationRuleConfiguration" 语句授予在存储桶上创建复制规则的权限。 "arn:aws:s3:::* 资源将复制权限应用到源部署上的任意存储桶。你可以按需将用户策略限制到特定存储桶。

使用 mc admin policy create 将该策略添加到每个作为复制源的部署。使用 mc admin user add 在部署上创建用户，并使用 mc admin policy attach 将策略关联到该新用户。

以下策略提供将复制数据同步到该部署所需的权限。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket",
                "s3:ListBucketMultipartUploads",
                "s3:GetBucketLocation",
                "s3:GetBucketVersioning",
                "s3:GetBucketObjectLockConfiguration",
                "s3:GetEncryptionConfiguration"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicationOnBucket"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ReplicateTags",
                "s3:AbortMultipartUpload",
                "s3:GetObject",
                "s3:GetObjectVersion",
                "s3:GetObjectVersionTagging",
                "s3:PutObject",
                "s3:PutObjectRetention",
                "s3:PutBucketObjectLockConfiguration",
                "s3:PutObjectLegalHold",
                "s3:DeleteObject",
                "s3:ReplicateObject",
                "s3:ReplicateDelete"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicatingDataIntoBucket"
        }
    ]
}

"EnableReplicationOnBucket" 语句授予远程目标检索存储桶级配置的权限，以支持在 MinIO 部署中所有存储桶上的复制操作。若要将策略限制到特定存储桶，请在 Resource 数组中按 "arn:aws:s3:::bucketName" 形式指定这些存储桶。
"EnableReplicatingDataIntoBucket" 语句授予远程目标将数据同步到 MinIO 部署中任意存储桶的权限。若要将策略限制到特定存储桶，请在 Resource 数组中按 "arn:aws:s3:::bucketName/*" 形式指定这些存储桶。

使用 mc admin policy create 将该策略添加到每个作为复制目标的部署。使用 mc admin user add 在部署上创建用户，并使用 mc admin policy attach 将策略关联到该新用户。

现有对象复制

从 mc RELEASE.2021-06-13T17-48-22Z 和 minio RELEASE.2021-06-07T21-40-51Z 开始，MinIO 支持自动复制存储桶中的现有对象。 MinIO 的现有对象复制实现了类似 AWS Replicating existing objects between S3 buckets 的能力，而无需联系技术支持的额外开销。

若要在创建新复制规则时启用现有对象复制，请在传给 mc replicate add --replicate 的复制功能列表中包含 "existing-objects"。
若要为已有复制规则启用现有对象复制，请使用 mc replicate add --replicate 将 "existing-objects" 添加到现有复制功能列表中。编辑复制规则时，你必须指定所有期望的复制功能。

有关此行为的更完整文档，请参见现有对象的复制。

元数据变更同步

MinIO 支持双向 active-active 复制配置，即在两个 MinIO 部署上的存储桶之间同步新增和修改后的对象。从 mc RELEASE.2021-05-18T03-39-44Z 开始，MinIO 默认会将复制对象的仅元数据变更同步回“源”部署。在该更新之前，MinIO 不支持同步复制对象的仅元数据变更。

启用元数据同步后，MinIO 会重置对象的复制状态以表明其具备复制资格。具体而言，当应用对状态为 REPLICA 的对象执行仅元数据更新时，MinIO 会将对象标记为 PENDING 并使其具备复制资格。

若要禁用元数据同步，请使用 mc replicate update --replicate 命令，并在复制功能列表中省略 replica-metadata-sync。

删除操作复制

MinIO 支持将删除操作复制到目标存储桶。具体来说，MinIO 可以同时复制 Delete Markers 以及特定版本对象的删除：

对对象执行删除操作时，MinIO 复制也会在目标存储桶创建删除标记。
对对象版本执行删除操作时，MinIO 复制也会删除目标存储桶中的对应版本。

对于因生命周期管理过期规则被删除的对象，MinIO 不会进行复制。 MinIO 仅复制由客户端显式触发的删除操作。

MinIO 要求使用 mc replicate add --replicate 参数显式启用删除操作复制。本流程包含启用删除操作和删除标记复制所需的参数。有关此行为的更完整文档，请参见删除操作的复制。

加密对象复制

MinIO 支持复制使用自动 Server-Side Encryption (SSE-S3) 加密的对象。要复制加密对象，源存储桶和目标存储桶都必须启用自动 SSE-S3。

作为复制流程的一部分，MinIO 会在源存储桶上解密对象，并传输未加密对象。目标 MinIO 部署随后会使用目标存储桶的 SSE-S3 配置重新加密该对象。 MinIO 强烈建议在源端和目标端部署上都启用 TLS，以确保对象在传输过程中的安全。

MinIO 不支持复制客户端侧加密对象（SSE-C）。

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建，并针对 MinIO 和 AWS S3 进行了测试，以验证预期的功能与行为。

对于其他 S3 兼容服务，MinIO 不提供任何保证，因为这些服务的 S3 API 实现未知，因此不在支持范围内。虽然 mc 命令可能仍能按文档说明工作，但此类用法需要你自行承担风险。

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

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