SILO：Pigsty 持续维护的 MinIO 社区分支 on SILO

SILO 20260618 发布

Thu, 18 Jun 2026 00:00:00 +0000

发布日期： 2026-06-18 · 版本： RELEASE.2026-06-18T00-00-00Z

这是 pgsty/minio 社区分支的一次例行安全与依赖维护更新。该版本加固 LDAP STS 限流，补齐 S3 Select 超大记录限制，移除废弃的 ReadMultiple 节点间 storage-REST API，将 Go 构建基线升级到 1.26.4，并刷新 Go 模块依赖以吸收第三方安全修复。

续命 MinIO：承诺兑现

Fri, 17 Apr 2026 00:00:00 +0000

pgsty/minio 在三天内修复并发布多项高危漏洞补丁。兑现了“继续维护开源 MinIO 分支”的承诺。

CVE-2026-32285：最终无需补丁的 jsonparser 通告

Wed, 15 Apr 2026 00:00:00 +0000

状态： 无需代码改动，问题已关闭
GitHub Issue： pgsty/minio#26

安全维护不只有“发现漏洞，然后提交补丁”。CVE-2026-32285 的初始判断是：仓库可能仍携带未修复的 jsonparser，甚至一度讨论过替换依赖或维护自己的分支。真正检查 module version 与可达性后，结论却是当前代码已经使用包含修复的 v1.1.2，govulncheck 也没有发现可达的 vulnerable symbol。

Active Directory / LDAP 设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面说明通过 Active Directory 或 LDAP 服务启用外部身份管理所需的设置。有关使用这些设置的教程，请参见配置 MinIO 使用 Active Directory / LDAP 进行认证。

重要

在 RELEASE.2023-05-26T23-31-54Z 版本中新增：

相比使用配置设置，优先使用 mc idp ldap 命令将 MinIO 配置为使用 Active Directory 或 LDAP 进行身份管理。

AMQP 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本文档说明了将 AMQP 服务配置为存储桶通知目标的相关设置。有关如何使用这些设置的教程，请参阅将事件发布到 AMQP (RabbitMQ)。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

AssumeRoleWithCustomToken

Mon, 01 Jan 0001 00:00:00 +0000

MinIO Security Token Service (STS) 的 AssumeRoleWithCustomToken API 端点会生成一个令牌，用于配合 MinIO External Identity Management Plugin 使用。

请求端点

AssumeRoleWithCustomToken 端点的格式如下：

POST https://minio.example.net?Action=AssumeRoleWithCustomToken[&ARGS]

以下示例使用了所有受支持的参数。请将 minio.example.net 主机名替换为你的 MinIO 集群对应 URL：

mc admin accesskey create

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey create 命令为现有 MinIO 用户添加新的 access key 和 secret key 对。

OpenID Connect 或 AD/LDAP 用户的访问密钥

此命令用于为直接在 MinIO 部署上创建、且不由第三方方案管理的用户创建访问密钥。

mc admin cluster bucket import

Mon, 01 Jan 0001 00:00:00 +0000

描述

新增: RELEASE.2022-06-17T02-52-50Z

mc admin cluster bucket import 命令用于导入由 mc admin cluster bucket export 命令生成的存储桶元数据。

你可以使用此命令将元数据手动恢复到 MinIO 部署中的指定存储桶。

如果仅将部署指定为目标，此命令会将元数据对象应用到目标上所有匹配的存储桶。

mc admin cluster iam import

Mon, 01 Jan 0001 00:00:00 +0000

描述

新增: RELEASE.2022-06-17T02-52-50Z

mc admin cluster iam import 命令导入由 mc admin cluster iam export 命令创建的 IAM 元数据。

您可以使用此命令手动恢复 MinIO 部署的 IAM 元数据设置。

新增: mc

RELEASE.2024-09-09T07-53-10Z

该命令会输出导入结果，包括以下内容：

mc admin policy attach

Mon, 01 Jan 0001 00:00:00 +0000

语法

将一个或多个 IAM 策略附加到 MinIO 管理的用户或组。

变更: RELEASE.2023-05-27T05-56-19Z

要成功附加策略，所引用的用户或组必须存在。

必须且只能指定 --user 或 --group 二者之一。

以下命令将 readonly 策略附加到 alias 为 myminio 的部署中的用户 james。

mc admin prometheus generate

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin prometheus generate 命令会生成一个用于 Prometheus 的指标抓取配置文件。

有关 MinIO 与 Prometheus 配合使用的完整文档，请参见 How to monitor MinIO server with Prometheus

从 MinIO 服务端 RELEASE.2024-07-15T19-02-30Z 和 MinIO 客户端 RELEASE.2024-07-11T18-01-28Z 开始，metrics version 3 (v3) 提供了额外的端点和指标。要生成 v3 抓取配置，请使用 --api_version v3 选项。

mc admin scanner status

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin scanner status 命令会显示 MinIO Server 的 scanner 信息的实时摘要。

该命令的别名为 mc admin scanner info。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin user add

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user add 命令会在目标 MinIO 部署中添加一个新的 MinIO 用户。

要管理外部身份提供商用户，请参见 OIDC 或 AD/LDAP。

以下命令会在 myminio MinIO 部署上创建一个新用户 newuser：

mc admin user svcacct add

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey create 命令为内置 MinIO IDP 用户添加访问密钥。

mc alias list

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc alias list 命令列出本地 mc 配置中的所有别名。

该命令输出包含每个别名关联的 access key 和 secret key 配置。

以下命令列出本地主机上配置的所有 aliases：

mc anonymous set

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc anonymous set 命令为存储桶设置匿名（即未认证或公开）访问策略。

配置了匿名策略的存储桶允许客户端在无需身份验证的情况下，访问存储桶内容并执行与指定策略一致的操作。

mc batch cancel

Mon, 01 Jan 0001 00:00:00 +0000

新增: mc

RELEASE.2023-03-20T17-17-53Z

语法

mc batch cancel 可停止正在进行的批处理作业。

您必须指定作业 ID。要查找作业 ID，请使用 mc batch list。

以下命令会输出标识为 KwSysDpxcBU9FNhGkn2dCf 的作业定义。

mc encrypt clear

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc encrypt clear 命令用于移除存储桶当前的默认加密设置。

以下命令会移除 myminio alias 关联的 MinIO 部署中 mydata 存储桶的默认加密设置：

mc event add

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc event add 命令为存储桶添加事件通知触发器。

MinIO 会将已触发的事件自动发送到已配置的 notification target。

以下命令为 myminio MinIO 部署中的 mydata 存储桶上的所有 PUT 和 DELETE 操作创建新的事件通知触发器：

mc idp ldap accesskey disable

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap accesskey disable 会在 MinIO 部署上禁用指定的 access key。

以下示例在 minio 部署上禁用访问密钥 mykey：

mc idp ldap add

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap add 命令用于创建 AD/LDAP IDP 服务器配置。

每个 MinIO 部署最多仅支持一个 (1) AD/LDAP 提供商。

以下示例为 myminio 部署设置 AD/LDAP 配置项。

mc idp ldap policy attach

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap policy attach 命令将一个或多个策略附加到实体。

以下示例将策略 userpolicy 附加到 myminio 部署中的用户 bobfisher：

mc idp ldap policy attach myminio \
 userpolicy \
 --user='uid=bobfisher,ou=people,ou=hwengg,dc=min,dc=io'

该命令的语法如下：

mc ilm add

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm add 已由 mc ilm rule add 取代。

语法

mc ilm add 命令用于向存储桶添加对象生命周期管理规则。

该命令支持同时添加 Transition (Tiering) 和 Expiration 生命周期管理规则。

以下命令会向 myminio 部署上的 mydata 存储桶添加新的生命周期管理规则：

mc ilm restore

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc ilm restore 命令会为归档在远程层上的对象创建一个临时副本。默认情况下，该副本会在 1 天后自动过期。

使用此命令可让应用程序通过 MinIO 部署访问分层对象（例如“热层”）。归档对象会保留在远程层，而临时副本会成为该对象的 HEAD。

mc ilm rule add

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm rule rm 替代 mc ilm add。

语法

mc ilm rule add 命令用于向存储桶添加对象生命周期管理规则。

该命令支持添加迁移（分层）和过期两类生命周期管理规则。

以下命令将新的生命周期管理规则添加到 myminio 部署上的 mydata 存储桶：

mc ilm tier add

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm tier add 替代了 mc admin tier add。

描述

mc ilm tier add 命令在受支持的存储服务上创建一个新的远程存储层。

完整列表请参见对象转换。

支持的 S3 服务

mc ilm tier add 仅支持以下 S3 兼容服务作为对象分层的远程目标：

mc legalhold clear

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc legalhold clear 命令会移除一个或多个对象当前的 legal hold 设置。

移除对象的 legal hold 不会移除对象上已有的其他 GOVERNANCE 模式和 COMPLIANCE 模式保留设置。

以下命令会移除 myminio MinIO 部署中 mydata 存储桶内所有对象的 legal hold：

mc license info

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc license info 命令用于显示 MinIO 部署的许可证状态信息。具体来说，用于确认该部署使用的是 AGPLv3 开源许可证，还是 MinIO Commercial License。

你必须在 MinIO MinIO SUBNET 中注册部署，才能激活商业许可证。

mc quota clear

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2022-12-13T00-23-28Z

mc quota clear 替代了 mc admin bucket quota --clear。

变更: RELEASE.2024-07-31T15-58-33Z

mc quota clear 已弃用。

说明

mc quota clear 命令会移除存储桶上已配置的存储配额。

示例

清除已配置的存储桶配额

使用 mc quota clear 标志可从存储桶中移除配额。

mc quota clear TARGET/BUCKET

将 TARGET 替换为已配置 MinIO 部署的 alias。将 BUCKET 替换为要清除配额的存储桶名称。

语法

mc quota clear 的语法如下：

mc replicate add

Mon, 01 Jan 0001 00:00:00 +0000

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

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

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

mc retention set

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc retention set 命令用于为存储桶中的一个或多个对象配置 Write-Once Read-Many (WORM) locking 设置。你还可以为存储桶设置默认对象锁定设置，使未显式配置对象锁定的所有对象继承该存储桶默认值。

mc share download

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc share download 命令会生成一个临时的预签名 URL，并集成访问凭证，用于从 MinIO 存储桶下载对象。该临时 URL 会在可配置的时间限制后过期。

应用程序可以通过执行 GET 从该 URL 获取对象。
用户可以在浏览器中打开该 URL 下载对象。

有关可共享对象 URL 的更多信息，请参阅 Amazon S3 关于 Pre-Signed URLs.

mc support callhome

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc support callhome 命令用于启用或禁用将部署诊断信息发送到 MinIO SUBNET。

所有 mc support 命令都需要有效的 SUBNET 订阅。

启用后，MinIO 会将诊断信息发送到 SUBNET。

无论注册状态如何，MinIO 默认禁用此功能。你必须显式启用 callhome 功能，信息上传才会开始。

mc support top api

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

语法

mc support top api 命令用于汇总 MinIO 部署服务器上的实时 API 事件。

mc tag set

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc tag set 命令可为存储桶或对象设置一个或多个标签。

MinIO 支持为对象最多添加 10 个自定义标签。

以下命令为 myminio MinIO 部署中的 mydata 存储桶设置标签：

mc version enable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc version enable 命令用于为指定存储桶启用版本控制。

以下命令为 myminio MinIO 部署中的 mybucket 存储桶启用版本控制：

MinIO 客户端设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面介绍 MinIO Client 的设置。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

MinIO 自定义资源定义

Mon, 01 Jan 0001 00:00:00 +0000

MinIO Operator 会安装一个 Custom Resource Definition (CRD)，用于描述 MinIO Tenant 对象。 Operator 使用该 CRD 在 Kubernetes 集群中对 Tenant 资源进行配置和管理。

本页提供 CRD 参考文档，用于自定义由 Operator 部署的 Tenant。本文档默认读者已熟悉其中引用的 Kubernetes 概念、工具和流程。

部署架构

Mon, 01 Jan 0001 00:00:00 +0000

本页从生产视角概述 MinIO 的部署架构。有关具体硬件或软件配置的信息，请参阅：

分布式 MinIO 部署

生产级 MinIO 部署至少由 4 台具有同构存储和计算资源的 MinIO 主机构成。

部署一个 MinIO Tenant

Mon, 01 Jan 0001 00:00:00 +0000

本步骤说明如何使用 MinIO Operator 部署 MinIO Tenant。

部署 Single-Node 拓扑需要额外配置，而这些内容不在本文档覆盖范围内。如果只是用于本地测试或评估，你也可以根据需要使用简单的 Kubernetes YAML 对象来描述 Single-Node 拓扑。 MinIO 不建议，也不支持在生产环境中使用单节点部署拓扑。

存储桶版本控制

Mon, 01 Jan 0001 00:00:00 +0000

概述

MinIO 支持在单个存储桶中保留对象的多个“版本”。

启用后，版本控制允许 MinIO 保留同一对象的多个迭代版本。原本会覆盖现有对象的写入操作，将改为为该对象创建一个新版本。 MinIO 版本控制可以防止意外覆盖和删除，同时支持对写入操作执行“撤销”。配置对象锁定和保留规则的前提条件之一，就是启用存储桶版本控制。

管理部署

Mon, 01 Jan 0001 00:00:00 +0000

你可以使用 MinIO Console 执行 MinIO 提供的多种部署监控与管理功能，例如：

通过查看指标仪表板、服务器日志或审计日志、追踪历史、S3 事件或驱动器健康状态，监控部署活动与健康状况。
通过添加或管理通知目标来配置告警。
设置站点复制，以同步数据中心，满足地理分散团队的及时访问需求，或用于灾难准备。
配置部署设置。

重要

加密文件

Mon, 01 Jan 0001 00:00:00 +0000

说明

你可以对 mc support inspect 命令的输出进行加密，以便在将文件传输到 MinIO SUBNET 时提升安全性。

加密

你可以使用 --encrypt 标志对输出的 zip 文件进行加密，以提升安全性。 MinIO 提供了一个二进制工具用于解密该文件。

将 MinIO 与 Veeam 搭配使用

Mon, 01 Jan 0001 00:00:00 +0000

在使用 Veeam Backup and Replication 时，可以将 MinIO 这类 S3 兼容对象存储用作备份的容量层。这会将 Veeam 基础设施中的存储解耦，并让你继续掌控自己的数据。借助 MinIO 在部署与管理上的易用性，Veeam 备份管理员可以轻松部署自己的对象存储用于容量分层。

将对象迁移到远程 MinIO 部署

Mon, 01 Jan 0001 00:00:00 +0000

本页中的操作步骤用于创建新的对象生命周期管理规则，将对象从主 MinIO 部署上的某个存储桶迁移到远程 MinIO 部署上的某个存储桶。该流程支持成本管理策略，例如将对象从使用 NVMe 存储的“热” MinIO 部署分层到使用 SSD 的“温” MinIO 部署。

将事件发布到 AMQP (RabbitMQ)

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将 bucket notification 事件发布到 AMQP 0-9-1 服务端点，例如 RabbitMQ。

MinIO 依赖 https://github.com/streadway/amqp 项目实现 AMQP 连接。该项目主要针对 RabbitMQ 部署进行测试，但其他兼容 AMQP 0-9-1 的服务也可能可以使用。本页中的步骤假定服务端点为使用 AMQP 0-9-1 协议的 RabbitMQ 部署。

配置 MinIO 使用 Active Directory / LDAP 进行认证

Mon, 01 Jan 0001 00:00:00 +0000

概览

MinIO 支持配置单个 Active Directory / LDAP 连接，用于对用户身份进行外部管理。

本页流程提供以下内容的操作说明：

对于使用 MinIO Kubernetes Operator 部署的 MinIO Tenant，本流程包括：

批量复制

Mon, 01 Jan 0001 00:00:00 +0000

新增: MinIO

RELEASE.2022-10-08T20-11-00Z

批处理框架在 mc RELEASE.2022-10-08T20-11-00Z 中随 replicate 作业类型一同引入。

MinIO 批处理框架允许您使用 YAML 格式的作业定义文件（“批处理文件”）来创建、管理、监控和执行作业。批处理作业直接在 MinIO 部署上运行，可利用服务端处理能力，而不受运行 MinIO Client 的本地机器限制。

驱动器故障恢复

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将故障驱动器热替换为新的健康驱动器。 MinIO 会检测这些驱动器并对其执行自愈，无需在节点级或部署级执行重启。 MinIO 自愈仅发生在被替换的驱动器上，大多数情况下对部署性能影响很小或几乎可以忽略。

设置存储桶复制的要求

Mon, 01 Jan 0001 00:00:00 +0000

存储桶复制使用规则将一个 MinIO 部署中的存储桶内容同步到远端 MinIO 部署中的存储桶。

复制可以通过以下任一方式完成：

Active-Passive 符合条件的对象会从源存储桶复制到远端存储桶。远端存储桶上的任何更改都不会反向复制回来。
Active-Active 任一存储桶中符合条件对象的更改都会以双向方式复制到另一个存储桶。
Multi-Site Active-Active 任何已设置存储桶复制的存储桶中符合条件对象的更改，都会复制到所有其他存储桶。

在设置这些复制配置之前，请确保满足以下前提条件。

使用 cert-manager 管理 Operator 证书

Mon, 01 Jan 0001 00:00:00 +0000

MinIO Operator 负责管理 minio-operator 命名空间中各服务的 TLS 证书签发。

本页说明如何使用 cert-manager 管理 Operator 的 TLS 证书。

前提条件

使用受支持版本的 Kubernetes
已安装 kustomize
可以通过 kubectl 访问你的 k8s 集群
已完成 cert-manager 配置
MinIO Operator 尚未安装

1) 为 `minio-operator` 命名空间创建 CA Issuer

本指南将禁用 MinIO Operator 的自动证书生成功能，改为使用 cert-manager 签发证书。

使用 Helm 部署 Operator

Mon, 01 Jan 0001 00:00:00 +0000

概览

Helm 是一个用于将应用自动部署到 Kubernetes 集群的工具。 Helm chart 是一组定义部署细节的 YAML 文件、模板和其他文件。以下步骤使用 Helm Chart 将 MinIO Kubernetes Operator 安装到 Kubernetes 集群中。

前提条件

基础要求请参阅 Operator 前提条件。使用 Helm 安装还需要满足以下额外要求：

使用 KES 进行服务端对象加密

Mon, 01 Jan 0001 00:00:00 +0000

本流程假定你可以访问一个已经安装并启用了 MinIO Operator 的 Kubernetes 集群。关于如何运行 KES，请参见 KES 文档。

使用 Prometheus 进行监控与告警

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 使用 Prometheus 数据模型发布集群、节点、存储桶和资源指标。本页过程说明了以下内容：

配置 Prometheus 服务，抓取并展示 MinIO 部署的指标
基于某个 MinIO 指标配置 Alert Rule，以触发 AlertManager 动作

本文说明使用 version 2 指标。关于指标 API 版本的更多信息，请参见指标与告警。

使用按存储桶划分密钥的服务端加密（SSE-KMS）

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 服务端加密（SSE）在写入操作过程中保护对象，使客户端能够利用服务端的处理能力在存储层保护对象（静态加密）。 SSE 还为围绕安全锁定和擦除的监管与合规要求提供关键能力。

为 MinIO 启用 TLS

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持使用 Transport Layer Security (TLS) 1.2+ 对入站和出站流量进行加密。

MinIO Operator 支持通过以下方式为 MinIO 租户启用 TLS：

许可协议

Mon, 01 Jan 0001 00:00:00 +0000

Silo 涉及两套彼此独立的许可协议：软件与文档的分发条款不同，各自沿用其上游作品原有的许可。

对象	许可协议	位置
`silo` 服务端	GNU AGPLv3	`pgsty/minio`
`mcli` 客户端	GNU AGPLv3	`pgsty/mc`
本文档	CC BY 4.0	`pgsty/silo-docs`

软件：AGPLv3

Silo 是 MinIO 的分支，而 MinIO 自 2021 年起便以 GNU Affero 通用公共许可证第 3 版分发。对于已经以该许可发布的代码，授权不可撤回——这正是本分支得以存在的法律基础。 Silo 沿用同一许可：不重新授权、不附加限制、不做开源核心式的功能阉割。

硬件检查清单

Mon, 01 Jan 0001 00:00:00 +0000

在为生产级分布式 MinIO 部署规划硬件配置时，请使用以下检查清单。

考虑因素

在为 MinIO 选型硬件时，请考虑以下因素：

上线时预计需要存储的数据量（tebibyte）
至少未来两年内数据规模的预期增长
对象数量以及平均对象大小
数据的平均保留时长（年）
计划部署的站点数量
预期的存储桶数量

用户管理

Mon, 01 Jan 0001 00:00:00 +0000

概述

MinIO 用户由唯一的访问密钥（用户名）及其对应的密钥（密码）组成。客户端必须同时指定现有 MinIO 用户的有效访问密钥（用户名）及其对应的密钥（密码），才能完成身份认证。

在 RedHat Linux 上部署 MinIO

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍如何在 RedHat Linux 操作系统上部署 MinIO，包括与 RHEL 二进制兼容的发行版。本页不特别区分 RHEL 与这些发行版；为 RHEL 提供的指导通常也适用于这些发行版。

SILO 20260417 发布

Fri, 17 Apr 2026 00:00:00 +0000

发布日期： 2026-04-17 · 版本： RELEASE.2026-04-17T00-00-00Z

本次版本聚焦安全加固与兼容性收敛，集中修复了 OIDC、LDAP STS、S3 Select、对象复制元数据、unsigned-trailer、Snowball 上传链路，以及依赖与 Go 工具链相关的多项安全问题，并同步完成 LDAP TLS 回归修复与社区分叉文档整理。

CVE-2026-33322：OIDC JWT 算法混淆

Wed, 15 Apr 2026 00:00:00 +0000

状态： 已发布
首个包含版本： RELEASE.2026-04-17T00-00-00Z
影响入口： AssumeRoleWithWebIdentity、AssumeRoleWithClientGrants
GitHub Issue： pgsty/minio#22

MinIO 已死，MinIO 复生

Sat, 14 Feb 2026 00:00:00 +0000

MinIO 仓库正式归档并彻底放弃维护，开源对象存储用户将何去何从？AI Agent 如何助力 MinIO 起死回生？

AssumeRoleWithLDAPIdentity

Mon, 01 Jan 0001 00:00:00 +0000

MinIO Security Token Service (STS) AssumeRoleWithLDAPIdentity API 端点使用 Active Directory 或 LDAP 用户凭据生成临时访问凭据。本文档介绍 MinIO 服务端 AssumeRoleWithLDAPIdentity 端点。有关如何使用兼容 S3 的 SDK 实现 STS，请参考对应 SDK 的文档。

MinIO STS AssumeRoleWithLDAPIdentity API 端点以 AWS AssumeRoleWithWebIdentity 端点为模型，并共享部分请求/响应元素。本文档介绍 MinIO 特有的语法，并为所有共享元素提供指向 AWS 参考文档的链接。

Elasticsearch 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本文档介绍如何配置 Elasticsearch 服务作为存储桶通知的目标。有关如何使用这些设置的教程，请参阅将事件发布到 Elasticsearch。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

mc admin accesskey disable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey disable 命令用于禁用 MinIO IDP 用户的现有访问密钥。

以下命令会禁用指定的访问密钥：

mc admin cluster bucket export

Mon, 01 Jan 0001 00:00:00 +0000

描述

新增: RELEASE.2022-06-17T02-52-50Z

mc admin cluster bucket export 命令会导出存储桶元数据，以供 mc admin cluster bucket import 命令使用。

你可以使用此命令手动备份指定 MinIO 存储桶的元数据。该命令始终将输出保存为 cluster-metadata.zip。

如果你仅将部署指定为目标，此命令会备份目标部署上所有存储桶的元数据。

mc admin cluster iam export

Mon, 01 Jan 0001 00:00:00 +0000

描述

新增: RELEASE.2022-06-26T18-51-48Z

mc admin cluster iam export 命令导出 IAM 元数据，以供 mc admin cluster iam import 命令使用。

该命令将输出保存为 ALIAS-iam-metadata.zip，其中 ALIAS 是 MinIO 部署的 alias。

mc admin policy create

Mon, 01 Jan 0001 00:00:00 +0000

Syntax

在目标 MinIO 部署上创建一个新策略。

MinIO 部署默认包含以下内置策略：

假设以下 JSON 策略文档保存在名为 /tmp/listmybuckets.json 的文件中：

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action": [
 "s3:ListAllMyBuckets"
 ],
 "Resource": [
 "arn:aws:s3:::*"
 ]
 }
 ]
}

以下命令使用文件 /tmp/listmybuckets.json 中的策略，在 alias myminio 上创建一个名为 listmybuckets 的新策略。

mc admin prometheus metrics

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin prometheus metrics 命令用于输出集群的 Prometheus 指标。

输出还包含每个指标的附加信息，例如其值类型是 counter 还是 gauge。

有关将 MinIO 与 Prometheus 配合使用的完整文档，请参阅 How to monitor MinIO server with Prometheus

mc admin scanner trace

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin scanner trace 命令会显示目标 MinIO 部署上发生的 scanner 相关 API 操作。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin user disable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user disable 命令用于在目标 MinIO 部署上禁用 MinIO 用户。

客户端不能使用该用户凭证向 MinIO 部署进行身份验证。禁用用户不会将该用户从部署中移除。使用 mc admin user enable 可在 MinIO 部署上启用已禁用的用户。

mc admin user svcacct disable

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey disable 命令禁用内置 MinIO IDP 用户的访问密钥。

mc alias remove

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc alias remove 从本地 mc 配置中移除一个已存在的别名。

以下命令会从主机上移除 MinIO 部署的 myminio alias：

mc anonymous get

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc anonymous get 命令用于获取存储桶的匿名（即未认证或公共）访问策略。

配置了匿名策略的存储桶允许客户端在无需身份验证的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch describe

Mon, 01 Jan 0001 00:00:00 +0000

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch describe 命令会输出指定作业 ID 的作业定义。

必须指定作业 ID。要查找作业 ID，请使用 mc batch list。

以下命令会输出标识为 KwSysDpxcBU9FNhGkn2dCf 的作业定义。

mc encrypt info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc encrypt info 命令返回存储桶当前的默认加密设置。

以下命令返回 myminio MinIO 部署上 mydata 存储桶的默认加密设置。

mc event ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc event ls 命令列出某个存储桶的所有事件通知触发器。

别名 mc event list 与 mc event ls 功能等效。

以下命令列出 myminio MinIO 部署中 mydata 存储桶、指定 bucket notification target 的所有已配置事件通知：

mc idp ldap accesskey edit

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc idp ldap accesskey edit 在本地服务器上修改指定的 access key。

以下示例在 minio 部署上修改 access key mykey 的 secret：

mc idp ldap disable

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap disable 命令用于禁用当前已配置的 AD/LDAP 提供程序。

以下示例会在 myminio 部署上禁用 AD/LDAP 配置。

mc idp ldap policy detach

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap policy detach 命令可从实体分离一个或多个策略。

以下示例从 myminio 部署中的用户 bobfisher 分离策略 userpolicy。

mc idp ldap policy detach myminio \
 userpolicy \
 --user='uid=bobfisher,ou=people,ou=hwengg,dc=min,dc=io'

该命令具有以下语法：

mc [GLOBALFLAGS] idp ldap policy detach \
 POLICYNAME \
 [POLICY2] ... \
 ALIAS \
 [--user=`USER`] \
 [--group=`GROUP`]

将 ALIAS 替换为 MinIO 部署的 alias，用于配置 AD/LDAP 集成。

mc ilm edit

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm edit 已被 mc ilm rule edit 取代。

语法

mc ilm edit 命令用于修改 MinIO 存储桶上现有的对象生命周期管理规则。

以下命令用于修改 myminio 部署上 mydata 存储桶的现有生命周期管理规则：

mc ilm rule edit

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm rule edit 替代 mc ilm edit。

语法

mc ilm rule edit 命令用于修改 MinIO 存储桶上现有的对象生命周期管理规则。

以下命令用于修改 myminio 部署上 mydata 存储桶的现有生命周期管理规则：

mc ilm tier check

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc ilm tier check 命令用于显示某个部署上远程层的配置。

语法

该命令具有以下语法：

以下示例显示 myminio 部署上名为 WARM-TIER 的现有远程层配置。

 mc ilm tier check myminio WARM-TIER

该命令具有以下语法：

mc legalhold info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc legalhold info 命令返回一个或多个对象的当前 legal hold 设置。

mc legalhold 要求指定的存储桶已启用对象锁定。你只能在创建存储桶时启用对象锁定。有关创建启用对象锁定的存储桶，请参阅 mc mb --with-lock 文档。

mc license register

Mon, 01 Jan 0001 00:00:00 +0000

重要

mc license register 需要 MinIO Client RELEASE.2023-11-20T16-30-59Z 或更高版本。虽非强制要求，但最佳实践是保持 MinIO 客户端版本与 MinIO 服务端版本一致。

描述

mc license register 命令会将你的部署与 MinIO SUBNET 账户关联。

注册后，你可以使用 mc support diag 命令将部署健康报告直接上传到 SUBNET。

mc quota info

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2022-12-13T00-23-28Z

mc quota info 替代了 mc admin bucket quota。

变更: RELEASE.2024-07-31T15-58-33Z

mc quota info 已弃用。

说明

mc quota info 命令显示存储桶当前配置的配额。

示例

获取存储桶配额配置

使用 mc quota info 获取存储桶当前的配额配置：

mc quota info TARGET/BUCKET

将 TARGET 替换为已配置 MinIO 部署的 alias。将 BUCKET 替换为要查询配额的存储桶名称。

mc replicate backlog

Mon, 01 Jan 0001 00:00:00 +0000

变更: mc.RELEASE.2023-07-18T21-05-38Z

mc replicate diff 已重命名为 mc replicate backlog。功能未发生变化。

描述

mc replicate backlog 显示尚未复制的新建或已删除对象列表。

你可以列出特定远程目标的对象复制状态。为此，你必须具有该远程目标的 ARN。你可以使用检索为存储桶配置的远程目标查找 ARN。

mc retention info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc retention info 命令用于为对象或存储桶中的对象配置 Write-Once Read-Many (WORM) locking 设置。你还可以为存储桶设置默认对象锁定设置，未显式配置对象锁定的对象会继承该存储桶默认值。

mc share upload

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc share upload 命令会生成一个临时的预签名 URL，并集成用于将对象上传到 MinIO 存储桶的访问凭证。该临时 URL 会在可配置的时间限制后过期。

应用程序可以通过该 URL 执行 PUT 以上传对象。

mc support diag

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

命令历史

用于创建诊断报告的命令会随版本演进而变化。

mc support top locks

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

语法

mc support top locks 命令列出 MinIO 部署中最旧的 10 个锁。

mc tag list

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc tag list 命令列出存储桶或对象上的所有标签。

以下命令列出 myminio MinIO 部署中 mydata 存储桶的标签：

mc version info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc version info 命令返回指定存储桶的版本控制状态。

以下命令返回 myminio MinIO 部署中 mybucket 存储桶的版本控制状态：

MinIO Operator 环境变量

Mon, 01 Jan 0001 00:00:00 +0000

MinIO Operator 在启动期间使用以下环境变量来设置配置项。请在 minio-operator 容器中配置这些变量。

在 Kubernetes 中设置环境变量

要设置这些环境变量，请修改 Operator 容器 YAML 中的 .spec.env，或使用以下 kubectl 命令语法：

MinIO 对象锁定

Mon, 01 Jan 0001 00:00:00 +0000

概述

MinIO 对象锁定（“对象保留”）通过强制执行一次写入、多次读取（WORM）不可变性，防止已启用版本控制的对象被删除。MinIO 同时支持基于时长的对象保留和无限期 legal hold 保留。

OpenID Connect 访问管理

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持使用兼容 OpenID Connect (OIDC) 的 Identity Provider (IDP)，例如 Okta、KeyCloak、Dex、Google 或 Facebook，来进行外部用户身份管理。

对于由外部 OpenID Connect (OIDC) 兼容提供方管理的身份，MinIO 可以通过以下两种方式之一，将策略分配给已认证用户。

OpenID 身份管理设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面记录了如何使用与 OpenID Connect (OIDC) 兼容的提供方来启用外部身份管理的相关设置。有关如何使用这些设置的教程，请参见 OpenID Connect 访问管理。

你可以通过以下方式建立或修改设置：

安全检查清单

Mon, 01 Jan 0001 00:00:00 +0000

在为生产级分布式 MinIO 部署规划安全配置时，请使用以下检查清单。

必做步骤

在 MinIO 或所选的第三方身份提供商（LDAP/Active Directory 或 OpenID）中定义组策略

部署级服务端加密密钥（SSE-S3）

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 服务端加密（SSE）在写入操作期间保护对象，使客户端能够利用服务端的处理能力，在存储层保护对象（静态加密）。SSE 还为围绕安全锁定和擦除的监管与合规要求提供关键能力。

管理对象

Mon, 01 Jan 0001 00:00:00 +0000

你可以使用 MinIO Console 执行 MinIO 提供的多种存储桶和对象管理及交互操作。根据已认证用户的权限和 IAM 策略，你可以：

对象浏览器

对象浏览器会列出已认证用户在该部署上有权访问的存储桶和对象。

核心设置

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍用于控制 MinIO 进程核心行为的设置。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

将对象从 MinIO 迁移到 S3

Mon, 01 Jan 0001 00:00:00 +0000

本页中的步骤将创建一条新的对象生命周期管理规则，用于将对象从 MinIO 存储桶迁移到 Amazon Web Services S3 存储后端或兼容 S3 的服务上的远程存储层。该过程适用于这类场景：在经过一定时间周期或达到某个日历日期后，将对象分层到低成本存储或归档存储。

将服务日志或审计日志发布到外部服务

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 会将所有 minio server 操作输出到系统控制台。如何读取这些日志取决于 server 进程的管理方式。例如，如果 server 通过 systemd 脚本进行管理，你可以使用 journalctl -u SERVICENAME.service 读取日志。请将 SERVICENAME 替换为 MinIO 服务名称。

将事件发布到 MQTT

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将存储桶通知事件发布到 MQTT server/broker 端点。

向 MinIO 部署添加 MQTT 端点

以下过程会添加一个新的 MQTT 服务端点，以在 MinIO 部署中支持存储桶通知。

前提条件

MQTT 3.1 或 3.1.1 服务器/代理

此过程假定已存在一个 MQTT 3.1 或 3.1.1 server/broker，且 MinIO 部署能够连接到它。有关兼容 MQTT 的 server/broker 列表，请参见 mqtt.org software listing。

节点故障恢复

Mon, 01 Jan 0001 00:00:00 +0000

如果某个 MinIO 节点发生完全硬件故障（例如所有驱动器、数据等全部丢失），则该节点在重新加入部署后会开始执行自愈操作。 MinIO 自愈仅发生在被替换的硬件上，通常不会影响部署性能。

可用性与韧性

Mon, 01 Jan 0001 00:00:00 +0000

本页从生产视角概述 MinIO 在可用性与韧性方面的设计和特性。

说明

本页内容旨在尽力帮助你理解 MinIO 在可用性与韧性方面的预期设计和理念。它不能替代 MinIO SUBNET 的能力。使用 MinIO SUBNET 可以在规划 MinIO 部署时与 MinIO Engineering 协同。

配置 MinIO 使用 Keycloak 进行认证

Mon, 01 Jan 0001 00:00:00 +0000

概览

本流程将 MinIO 配置为通过 OpenID Connect (OIDC) 协议，使用 Keycloak 作为外部 Identity Provider (IDP) 来认证用户。

本页提供了在 Kubernetes 和裸金属基础设施上的 MinIO 部署中配置 OIDC 的流程。

请选择与你基础设施对应的标签页，在不同说明集之间切换。

批量密钥轮换

Mon, 01 Jan 0001 00:00:00 +0000

新增: MinIO

RELEASE.2023-04-07T05-28-58Z

MinIO Batch Framework 允许你使用 YAML 格式的作业定义文件（“批处理文件”）来创建、管理、监控和执行作业。批处理作业直接在 MinIO 部署上运行，以利用服务端处理能力，而不受运行 MinIO Client 的本地机器限制。

启用服务端单向存储桶复制

Mon, 01 Jan 0001 00:00:00 +0000

本页面中的过程会创建一条新的存储桶复制规则，用于将对象从一个 MinIO 存储桶单向复制到另一个 MinIO 存储桶。这些存储桶既可以位于同一个 MinIO 部署中，也可以位于不同的 MinIO 部署中。

商标声明

Mon, 01 Jan 0001 00:00:00 +0000

警告

本文文档中出现的 MinIO 名称，均为描述性使用，未暗示任何商业合作关系。

Silo 是由 PIGSTY 社区独立维护的分支，与 MinIO, Inc. 无关联，未获其认可或赞助。

项目为避免混淆所做的事

本分支以自己的名称 Silo 发布，而非冒用 MinIO 之名。
本站每一个页面的页脚都带有商标免责声明。
在所有分发渠道——代码仓库、容器镜像、发行制品与本文档——均明确标注为社区分支。
从不宣称与 MinIO, Inc. 存在关联、认可、认证或商业合作关系。

为什么这个名字仍然出现在文档中？

许可协议授予的是著作权层面的权利，它不涉及名称。 AGPLv3 赋予任何人分支与再分发 MinIO 代码库的权利，但商标法属于另一个领域，商标使用并不因许可协议而自动解决。

升级 MinIO Operator

Mon, 01 Jan 0001 00:00:00 +0000

你可以随时升级 MinIO Operator，而不会影响其管理的 MinIO Tenant。

在升级过程中，Operator 可能会更新并重启 Tenant，以支持 MinIO 自定义资源定义（CRD）的变更。这些变更不需要操作员或管理员采取额外操作，也不会影响 Tenant 的运行。

升级 MinIO 部署

Mon, 01 Jan 0001 00:00:00 +0000

重要

对于早于 RELEASE.2024-03-30T09-41-56Z 且启用了 AD/LDAP 的部署，在开始本步骤前，你必须先完整阅读 RELEASE.2024-04-18T19-09-19Z 的发布说明。你必须将该发布说明中记录的额外步骤纳入升级过程。

MinIO 使用先更新后重启的方法将部署升级到较新版本：

使用 Helm Charts 部署 MinIO Tenant

Mon, 01 Jan 0001 00:00:00 +0000

概览

Helm 是一个用于将应用自动部署到 Kubernetes 集群的工具。 Helm chart 是一组定义部署细节的 YAML 文件、模板和其他文件。以下步骤使用 Helm Chart 部署由 MinIO Operator 管理的 Tenant。

本步骤要求 Kubernetes 集群中已存在一个有效的 Operator 部署。你不能使用 MinIO Operator Tenant chart 在脱离 Operator 的情况下独立部署 Tenant。

使用 InfluxDB 进行监控与告警

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 使用 Prometheus 数据模型发布集群和节点指标。 InfluxDB 支持抓取 MinIO 指标数据，用于监控和告警。

本页介绍以下内容：

配置 InfluxDB 服务，抓取并展示 MinIO 部署的指标
基于 MinIO 指标配置告警

前提条件

使用 MinIO 的解耦 HDP Spark 和 Hive

Mon, 01 Jan 0001 00:00:00 +0000

1. 云原生架构

Kubernetes 在计算节点上以弹性方式管理无状态的 Spark 和 Hive 容器。Spark 与 Kubernetes 具有原生调度器集成。出于历史原因，Hive 在 Kubernetes 之上使用 YARN 调度器。

为 MinIO 启用多域 TLS

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持使用 Transport Layer Security (TLS) 1.2+ 对入站和出站流量进行加密。

MinIO Operator 支持通过以下方式为 MinIO 租户启用 TLS：

在 Ubuntu Linux 上部署 MinIO

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍如何在 Ubuntu Linux 操作系统上部署 MinIO。

MinIO 正式支持处于 Ubuntu 生命周期 Standard 或 Ubuntu Pro 支持阶段的 Ubuntu Long Term Support (LTS) 版本。为获得最佳性能，MinIO 强烈建议仅使用包含 Linux 5.X 及以上内核的版本。在撰写本文时，包括：

站点复制概览

Mon, 01 Jan 0001 00:00:00 +0000

站点复制将多个相互独立的 MinIO 部署配置为一个由副本组成的集群，这些副本称为对等站点。

一个包含两个对等站点的站点复制部署。负载均衡器负责将操作路由到两个站点中的任意一个。写入一个站点的数据会自动复制到另一个对等站点。

站点复制要求使用内置的 MinIO Identity Provider (IDP) 或外部 IDP。所有已配置的部署都必须使用同一个 IDP。使用外部 IDP 的部署必须在各站点之间使用相同的配置。

租户的 cert-manager

Mon, 01 Jan 0001 00:00:00 +0000

以下过程用于创建并应用在租户内使用 cert-manager 管理 TLS 证书所需的资源。

说明

本过程使用 tenant-1 作为租户名称。

请在整个过程中将 tenant-1 替换为你的租户名称。

前提条件

已安装 kustomize
可通过 kubectl 访问你的 k8s 集群
已完成 cert-manager 的设置
已安装 MinIO Operator，并已完成 cert-manager 设置

1) 创建租户命名空间的 CA Issuer

在部署新租户之前，先为该租户的命名空间创建 Certificate Authority 和 Issuer。

组管理

Mon, 01 Jan 0001 00:00:00 +0000

概述

组是用户的集合。每个组都可以分配一个或多个策略，这些策略会显式列出允许或拒绝组成员访问的操作和资源。

例如，考虑以下几个组。每个组都分配了一个内置策略或受支持的策略操作。每个组还分配了一个或多个用户。每个用户的完整权限集合由其显式分配的权限以及从其所属各组继承的权限共同组成。对于用户被分配或继承的策略中未显式允许的任何资源或操作，MinIO 默认都会拒绝访问。

CVE-2026-33419：LDAP STS 用户枚举与限流链

Wed, 15 Apr 2026 00:00:00 +0000

状态： 已发布，经历两轮后续修正
首个包含版本： RELEASE.2026-04-17T00-00-00Z
完整修正版本： RELEASE.2026-06-18T00-00-00Z
GitHub Issue： pgsty/minio#23

核心漏洞很直接：LDAP STS 对“用户不存在”和“密码错误”返回不同结果，形成 username oracle。第一版修复统一外部错误，并增加 source IP 与 username 双重限流；连续复核却发现，成功退款、可伪造来源 header、reservation accounting 和共享 username bucket 都可能让安全控制本身成为新的攻击面。

SILO 20260325 发布

Wed, 25 Mar 2026 00:00:00 +0000

发布日期： 2026-03-25 · 版本： RELEASE.2026-03-25T00-00-00Z

这是一个以打包、稳定性与安全公告为主的维护版本，重点是完善交付镜像、修复 LDAP TLS 回归，并把已经锁定到安全版本的依赖明确纳入发布说明。

MinIO已死，谁能接盘？

Mon, 08 Dec 2025 00:00:00 +0000

MinIO进入维护模式，有什么替代品？Ceph、RustFS、SeaweedFS、Garage各有各的问题。老冯把这些方案都打好了包挨个试了一遍，总结一句话：没有完美替代。

Active Directory / LDAP 访问管理

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持配置单个 Active Directory 或 LDAP (AD/LDAP) 服务，用于对用户身份进行外部管理。启用 AD/LDAP 外部身份管理会禁用 MinIO 内部 IDP。

对于由外部 AD/LDAP 提供方管理的身份，MinIO 会使用用户的 Distinguished Name，并尝试将其映射到现有的策略。

AssumeRoleWithWebIdentity

Mon, 01 Jan 0001 00:00:00 +0000

MinIO Security Token Service (STS) AssumeRoleWithWebIdentity API 端点使用由已配置的 OpenID Identity Provider (IDP) 返回的 JSON Web Token (JWT) 生成临时访问凭证。本文档说明 MinIO 服务器的 AssumeRoleWithWebIdentity 端点。关于如何使用 S3 兼容 SDK 实现 STS，请参阅对应 SDK 的文档。

AWS CLI 与 MinIO Server

Mon, 01 Jan 0001 00:00:00 +0000

AWS CLI 是一个用于管理 AWS 服务的统一工具。它也常用于在 AWS S3 中导入和导出数据。它可用于任何兼容 S3 的云存储服务。

在本教程中，我们将学习如何配置并使用 AWS CLI 通过 MinIO Server 管理数据。

Kafka 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面记录了将 Kafka 服务配置为存储桶通知目标的相关设置。有关如何使用这些设置的教程，请参见将事件发布到 Kafka。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

mc admin policy detach

Mon, 01 Jan 0001 00:00:00 +0000

语法

从 MinIO 管理的用户或组中移除一个或多个 IAM 策略。

必须且只能指定 --user 或 --group 其中之一。

以下命令从别名为 myminio 的部署中为用户 james 解绑 readonly 策略。

mc admin user accesskey edit

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey edit 命令用于修改与指定用户关联的访问密钥配置。

该命令要求访问密钥至少有一个属性发生变更。否则，命令会报错退出。

以下命令为 myminio 部署上的 myuserserviceaccount 访问密钥应用新的策略和 secret key：

mc admin user enable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user enable 命令用于在目标 MinIO 部署上启用 MinIO 用户。

客户端只能使用已启用的用户向 MinIO 部署进行认证。使用 mc admin user add 创建的用户默认处于启用状态。

要管理外部身份提供商用户，请参阅 OIDC 或 AD/LDAP。

mc admin user svcacct edit

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端发布版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey edit 命令修改内置 MinIO IDP 用户的访问密钥。

mc alias set

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc alias set 命令用于在本地 mc 配置中添加或更新别名。

以下命令为运行在 URL https://myminio.example.net 的 MinIO 部署 myminio 添加一个 alias。mc 使用指定的用户名和密码对该 MinIO 部署进行身份验证：

mc anonymous list

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc anonymous list 检索存储桶的所有匿名（即未经身份验证或公开）访问策略。

具有匿名策略的存储桶允许客户端在无需身份验证的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch generate

Mon, 01 Jan 0001 00:00:00 +0000

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch generate 命令会为指定作业类型创建一个基础的 YAML 格式模板文件。

MinIO 创建该文件后，请在你偏好的文本编辑器中打开并进一步自定义。每个批处理文件中只能定义一个作业任务定义。

mc encrypt set

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc encrypt set 加密命令用于设置或更新存储桶默认的服务端加密（SSE）模式。MinIO 会使用指定的 SSE 模式自动加密写入该存储桶的对象。

mc encrypt set 仅支持 SSE-KMS 和 SSE-S3。

以下命令为 myminio MinIO 部署上的 mydata 存储桶设置默认的 SSE-KMS 加密密钥：

mc event rm

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc event rm 命令用于从存储桶中移除事件通知触发器。

mc event remove 命令与 mc event rm 功能等效。

以下命令会在 myminio MinIO 部署的 mydata 存储桶上，移除指定 bucket notification target 的已配置事件通知：

mc idp ldap accesskey enable

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap accesskey enable 在本地服务器上启用指定的 access key。

以下示例启用 minio 部署中的 access key mykey：

mc idp ldap enable

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap enable 命令用于启用当前已配置的 AD/LDAP 提供程序。

以下示例在 myminio 部署上启用 AD/LDAP 配置。

mc idp ldap policy entities

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc idp ldap policy entities 命令显示用户、组和/或策略的映射关系列表。

以下示例列出 myminio 部署中某个特定策略、一组用户组以及部分用户的所有映射关系。

mc ilm export

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm export 已被 mc ilm rule export 替代。

语法

mc ilm export 命令用于导出 MinIO 存储桶的对象生命周期管理配置。

mc ilm export 命令默认输出到 STDOUT。你可以将内容输出到 .json 文件中，以便归档或通过 mc ilm import 导入使用。

mc ilm rule export

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm rule export 替代 mc ilm export。

语法

mc ilm rule export 命令用于导出 MinIO 存储桶的对象生命周期管理配置。

mc ilm rule export 命令默认输出到 STDOUT。你可以将内容输出到 .json 文件中进行归档，或使用 mc ilm rule import 导入。

mc ilm tier info

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc ilm tier info 命令可输出某个层级或某个部署上所有层级的统计信息。

所需权限

MinIO 要求具备以下权限，且权限范围限定为你要创建生命周期管理规则的一个或多个存储桶。

mc legalhold set

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc legalhold set 命令可在单个或多个对象上启用 legal hold 的一次写入多次读取（WORM）对象锁定。

mc legalhold 要求指定的存储桶已启用对象锁定。你只能在创建存储桶时启用对象锁定。有关创建已启用对象锁定的存储桶，请参见 mc mb --with-lock 文档。

mc license update

Mon, 01 Jan 0001 00:00:00 +0000

描述

使用 mc license update 命令为部署替换许可证密钥。

对于已在 MinIO SUBNET 注册的部署，MinIO 每月会自动检查并更新许可证。

示例

更新别名为 `minio1` 的部署许可证密钥

mc license update minio1 license.key

语法

该命令具有以下语法：

mc quota set

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2022-12-13T00-23-28Z

mc quota set 替代了 mc admin bucket quota --hard。

变更: RELEASE.2024-07-31T15-58-33Z

mc quota set 已弃用。

说明

mc quota set 为存储桶分配硬配额限制，超过该限制后 MinIO 不再允许写入。

计量单位

mc quota set --size 标志接受以下不区分大小写的后缀，用于表示指定大小值的单位：

mc replicate ls

Mon, 01 Jan 0001 00:00:00 +0000

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

mc replicate ls 替代 mc admin bucket remote ls 命令。

语法

mc replicate ls 命令列出 MinIO 存储桶上的所有复制规则。

mc replicate list 命令与 mc replicate ls 功能等价。

以下命令列出 myminio MinIO 部署中 mydata 存储桶的所有已启用复制规则：

mc retention clear

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc retention clear 命令可移除存储桶中一个或多个对象的 Write-Once Read-Many (WORM) locking 设置。你还可以移除存储桶的默认对象锁定设置。

要更改处于 legal hold 状态的对象的保留状态，请使用 mc legalhold clear。

以下命令会移除 myminio MinIO 部署中 mydata 存储桶的默认对象锁定配置：

mc share ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc share ls 命令会显示由 mc share upload 或 mc share download 生成的所有未过期预签名 URL。

mc share list 命令与 mc share ls 的功能等效。

应用程序可以执行 PUT 以从该 URL 获取对象。

有关可共享对象 URL 的更多信息，请参阅 Amazon S3 文档中的 Pre-Signed URLs.

mc support inspect

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

描述

mc support inspect 命令会收集指定路径下与对象相关的数据和元数据。

mc support top disk

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

语法

mc support top disk 命令显示当前驱动器统计信息。

mc tag remove

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc tag remove 命令用于移除存储桶或对象上的所有标签。

以下命令会移除 myminio MinIO 部署中 mydata 存储桶的标签：

mc version suspend

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc version suspend 命令用于禁用指定存储桶上的版本控制。

以下命令会为 myminio MinIO 部署中的 mybucket 存储桶禁用版本控制：

Metrics version 2

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 使用 Prometheus 数据模型发布集群和节点指标。你可以使用任意抓取工具从 MinIO 拉取指标数据，以执行进一步分析和配置告警。

Version 2 端点

Metrics version 2 将指标划分为以下三个类别：

MinIO 身份管理插件设置

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍如何通过 MinIO Identity Management Plugin 启用外部身份管理的相关设置。有关如何使用这些设置的教程，请参阅 MinIO External Identity Management Plugin。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

Operator Helm 图表

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 发布了用于 Helm Operator Charts 和 Helm Tenant Charts 的 Helm Charts。你可以通过 Helm 使用这些图表来部署 MinIO Operator 及其管理的租户。

本页说明 MinIO Operator 的 values.yaml 图表。有关 MinIO 租户图表的文档，请参见租户 Helm Charts

Root 访问设置

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍用于控制 MinIO 进程 root（超级用户）访问权限的设置。 root 用户具有完整访问权限，可在 MinIO 部署上执行操作。

即使使用 MinIO Key Encryption Service 或其他密钥管理工具，也必须配置 Root User 和 Root Password。

安全与访问

Mon, 01 Jan 0001 00:00:00 +0000

你可以使用 MinIO Console 执行 MinIO 提供的多种身份与访问管理功能，例如：

创建继承父级权限的子访问密钥。
查看、管理和创建访问策略。
使用内置的 MinIO IDP 创建和管理用户凭证或组，连接一个或多个 OIDC provider，或添加 AD/LDAP provider 以实现 SSO。

对象删除

Mon, 01 Jan 0001 00:00:00 +0000

概述

本页概述 DELETE 操作会如何影响对象，具体取决于包含该对象的存储桶配置。

以下因素的任意组合都可能影响 DELETE 操作的行为：

权限

MinIO 使用基于策略的访问控制系统进行访问管理。用户或服务账户必须提供正确的策略操作和条件，才能对该存储桶和对象执行 DELETE。

健康检查 API

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 提供无需身份验证的端点，用于探测节点在线状态以及集群高可用性，从而执行简单健康检查。这些端点返回一个 HTTP 状态码，用于表示底层资源是否健康，或是否满足读写仲裁。 MinIO 不会通过这些端点暴露任何其他数据。

将对象从 MinIO 迁移到 GCS

Mon, 01 Jan 0001 00:00:00 +0000

本页中的过程会创建一条新的对象生命周期管理规则，将对象从 MinIO 存储桶迁移到 Google Cloud Storage 后端上的远程存储层。该过程适用于这类场景：在达到特定时间周期或日历日期后，将陈旧数据迁移到低成本的公有云存储方案。

将事件发布到 NATS

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将存储桶通知事件发布到 NATS 服务端点。

NATS Streaming 已弃用

NATS Streaming 已弃用。请改为迁移到 JetStream。

相关的 MinIO 配置选项和环境变量也已弃用。

向 MinIO 部署添加 NATS 端点

以下过程会在 MinIO 部署中添加一个新的 NATS 服务端点，以支持存储桶通知。

纠删码

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 纠删码概览

MinIO 将纠删码作为提供数据冗余和可用性的核心组件。本页介绍 MinIO 的纠删码机制。

有关 MinIO 如何在生产部署中使用纠删码的更多信息，请参阅可用性与韧性和部署架构。

纠删码基础

说明

扩展分布式 MinIO 部署

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持通过添加新的服务器池来扩展现有的分布式部署。每个 Pool 都会扩展集群的总可用存储容量。

扩容并不能提供 Business Continuity/Disaster Recovery (BC/DR) 级别的保护。虽然每个 pool 都是一组相互独立的服务器，并通过各自的纠删码集合提供可用性，但只要其中一个 pool 完全丢失，MinIO 就会停止该部署中所有 pool 的 I/O。同样地，只要某个 pool 中的某个纠删码集合失去 quorum，该集合中存储的对象就会发生数据丢失，而不受其他纠删码集合或 pool 数量的影响。

配置 MinIO 使用 OpenID 进行认证

Mon, 01 Jan 0001 00:00:00 +0000

概览

MinIO 支持使用兼容 OpenID Connect (OIDC) 的 Identity Provider (IDP) 来管理外部用户身份，例如 Okta、KeyCloak、Dex、Google 或 Facebook。

本页提供了在 Kubernetes 和裸金属基础设施上的 MinIO 部署中配置 OIDC 的流程。

批量过期

Mon, 01 Jan 0001 00:00:00 +0000

新增: MinIO

RELEASE.2023-12-02T10-51-33Z

MinIO 批处理框架允许你使用 YAML 格式的作业定义文件（“batch file”）创建、管理、监控和执行作业。批处理作业直接在 MinIO 部署上运行，从而利用服务端处理能力，而不受运行 MinIO Client 的本地机器限制。

启用双向服务端存储桶复制

Mon, 01 Jan 0001 00:00:00 +0000

本页中的过程会创建新的存储桶复制规则，用于在 MinIO 存储桶之间对对象执行双向“主动-主动”同步。

如需在任意兼容 S3 的服务之间配置复制，请使用 mc mirror。
如需在 MinIO 集群之间配置单向“主动-被动”复制，请参见启用服务端单向存储桶复制。
如需在 MinIO 集群之间配置多站点“主动-主动”复制，请参见启用多站点服务端存储桶复制。

本教程介绍如何在两个 MinIO 集群之间配置主动-主动复制。有关在三个或更多 MinIO 集群之间进行多站点复制的教程，请参见启用多站点服务端存储桶复制。

软件检查清单

Mon, 01 Jan 0001 00:00:00 +0000

在为生产级分布式 MinIO 部署规划软件配置时，请使用以下检查清单。

MinIO 前置条件

运行 Linux 操作系统且内核版本为 6.6+ 的服务器。Red Hat Enterprise Linux (RHEL) 10 或 Ubuntu LTS 22.04.01+ 默认提供这类内核。确保所选操作系统使用 LTS 且仍受支持的 6.6+ Linux 内核版本。

使用客户端管理密钥的服务端加密（SSE-C）

Mon, 01 Jan 0001 00:00:00 +0000

MinIO Server-Side Encryption (SSE) 在写入操作过程中保护对象，使客户端能够利用服务端处理能力在存储层实现对象保护（静态加密，encryption-at-rest）。SSE 还提供满足安全锁定与擦除相关监管和合规要求所需的关键能力。

署名归属

Mon, 01 Jan 0001 00:00:00 +0000

版权

两层版权同时存在。经过翻译或修改的页面，底层表达的版权属于 MinIO，翻译与修改部分的版权属于 Silo 项目，二者互不取代。

修改 MinIO Tenant

Mon, 01 Jan 0001 00:00:00 +0000

部署完成后，你可以修改租户以调整可变配置项。有关 MinIO Custom Resource Definition 中可用设置的完整说明，请参阅 MinIO 自定义资源定义。

修改租户的方法取决于你最初如何部署该租户：

以容器方式部署 MinIO

Mon, 01 Jan 0001 00:00:00 +0000

本页说明如何在任何支持容器化进程的操作系统上以容器方式部署 MinIO。

本文档假定已安装 Docker、Podman 或其他支持标准容器镜像格式的类似 runtime。 MinIO 镜像使用 Red Hat Universal Base Image 9 Micro。

站点故障恢复

Mon, 01 Jan 0001 00:00:00 +0000

尽管整个站点丢失属于重大事故，MinIO 仍可将其影响控制在相对较小且可恢复的范围内。站点恢复方式取决于该站点使用的复制方案。

Site Replication

从健康对等站点完整恢复 IAM 配置、存储桶配置和数据

CVE-2026-34204：复制元数据注入

Wed, 15 Apr 2026 00:00:00 +0000

状态： 已发布
首个包含版本： RELEASE.2026-04-17T00-00-00Z
GitHub Issue： pgsty/minio#24

普通 PUT 与 COPY 请求可以把 X-Minio-Replication-* header 伪装进内部 X-Minio-Internal-* SSE metadata，写出 replication state 与真实授权路径不一致、甚至无法读取的对象。最终修复不再默认接受 replication-only metadata，只在通过 ReplicateObjectAction 的可信复制流程中恢复，并在 CopyObject 的所有 header 消费者之前统一清洗。

SILO 20260321 发布

Sat, 21 Mar 2026 00:00:00 +0000

发布日期： 2026-03-21 · 版本： RELEASE.2026-03-21T00-00-00Z

这是一次围绕 Go 1.26.1 与依赖收敛展开的维护版。除了适配更严格的编译与 lint 检查外，这个版本也完成了本轮最关键的一次安全依赖刷新。

主要变更

将构建环境从 Go 1.26.0 升级到 Go 1.26.1。
全面刷新直接与间接依赖，收敛新工具链下的兼容性问题。
修正 Go 1.26.1 更严格检查暴露出来的一批 lint 与测试问题。

修复的 CVE

CVE-2026-27137：Go stdlib 从 1.26.0 升级到 1.26.1，修复 crypto/x509 对邮箱约束校验不完整的问题。
CVE-2026-27138：Go stdlib 从 1.26.0 升级到 1.26.1，修复畸形证书触发 crypto/x509 panic 的问题。
CVE-2026-25679：Go stdlib 从 1.26.0 升级到 1.26.1，修复 net/url 对 IPv6 host literal 解析不严格的问题。
CVE-2026-27139：Go stdlib 从 1.26.0 升级到 1.26.1，修复 os 中 FileInfo 可逃逸 Root 边界的问题。
CVE-2026-27142：Go stdlib 从 1.26.0 升级到 1.26.1，修复 html/template 在 meta refresh 场景下 URL 未正确转义的 XSS 风险。
CVE-2026-26958：filippo.io/edwards25519 从 v1.1.0 升级到 v1.2.0，修复 MultiScalarMult 可能产生错误结果或未定义行为的问题。
CVE-2025-10543：github.com/eclipse/paho.mqtt.golang 从 v1.5.0 升级到 v1.5.1，修复超长 UTF-8 字符串编码错误导致的 MQTT 报文异常。
CVE-2026-24051：go.opentelemetry.io/otel/sdk 从 v1.38.0 升级到 v1.42.0，修复 macOS 上通过 PATH hijacking 触发任意代码执行的风险。
CVE-2026-33186：google.golang.org/grpc 从 v1.77.0 升级到 v1.79.3，修复 HTTP/2 :path 缺少前导斜杠时的授权绕过问题。

5abd9a8：bump golang to 1.26.1 and update deps
377fc61：fix: satisfy stricter Go 1.26.1 linter checks

MinIO已死

Thu, 04 Dec 2025 00:00:00 +0000

MinIO官方宣布开源项目进入"维护模式"，基本上宣告了MinIO作为一个开源项目的死亡。屠龙勇者成为新的恶龙——MinIO是如何从S3开源替代变成一家普通的商业软件公司的。

mc admin accesskey enable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey enable 命令用于启用现有访问密钥。

以下命令启用指定的访问密钥：

mc admin config

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin config 命令用于管理 minio 服务器的配置设置。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

示例

语法

`mc admin config set`

mc-cmd

mc admin policy entities

Mon, 01 Jan 0001 00:00:00 +0000

语法

列出目标 MinIO 部署中与策略、用户或组关联的实体。

变更: RELEASE.2023-05-27T05-56-19Z

此命令仅返回 MinIO 管理的用户和组。

如需列出与 Active Directory 或 LDAP（AD/LDAP）配置关联的实体，请使用 mc idp ldap policy entities。

mc admin user info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user info 命令返回目标 MinIO 部署中某个 MinIO 用户的详细信息。

如需管理外部身份提供商用户，请参见 OIDC 或 AD/LDAP。

以下命令返回 myminio MinIO 部署中用户 myuser 的详细信息：

mc admin user svcacct enable

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端发布版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，使用 mc admin accesskey enable 命令为内置 MinIO IDP 用户启用访问密钥。

mc alias import

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc alias import 命令从 JSON 文档中导入别名配置。

你可以使用 mc alias export 生成导入所需的 JSON。

以下命令从 JSON 文档中导入别名配置：

mc anonymous links

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc anonymous links 获取用于匿名（即未认证或公开）访问存储桶的 HTTP URL。

配置了匿名策略的存储桶允许客户端在无需认证的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch list

Mon, 01 Jan 0001 00:00:00 +0000

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch list 命令会输出部署中当前正在进行的批处理作业列表。

以下命令会输出 myminio alias 上当前正在进行的所有作业列表。

mc idp ldap accesskey info

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap accesskey info 输出指定访问密钥（一个或多个）的信息。

此命令适用于 AD/LDAP 用户在通过 MinIO 完成身份验证后创建的访问密钥。

使用 mc idp ldap accesskey create 命令创建 AD/LDAP 服务账户。

MinIO 支持使用 AssumeRoleWithLDAPIdentity 通过 Security Token Service 生成临时访问密钥。

mc idp ldap info

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap info 命令输出指定 MinIO 部署上 AD/LDAP 提供程序的当前配置。

以下示例输出 myminio 部署上的 AD/LDAP 配置设置。

mc ilm import

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm import 已被 mc ilm rule import 替代。

语法

mc ilm import 命令会导入对象生命周期管理配置，并将其应用到 MinIO 存储桶。

mc ilm import 命令默认从 STDIN 导入。你可以从 .json 文件输入内容，例如由 mc ilm export 生成的文件。

mc ilm rule import

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm rule import 替代 mc ilm import。

语法

mc ilm rule import 命令导入对象生命周期管理配置，并将其应用到 MinIO 存储桶。

mc ilm rule import 命令默认从 STDIN 导入。你可以从 .json 文件输入内容，例如由 mc ilm rule export 生成的文件。

mc ilm tier ls

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm tier ls replaces mc admin tier ls.

描述

mc ilm tier ls 命令显示某个部署上已配置的远程层级。

mc ilm tier list 命令与 mc ilm tier ls 功能等效。

语法

该命令的语法如下：

以下示例输出 myminio 部署上现有远程层级的列表。

mc replicate update

Mon, 01 Jan 0001 00:00:00 +0000

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

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

变更: RELEASE.2022-11-07T23-47-39Z

mc replicate update 替代了 mc replicate edit 命令。

语法

mc replicate update 命令用于修改现有的存储桶复制规则。

mc [GLOBALFLAGS] replicate update FLAGS [FLAGS] ARGUMENTS [ARGUMENTS]

以下命令会修改 myminio MinIO 部署中 mydata 存储桶的一条现有复制规则：

mc support perf

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2022-07-24T02-25-13Z

mc support perf 替代 mc admin speedtest 命令。

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

mc support top net

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

语法

mc support top net 命令用于显示实时网络指标。

MinIO External Identity Management Plugin

Mon, 01 Jan 0001 00:00:00 +0000

概述

MinIO Identity Management Plugin 提供了一个 REST 接口，用于通过 Webhook 服务将认证委托给外部身份管理器。

启用后，客户端应用程序使用 AssumeRoleWithCustomToken STS API 扩展为 MinIO 生成访问令牌。 MinIO 通过向已配置的插件端点发起 POST 请求来验证该令牌，并根据返回的响应判断客户端的认证状态。

MinIO Operator 的 Security Token Service (STS)

Mon, 01 Jan 0001 00:00:00 +0000

概述

新增: Operator

v5.0.0

MinIO Operator 支持一组 API 调用，使应用程序能够为 MinIO Tenant 获取 STS 凭证。

MinIO Operator 的 STS 具有以下优势：

STS 凭证允许应用程序访问 MinIO Tenant 上的对象，而无需在租户上为该应用创建凭证。

MinIO 访问管理插件设置

Mon, 01 Jan 0001 00:00:00 +0000

本页说明如何配置 MinIO Access Management Plugin 以启用外部授权管理。有关这些设置的使用教程，请参见 MinIO 外部访问管理插件。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

MQTT 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面记录了将 MQTT 服务配置为存储桶通知目标的相关设置。有关如何使用这些设置的教程，请参阅将事件发布到 MQTT。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

SUBNET

Mon, 01 Jan 0001 00:00:00 +0000

您可以使用 MinIO Console 执行 MinIO 中若干与许可证和订阅相关的功能，例如：

查看 MinIO 部署当前使用的许可证。
订阅商业许可证，其中包含对 MinIO SUBNET 的访问权限。
管理部署的 Enterprise 许可证。
使用可与 MinIO Engineering 共享的支持工具。
查看不同许可证选项之间的差异。

许可证

MinIO 提供三种许可证选项：

安全政策

Mon, 01 Jan 0001 00:00:00 +0000

安全维护正是这个分支存在的理由。上游 minio/minio 已经归档，Silo 持续跟踪针对该代码库的 CVE，回合并或自行编写修复，并把调查过程公之于众。

报告安全漏洞

未公开披露的高危漏洞请通过私密渠道报告，不要发在公开 issue 里。

对象自愈

Mon, 01 Jan 0001 00:00:00 +0000

什么是自愈？

自愈是 MinIO 恢复受损、损坏或部分丢失对象的能力。这类丢失或损坏可能来自多种情况，包括但不限于：

驱动器级错误或故障
操作系统或文件系统错误或故障
bit rot

自愈与纠删码

MinIO 恢复受损对象的能力，直接取决于以下因素：

将对象从 MinIO 迁移到 Azure

Mon, 01 Jan 0001 00:00:00 +0000

本页中的过程将创建一条新的对象生命周期管理规则，用于将 MinIO 存储桶中的对象迁移到 Azure 存储后端上的远程存储层。该过程适用于如下场景：在达到特定时间周期或日历日期后，将陈旧数据移动到低成本的公有云存储方案中。

将事件发布到 NSQ

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将存储桶通知事件发布到 NSQ 服务端点。

为 MinIO 部署添加 NSQ 端点

以下过程会在 MinIO 部署中新增一个 NSQ 服务端点，用于支持存储桶通知。

前提条件

MinIO `mc` 命令行工具

此过程中的部分操作需要使用 mc 命令行工具。安装说明请参见 mc 快速入门。

纠删码设置

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍用于配置写入 MinIO 集群对象时所使用纠删码校验的相关设置。这会影响 MinIO 如何使用驱动器空间，以及 MinIO 如何在驱动器丢失或类似问题发生时恢复已存储对象。

你可以通过以下方式建立或修改设置：

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

Mon, 01 Jan 0001 00:00:00 +0000

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

升级 MinIO Tenant

Mon, 01 Jan 0001 00:00:00 +0000

以下步骤用于升级单个 MinIO Tenant，可选择使用 Kustomize 或 Helm。 MinIO 建议你在升级生产 Tenant 之前，先在 Dev 或 QA 等较低环境中测试升级流程。

重要

对于使用早于 RELEASE.2024-03-30T09-41-56Z 的 MinIO Image 且启用了 AD/LDAP 的 Tenant，在开始本步骤前，你必须先完整阅读 RELEASE.2024-04-18T19-09-19Z 的发布说明。你必须将该发布说明中记录的额外步骤纳入升级过程。

使用 Grafana 监控 MinIO Server

Mon, 01 Jan 0001 00:00:00 +0000

无论指标存储在何处，Grafana 都允许你对其进行查询、可视化、告警和分析。

前提条件

已有 Prometheus 部署，并配置 Alert Manager
已有可通过网络访问 Prometheus 部署的 MinIO 部署
已安装 Grafana

Grafana 仪表板使用 metrics version 2

MinIO 的 Grafana 仪表板使用 metrics version 2。关于指标 API 版本的更多信息，请参见指标与告警。

退役服务器池

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持从包含两个或更多 pool 的部署中退役并移除服务器池s。执行退役前，至少必须保留一个具有足够可用空间的 pool，以接收被退役 pool 中的对象。

从 RELEASE.2023-01-18T04-36-38Z 起，MinIO 支持在一条退役命令中排队多个 pool。每个被列出的 pool 会立即进入只读状态，但实际排空过程一次只处理一个 pool。

为 MinIO Server 配置 NGINX 代理

Mon, 01 Jan 0001 00:00:00 +0000

以下文档提供了在 Linux 环境中配置 NGINX 将请求代理到 MinIO 的基线方案。这并非一份关于 NGINX、代理或反向代理的一般性完整指南。请根据你的基础设施需要调整配置。

在 MacOS 上部署 MinIO

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍如何在 Apple MacOS 主机上部署 MinIO。

MinIO 正式支持仍处于服务期内的 MacOS 操作系统，该期限通常为自首次发布起 3 年。在撰写本文时，包括：

macOS 14 (Sonoma)（推荐）
macOS 13 (Ventura)
macOS 12 (Monterey)

MinIO 可能也能在更旧或已停止支持的 macOS 版本上运行，但 MinIO 或 RedHat 仅能提供有限的支持或故障排查。

租户 Helm Charts

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 为 Helm Operator Charts 和 Helm Tenant Charts 发布了 Helm Charts。你可以使用这些 Chart 通过 Helm 部署 MinIO Operator 和受管租户。

以下页面说明 MinIO 租户的 values.yaml Chart。有关 MinIO Operator Chart 的文档，请参阅 Operator Helm 图表

CVE-2026-39414：S3 Select 超大记录与 SIMD 绕过

Wed, 15 Apr 2026 00:00:00 +0000

状态： 已发布，六月完成二次闭环
初始修复版本： RELEASE.2026-04-17T00-00-00Z
完整修复版本： RELEASE.2026-06-18T00-00-00Z
GitHub Issue： pgsty/minio#25

四月的第一轮修复使用既有的 1 MiB maxCharsPerRecord 同时限制 CSV 与普通 JSON Lines，避免在遇到分隔符前持续无界 buffering，并让客户端得到明确的 OverMaxRecordSize。六月复核却发现，支持 SIMD 的 CPU 会走另一条 simdjson fast path，完全绕过这个限制。

SILO 20260314 发布

Sat, 14 Mar 2026 00:00:00 +0000

发布日期： 2026-03-14 · 版本： RELEASE.2026-03-14T12-00-00Z

这个版本完成了向社区维护 Console 分支的切换，并在切换过程中做了一轮较大幅度的依赖更新，为后续 Go 1.26.x 维护版打下基础。

主要变更

切换到社区维护的 georgmangold/console v1.9.1，替换不可持续维护的上游 Console 依赖。
大幅更新 go.mod 中的直接与间接依赖，使 Console 与新工具链组合能够稳定构建。
修复 grid_test.go 的 go vet 格式化指令问题，并调整部分测试以适配 Go 1.26 的 HTTP 行为变化。

修复的 CVE

CVE-2025-47913：golang.org/x/crypto 从 v0.37.0 升级到 v0.46.0，修复 ssh/agent 在处理异常响应时可能导致客户端 panic 的问题。
CVE-2025-58181：golang.org/x/crypto 从 v0.37.0 升级到 v0.46.0，修复 ssh GSSAPI 认证请求可触发无界内存消耗的问题。
CVE-2025-47914：golang.org/x/crypto 从 v0.37.0 升级到 v0.46.0，修复 ssh/agent 对畸形身份消息缺乏边界校验导致的 panic 问题。
CVE-2025-47911：golang.org/x/net 从 v0.39.0 升级到 v0.48.0，修复 html.Parse 在特制输入下的二次复杂度解析问题。
CVE-2025-58190：golang.org/x/net 从 v0.39.0 升级到 v0.48.0，修复 golang.org/x/net/html 可能陷入无限解析循环的问题。

68521b3：add github ci/cd pipeline
00f3cf7：RELEASE.2026-03-14T12-00-00Z with go 1.26.0

mc admin accesskey info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey info 命令返回指定 access key(s) 的描述信息。

描述输出会在可用时包含以下详细信息：

Access Key
指定访问密钥的父用户
访问密钥状态（on 或 off）
策略（单个或多个）
注释
过期时间

以下命令返回指定访问密钥的信息：

mc admin decommission

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin decommission 命令用于启动 MinIO 服务器池s 的下线流程。下线流程适用于移除较旧的服务器池，这些服务器池的硬件能力或性能已不再满足要求，或相较部署中的其他池表现不足。MinIO 会根据每个池可用空闲空间的比例，自动将数据从被下线的池迁移到部署中其余的池。

mc admin policy info

Mon, 01 Jan 0001 00:00:00 +0000

语法

如果目标 MinIO 部署上存在指定策略，则以 JSON 格式返回该策略。

以下命令显示 alias myminio 上 writeonly 策略的内容。

mc admin user ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user ls 命令会列出目标 MinIO 部署上的所有 MinIO 用户。

mc admin user list 命令与 mc admin user ls 功能等效。

mc admin user ls 不会返回与用户关联的 access key 或 secret key。使用 mc admin user info 可获取用户详细信息，包括用户的 access key。

mc admin user svcacct info

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 开始，请使用 mc admin accesskey info 命令显示内置 MinIO IDP 用户的 access key 信息。

mc alias export

Mon, 01 Jan 0001 00:00:00 +0000

新增: mc.RELEASE.2023-11-15T22-45-58Z

语法

mc alias export 命令从现有的 configuration 中导出别名配置。

该命令将结果输出到 STDOUT，你可以将输出保存为文件，或按需进一步修改输出内容。

使用 mc alias import 命令导入生成的 JSON 配置。

mc anonymous get-json

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc anonymous get-json 命令用于获取存储桶的匿名（即未经身份验证或公开）访问 policies。

配置了匿名策略的存储桶允许客户端在无需 authentication 的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch start

Mon, 01 Jan 0001 00:00:00 +0000

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch start 命令根据批处理作业 YAML 文件启动一个批处理作业。

批处理作业会运行一次直到完成（或达到文件中指定的最大重试次数）。若要在完成后再次运行该批处理作业，必须重新启动它。

mc cat

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc cat 命令将文件或对象的内容连接到另一个文件或对象。你也可以使用该命令将指定文件或对象的内容输出到 STDOUT。 cat 的功能与 cat 类似。

以下命令将 MinIO 部署中某个对象的内容输出到 STDOUT：

mc idp ldap accesskey ls

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap accesskey ls 用于显示 LDAP 访问密钥对列表。

mc idp ldap accesskey ls 也称为 mc idp ldap accesskey list。

此命令适用于 AD/LDAP 用户在通过 MinIO 完成身份验证后创建的访问密钥。

使用 mc idp ldap accesskey create 命令创建 AD/LDAP 服务账户。

mc idp ldap ls

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc idp ldap ls 命令列出 AD/LDAP 提供方当前已有的配置集合。

mc idp ldap ls 也称为 mc idp ldap list。

以下示例列出 myminio 部署的 AD/LDAP 配置设置。

mc ilm ls

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm ls 已由 mc ilm rule ls 替代。

语法

mc ilm ls 命令以表格形式汇总 MinIO 存储桶上已配置的所有对象生命周期管理规则。

该命令的输出可能如下所示：

┌───────────────────────────────────────────────────────────────────────────────┐
│ Transition for latest version (Transition) │
├────────┬─────────┬────────┬─────────────────────┬──────────────┬──────────────┤
│ ID │ STATUS │ PREFIX │ TAGS │ DAYS TO TIER │ TIER │
├────────┼─────────┼────────┼─────────────────────┼──────────────┼──────────────┤
│ rule-1 │ Enabled │ doc/ │ key1=val1&key2=val2 │ 0 │ WARM-MINIO-1 │
└────────┴─────────┴────────┴─────────────────────┴──────────────┴──────────────┘
┌────────────────────────────────────────────────────────────────┐
│ Transition for older versions (NoncurrentVersionTransition) │
├────────┬─────────┬────────┬──────┬──────────────┬──────────────┤
│ ID │ STATUS │ PREFIX │ TAGS │ DAYS TO TIER │ TIER │
├────────┼─────────┼────────┼──────┼──────────────┼──────────────┤
│ rule-2 │ Enabled │ logs/ │ - │ 10 │ WARM-MINIO-1 │
└────────┴─────────┴────────┴──────┴──────────────┴──────────────┘
┌────────────────────────────────────────────────────────────────────────────────────────┐
│ Expiration for latest version (Expiration) │
├────────┬─────────┬────────┬─────────────────────┬────────────────┬─────────────────────┤
│ ID │ STATUS │ PREFIX │ TAGS │ DAYS TO EXPIRE │ EXPIRE DELETEMARKER │
├────────┼─────────┼────────┼─────────────────────┼────────────────┼─────────────────────┤
│ rule-1 │ Enabled │ doc/ │ key1=val1&key2=val2 │ 30 │ false │
└────────┴─────────┴────────┴─────────────────────┴────────────────┴─────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────┐
│ Expiration for older versions (NoncurrentVersionExpiration) │
├────────┬─────────┬────────┬─────────────────────┬────────────────┬───────────────┤
│ ID │ STATUS │ PREFIX │ TAGS │ DAYS TO EXPIRE │ KEEP VERSIONS │
├────────┼─────────┼────────┼─────────────────────┼────────────────┼───────────────┤
│ rule-1 │ Enabled │ doc/ │ key1=val1&key2=val2 │ 15 │ 0 │
│ rule-2 │ Enabled │ logs/ │ - │ 1 │ 3 │
└────────┴─────────┴────────┴─────────────────────┴────────────────┴───────────────┘

以下命令列出 myminio MinIO 部署中 mydata 存储桶的所有生命周期管理规则：

mc ilm rule ls

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm rule ls 替代了 mc ilm ls。

变更: RELEASE.2023-05-26T23-31-54Z

mc ilm rule ls --json 的输出在 updateAt 中包含策略修改时间。

语法

mc ilm rule ls 命令以表格格式汇总 MinIO 存储桶上配置的所有对象生命周期管理规则。

mc ilm tier rm

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc ilm tier rm 命令用于移除尚未用于转换任何对象的远程层。

mc ilm tier remove 命令与 mc ilm tier rm 具有等效功能。

说明

一旦某个层已经转换过对象，则无法将其移除。

所需权限

MinIO 要求具备以下权限，且权限范围限定为你要创建生命周期管理规则的一个或多个存储桶。

mc replicate resync

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc replicate resync 命令会将指定 MinIO 存储桶中的所有对象，重新同步到远端 replication 目标。

此命令要求先使用 mc replicate add 命令配置远端存储桶目标。执行 mc replicate resync 时，必须指定由此生成的远端 ARN。

mc support profile

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

描述

mc support profile 为你的部署运行系统性能剖析。剖析结果可帮助了解给定节点上运行的 MinIO 服务端进程状态。

mc support top rpc

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

语法

mc support top rpc 命令显示远程过程调用（RPC）的指标。

MinIO Console 设置

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2025-05-24T17-08-30Z

Console 现在仅提供对象浏览能力，类似于通过 mc 工具可用的能力。对于用户管理等管理类交互，请使用 mc admin 命令。

本页中的部分设置可能已不再适用于较新的部署。

MySQL 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本页记录了将 MySQL 服务配置为存储桶通知目标的相关设置。有关如何使用这些设置的教程，请参阅将事件发布到 MySQL。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

从 Gateway 或 Filesystem 模式迁移

Mon, 01 Jan 0001 00:00:00 +0000

背景

MinIO Gateway 及相关 filesystem 模式自 2020 年 7 月起进入功能冻结状态。 2022 年 2 月，MinIO 宣布弃用 MinIO Gateway。在该弃用公告中，MinIO 同时宣布该功能将在六个月后移除。

从远程副本重新同步存储桶

Mon, 01 Jan 0001 00:00:00 +0000

本页中的步骤使用健康的复制远端来重新同步 MinIO 存储桶中的内容。重新同步可用于在副本配置下的 MinIO 部署发生部分或全部数据丢失后进行恢复。

例如，考虑如下所示的 MinIO 主动-主动复制配置：

对象扫描器

Mon, 01 Jan 0001 00:00:00 +0000

概览

MinIO 使用内置扫描器检查对象是否需要自愈，并执行任何已计划的对象操作。这类操作可能包括：

计算驱动器上的数据使用量
评估并应用已配置的生命周期管理或对象保留规则
执行存储桶或站点复制
检查对象是否存在丢失或损坏的数据分片或校验分片，并执行自愈

扫描器在两个层级执行这些功能：集群层级和存储桶层级。在集群层级，扫描器会将所有存储桶划分为多个组，并一次扫描其中一组。扫描器会先处理自上次扫描以来新增的存储桶，然后再以随机顺序扫描其他存储桶。在完成所有存储桶组的检查后，扫描器会重新开始新一轮扫描。

对象自动过期

Mon, 01 Jan 0001 00:00:00 +0000

本页中的每个过程都会创建一条新的对象生命周期管理规则，用于让 MinIO 存储桶中的对象过期。该过程适用于在特定时间段或日历日期之后删除“旧”对象等场景。

访问管理

Mon, 01 Jan 0001 00:00:00 +0000

概述

MinIO 使用基于策略的访问控制 (PBAC) 来定义已认证用户可访问的授权操作和资源。每个策略描述一条或多条 actions 与 conditions，用于说明某个 user 或 group 中用户的权限。

MinIO PBAC 在设计上兼容 AWS IAM 策略语法、结构和行为。 MinIO 文档会尽力覆盖 IAM 特定行为和功能。若需要更完整的 AWS IAM 特定主题文档，请参考 IAM documentation。

将事件发布到 Elasticsearch

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将 bucket notification 事件发布到 Elasticsearch 服务端点。

MinIO 依赖 https://github.com/elastic/go-elasticsearch v7 项目连接 Elastic。

为 MinIO 部署添加 Elasticsearch 端点

以下步骤为 MinIO 部署添加一个新的 Elasticsearch 服务端点，以支持 bucket notifications。

前提条件

Elasticsearch v7.0 及更高版本

MinIO 依赖 https://github.com/olivere/elastic v7 项目连接 Elastic。elastic/v7 库专门面向 Elasticsearch v7.0，与更早版本的 Elasticsearch 不兼容。

扩展 MinIO Tenant

Mon, 01 Jan 0001 00:00:00 +0000

本步骤说明如何通过在 Kubernetes 基础设施中部署额外的一组 MinIO pod，来扩展现有 MinIO tenant 的可用存储容量。

重要

MinIO Operator Console 已被弃用，并在 Operator 6.0.0 中移除。

有关将通过 Operator Console 安装的 Tenant 迁移到 Kustomization 的说明，请参阅修改 MinIO Tenant。

使用 Pre-signed URL 上传文件

Mon, 01 Jan 0001 00:00:00 +0000

使用 pre-signed URL，客户端可以直接将文件上传到兼容 S3 的云存储服务器（S3），而无需向用户暴露 S3 凭证。

本文介绍如何使用 MinIO JavaScript Library 中的 presignedPutObject API 生成 pre-signed URL。文中通过一个 JavaScript 示例进行演示：由 Express Node.js 服务器暴露一个用于生成 pre-signed URL 的端点，客户端 Web 应用再使用该 URL 将文件上传到 MinIO Server。

数据压缩

Mon, 01 Jan 0001 00:00:00 +0000

概述

MinIO Server 支持对对象进行压缩，以减少磁盘使用量。对象在 PUT 时会先压缩再写入磁盘，在 GET 时会先解压再发送给客户端。这样一来，压缩过程对客户端应用程序和服务是透明的。

在 Windows 上部署 MinIO

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍如何在 Microsoft Windows 主机上部署 MinIO。

MinIO 正式支持处于 Microsoft Modern Lifecycle Policy“Active Support”阶段的 Windows 操作系统。

在撰写本文时，包括：

CVE-2026-40344：Snowball 自动解包认证绕过

Thu, 16 Apr 2026 00:00:00 +0000

状态： 已发布
首个包含版本： RELEASE.2026-04-17T00-00-00Z
GitHub Advisory： GHSA-9c4q-hq6p-c237

Snowball PutObjectExtractHandler 漏掉了 streaming unsigned-trailer auth case。伪造 signature 的 tar stream 可以在认证完成前进入 untar()，而一次请求又能扇出为多个对象写入。最终修复在任何 tar 字节进入解包器之前，初始化正确 reader、处理 decoded length 并完成 SigV4 验证。

SILO 20260214 发布

Sat, 14 Feb 2026 00:00:00 +0000

发布日期： 2026-02-14 · 版本： RELEASE.2026-02-14T12-00-00Z

这是社区分支早期的一个基础设施版本，除了恢复内嵌 Console 与建立 GitHub CI/CD 之外，也把 Go 运行时基线提升到 1.26.0，因此一并消化了上一代工具链中的一批安全问题。

mc admin accesskey ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey ls 命令列出 MinIO 部署管理的用户、访问密钥或临时 security token service 密钥。

mc admin accesskey list 别名与 mc admin accesskey ls 功能等效。

以下命令列出别名为 myminio 的部署中，用户名为 admin1 的用户关联的所有访问密钥：

mc admin group

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin group 命令用于管理 MinIO 部署上的组。

组是用户的集合。每个组都可以分配一个或多个策略，用于明确列出允许或拒绝组成员访问的操作和资源。对于具有相同访问模式和工作负载的用户，组提供了一种简化的共享权限管理方式。

mc admin policy ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

列出目标 MinIO 部署上的所有策略。

mc admin policy list 命令与 mc admin policy ls 具有等效功能。

以下命令显示 alias play 上当前存在的策略列表。

mc admin user rm

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user rm 命令用于在目标 MinIO 部署上移除 MinIO 用户。

mc admin user remove 命令与 mc admin user rm 的功能等效。

要管理外部身份提供商用户，请参阅 OIDC 或 AD/LDAP。

以下命令会在 myminio MinIO 部署上移除用户 myuser：

mc admin user svcacct ls

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey ls 命令列出 MinIO 内置 IDP 用户的访问密钥。

mc anonymous set-json

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc anonymous set-json 命令使用 IAM JSON policy document 为存储桶设置匿名（即未认证或公开）访问 policies。

配置了匿名策略的存储桶允许客户端在无需 authentication 的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch status

Mon, 01 Jan 0001 00:00:00 +0000

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch status 命令会输出 MinIO 服务器上作业事件的汇总信息。

变更: mc

RELEASE.2024-07-03T20-17-25Z

Batch status 会显示活动且正在进行的作业，或前 3（三）天内已完成的任意批处理作业的汇总信息。

mc cp

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc cp 命令用于在 MinIO 部署与本地文件系统之间复制对象，其中源端可以是 MinIO 或本地文件系统。

你也可以将 mc cp 用于本地文件系统，达到与 cp 命令行工具类似的效果。

mc idp ldap accesskey rm

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap accesskey rm 从本地服务器中删除指定的访问密钥。

mc idp ldap accesskey rm 也称为 mc idp ldap accesskey remove。

此命令适用于 AD/LDAP 用户在通过 MinIO 完成身份验证后创建的访问密钥。

使用 mc idp ldap accesskey create 命令创建 AD/LDAP 服务账户。

mc idp ldap rm

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc idp ldap rm 命令移除 AD/LDAP 提供方的现有配置。

mc idp ldap rm 也称为 mc idp ldap remove。

以下示例移除 myminio 部署的 AD/LDAP 提供方设置。

mc ilm rm

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm rm 已被 mc ilm rule rm 取代。

语法

mc ilm rm 命令用于从 MinIO 存储桶中移除一条对象生命周期管理规则。

mc ilm remove 命令与 mc ilm rm 的功能等效。

以下命令从 myminio MinIO 部署的 mydata 存储桶中移除一条生命周期管理规则：

mc ilm rule rm

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm rule rm 替代 mc ilm rm。

语法

mc ilm rule rm 命令用于从 MinIO 存储桶中删除一条对象生命周期管理规则。

以下命令从 myminio MinIO 部署的 mydata 存储桶中删除一条生命周期管理规则：

mc ilm tier update

Mon, 01 Jan 0001 00:00:00 +0000

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

mc ilm tier update 替代 mc admin tier edit。

描述

mc ilm tier update 命令用于修改已配置的远程层。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc replicate rm

Mon, 01 Jan 0001 00:00:00 +0000

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

mc replicate rm 替代 mc admin bucket remote rm 命令。删除复制配置时会自动删除其底层远程目标。

语法

mc replicate rm 命令用于从 MinIO 存储桶中删除 replication rule。

mc replicate remove 命令与 mc replicate rm 功能等价。

mc [GLOBALFLAGS] replicate rm FLAGS [FLAGS] ALIAS

以下命令从 myminio MinIO 部署中的 mydata 存储桶删除指定 id 的复制规则：

mc support proxy

Mon, 01 Jan 0001 00:00:00 +0000

说明

使用 mc support proxy 命令配置与 MinIO SUBNET 通信时使用的代理。

示例

设置代理 URL

定义部署 minio1 与 SUBNET 通信时使用的代理 URL。此示例中的代理 URL 为 http://my.proxy。

mc support proxy set minio1 http://my.proxy

删除为部署配置的代理 URL

以下命令会删除为别名 minio1 配置的代理 URL。

MinIO 外部访问管理插件

Mon, 01 Jan 0001 00:00:00 +0000

概述

MinIO Access Management Plugin 提供了一个 REST 接口，可通过 Webhook 服务将授权流程卸载到外部系统。

启用后，MinIO 会将每次 API 调用的请求及凭证详情发送到已配置的外部 HTTP(S) 端点，并查找 ALLOW 或 DENY 响应。因此，MinIO 可以将访问管理委托给外部系统，而不是依赖 S3 基于策略的访问控制。

NATS 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

NATS Streaming 已弃用

NATS Streaming 已弃用。请迁移到 JetStream。

相关的 MinIO 配置选项和环境变量也已弃用。

本页面说明了将 NATS 服务配置为存储桶通知目标的设置。有关如何使用这些设置的教程，请参见将事件发布到 NATS。

将事件发布到 Kafka

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将 bucket notification 事件发布到 Kafka 服务端点。

MinIO 依赖 https://github.com/Shopify/sarama 项目实现 Kafka 连接能力，并共享该项目对 Kafka 的支持。更多信息请参见 sarama 的 Compatibility and API stability 章节。

向 MinIO 部署添加 Kafka 端点

以下过程会在 MinIO 部署中添加一个新的 Kafka 服务端点，用于支持 bucket notifications。

删除 MinIO Tenant

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

MinIO Kubernetes Operator

本页步骤要求已正确安装 MinIO Kubernetes Operator，并假定本地主机也安装了与之匹配的 MinIO Kubernetes Operator。本步骤默认使用最新稳定版 Operator，即版本 7.1.1。

使用 Certbot 为 MinIO 生成 Let’s Encrypt 证书

Mon, 01 Jan 0001 00:00:00 +0000

Let’s Encrypt 是一个新的免费、自动化且开源的证书颁发机构（Certificate Authority）。

Certbot 是一个基于控制台的 Let’s Encrypt 证书生成工具。

在本教程中，我们将使用 Certbot 生成 Let’s Encypt 证书。随后将把该证书部署到 MinIO Server 中使用。

阈值与限制

Mon, 01 Jan 0001 00:00:00 +0000

本页列出了适用于 MinIO 的阈值与限制。

有关相关建议和要求，请参阅 hardware 和 software。

S3 API 限制

项目

规格

最大对象大小

50 TiB

最小对象大小

0 B

单次 PUT 操作的最大对象大小

非 multipart upload 为 5 TiB
multipart upload 为 50 TiB

每次上传的最大分片数

指标与日志设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面介绍用于控制 MinIO 指标与日志相关行为的设置。更多信息请参见指标与告警。

这些设置用于将常规 minio server 日志和审计日志发布到 HTTP webhook。更完整的文档请参见将服务日志或审计日志发布到外部服务。

你可以通过以下方式建立或修改设置：

CVE-2026-41145：Unsigned-Trailer 查询认证绕过

Thu, 16 Apr 2026 00:00:00 +0000

状态： 已发布
首个包含版本： RELEASE.2026-04-17T00-00-00Z
GitHub Advisory： GHSA-hv4r-mvr4-25vw

query-string SigV4 credential 可以进入 STREAMING-UNSIGNED-PAYLOAD-TRAILER 数据流，但旧代码只在存在 Authorization header 时验证签名。结果是：请求只要提供有效 access key 标识，即使没有正确 signature，也可能完成写入。

SILO 20251203 发布

Mon, 15 Dec 2025 00:00:00 +0000

发布日期： 2025-12-15 · 版本： RELEASE.2025-12-03T12-00-00Z

这是目前可追溯到的首个社区版发布，主要目标是建立社区维护分支的打包与分发基线，而不是在此前社区版本之上做增量修复。

主要变更

基于 minio/pkger 建立社区版打包流程。
选择 MinIO 进入 maintenance mode 后的一版上游基线作为社区分支起点。
首次产出 apk、deb、rpm 等多种平台包，为后续持续发布建立基础。

修复的 CVE

这是首个社区版发布，GitHub Release 未单独声明相对更早社区版本的安全修复清单；本页不追溯其相对上游维护模式基线的全部历史 CVE 差异。

d4cd4b4：RELEASE.2025-12-03T12-00-00Z with go 1.25.5

mc admin accesskey rm

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey rm 命令用于删除部署中与某个用户关联的访问密钥。

mc admin accesskey remove 命令与 mc admin accesskey rm 的功能等效。

警告

删除后，应用程序将无法再使用该访问密钥进行身份验证。

mc admin heal

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin heal 命令会扫描受损或损坏的对象，并对这些对象执行自愈。

mc admin heal 资源开销较大，通常不需要手动执行，即使在驱动器故障或数据损坏事件之后也是如此。

mc admin policy rm

Mon, 01 Jan 0001 00:00:00 +0000

语法

从目标 MinIO 部署中移除 IAM 策略。

mc admin policy remove 命令与 mc admin policy rm 具有等效功能。

以下命令从 myminio MinIO 部署中移除名为 writeonly 的策略：

mc admin user sts info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user sts info 命令用于检索指定 STS 凭证的信息，例如生成该凭证的父 MinIO user、关联策略和过期时间。

STS 凭证为 MinIO 部署提供临时访问权限。

以下命令检索具有指定访问密钥的 STS 凭证信息：

mc admin user svcacct rm

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey rm 命令删除内置 MinIO IDP 用户的访问密钥。

mc diff

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc diff 命令用于计算两个文件系统目录或 MinIO 存储桶之间的差异。 mc diff 仅列出缺失的对象或大小不同的对象。mc diff 不会比较对象内容。

以下命令用于比较本地文件系统中的一个对象与 myminio MinIO 部署中 mydata 存储桶内一个对象之间的差异：

mc idp ldap update

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc idp ldap update 命令用于修改 AD/LDAP 提供程序的现有配置集。

以下示例修改 myminio 部署的两个 AD/LDAP 配置项。

mc replicate status

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc replicate status 命令显示 MinIO 存储桶的复制状态。该状态还会列出远程目标路径或位置。

以下命令显示 myminio MinIO 部署上 mydata 存储桶的当前复制状态：

NSQ 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面记录了将 NSQ 服务配置为存储桶通知目标时所使用的设置。有关如何使用这些设置的教程，请参阅将事件发布到 NSQ。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

Rust 快速入门指南

Mon, 01 Jan 0001 00:00:00 +0000

用于 Amazon S3 兼容云存储的 MinIO Rust SDK

MinIO Rust SDK 是一个 Simple Storage Service（即 S3）客户端，可用于在任意 Amazon S3 兼容对象存储服务上执行存储桶和对象操作。它为 MinIO 和 Amazon S3 兼容对象存储 API 提供了强类型、异步优先的接口。

将事件发布到 MySQL

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将存储桶通知事件发布到 MySQL 服务端点。MinIO 仅支持 MySQL 5.7.8 及更高版本。

向 MinIO 部署添加 MySQL 端点

以下过程会向 MinIO 部署添加一个新的 MySQL 服务端点，以支持存储桶通知。

先决条件

MySQL 5.7.8 及更高版本

MinIO 依赖于 MySQL 5.7.8 中引入的功能。

CVE-2026-42600：ReadMultiple Storage-REST 路径穿越

Fri, 12 Jun 2026 00:00:00 +0000

状态： 已发布
首个包含版本： RELEASE.2026-06-18T00-00-00Z
GitHub Advisory： GHSA-xh8f-g2qw-gcm7
影响范围： 仅 distributed erasure；需要 cluster-root / internode JWT

/rmpl 的 msgpack body 中包含 Bucket、Prefix 与 Files，旧代码直接把它们拼成文件系统路径，没有 containment。最初的修复实现了完整 preflight validation；继续审计调用链后却发现，这条 API 从 2024 年起已经没有 production caller。最终方案因此从“保留并加固”转为删除 route、handler、client、interface 与生成代码。

mc admin info

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin info 命令显示 MinIO 服务器的信息。对于分布式 MinIO 部署，mc admin info 会显示部署中每个 MinIO 服务器的信息。

新增: mc

RELEASE.2024-05-03T11-21-07Z

命令输出包含集群的 erasure code 设置信息。该信息在输出中以 EC:# 格式显示。

mc du

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc du 命令用于汇总存储桶和文件夹的磁盘使用量。你也可以对本地文件系统使用 du，以生成与 du 命令类似的结果。

以下命令打印 myminio MinIO 部署中 mybucket 存储桶的磁盘使用量：

mc replicate export

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc replicate export 命令将 MinIO 存储桶的 JSON 格式复制规则导出到 STDOUT。

以下命令导出 myminio MinIO 部署中 mydata 存储桶的复制配置：

mc support upload

Mon, 01 Jan 0001 00:00:00 +0000

Description

mc support upload 将文件从本地文件系统复制到 SUBNET 工单。

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

PostgreSQL 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本页记录了将 PostgreSQL 服务配置为存储桶通知目标的设置。有关如何使用这些设置的教程，请参阅将事件发布到 PostgreSQL。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

将事件发布到 PostgreSQL

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将存储桶通知事件发布到 PostgreSQL。MinIO 仅支持 PostgreSQL 9.5 及以上版本。

向 MinIO 部署添加 PostgreSQL 端点

以下过程将为 MinIO 部署新增一个 PostgreSQL 服务端点，以支持存储桶通知。

前提条件

PostgreSQL 9.5 及以上版本

MinIO 依赖 PostgreSQL 9.5 引入的特性。

MinIO `mc` 命令行工具

此过程中的某些操作需要使用 mc 命令行工具。安装说明参见 mc 快速入门。

ILM 设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面介绍用于控制 MinIO 进程 ILM（信息生命周期管理）的设置。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

mc admin kms key

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin kms key 命令通过 MinIO Key Encryption Service (KES) 执行加密密钥管理操作。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc replicate import

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc replicate import 命令从 STDIN 为 MinIO 存储桶导入 JSON 格式的 replication rules。

以下命令为 myminio MinIO 部署上的 mydata 存储桶导入复制配置：

Redis 通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本页记录了将 Redis 服务配置为存储桶通知目标所需的设置。有关如何使用这些设置的教程，请参阅将事件发布到 Redis。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

将事件发布到 Redis

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将存储桶通知事件发布到 Redis 服务端点。

向 MinIO 部署添加 Redis 端点

以下过程会在 MinIO 部署中添加一个新的 Redis 服务端点，用于支持存储桶通知。

前提条件

MinIO `mc` 命令行工具

此过程在部分操作中使用 mc 命令行工具。安装说明请参见 mc 快速入门。

mc admin logs

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

变更: RELEASE.2022-12-02T23-48-47Z

Webhook 服务通知设置

Mon, 01 Jan 0001 00:00:00 +0000

本页记录了将 Webhook 服务配置为存储桶通知目标所需的设置。有关如何使用这些设置的教程，请参见将事件发布到 Webhook。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

将事件发布到 Webhook

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 支持将存储桶通知事件发布到 Webhook 服务端点。

向 MinIO 部署添加 Webhook 端点

以下过程会为 MinIO 部署新增一个 Webhook 服务端点，以支持存储桶通知。

前提条件

MinIO `mc` 命令行工具

本过程中的部分操作需要使用 mc 命令行工具。安装说明请参见 mc 快速入门。

密钥加密服务设置

Mon, 01 Jan 0001 00:00:00 +0000

MinIO Server 提供三组环境变量，用于管理 MinIO Server 与 Key Encryption Service (KES)、Key Management Service (KMS) 或静态密钥文件的交互方式。这三组中只能定义一组。如果定义了多种类型的环境变量组，MinIO 会返回错误。

mc admin bucket quota

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2022-12-13T00-23-28Z

mc admin bucket quota 已被以下命令替代：

说明

mc admin bucket quota 命令用于管理按存储桶设置的存储配额。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc find

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc find 命令支持在 MinIO 部署上搜索对象。你也可以使用该命令在文件系统上搜索文件。

以下命令会在 myminio MinIO 部署的 mydata 存储桶中，搜索所有匹配指定模式的对象：

Object Lambda 函数设置

Mon, 01 Jan 0001 00:00:00 +0000

本页面介绍了可用于配置 MinIO 的设置，以便将数据发布到 HTTP webhook 端点并触发 Object Lambda 函数。有关使用这些设置的更完整文档和教程，请参见使用 Object Lambda 进行转换。

你可以通过定义以下项来建立或修改设置：

mc admin bucket remote

Mon, 01 Jan 0001 00:00:00 +0000

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

mc admin bucket remote add 已替换为 mc replicate add
mc admin bucket remote update 已替换为 mc replicate update
mc admin bucket remote rm 已替换为 mc replicate rm
mc admin bucket remote ls 已替换为 mc replicate ls

变更: RELEASE.2023-02-16T19-20-11Z

mc admin bucket remote bandwidth 已替换为 mc replicate status

与复制相关的统计信息已迁移到 mc replicate status 命令。

mc get

Mon, 01 Jan 0001 00:00:00 +0000

新增: mc

RELEASE.2024-02-24T01-33-20Z

语法

mc get 命令将对象从目标 S3 部署下载到本地文件系统。

与 mc cp 或 mc mirror 相比，mc get 为下载文件提供了更简化的接口。 mc get 使用单向下载功能，以牺牲效率为代价，换取相较其他命令更低的功能复杂度。

已弃用设置

Mon, 01 Jan 0001 00:00:00 +0000

本页介绍用于控制 MinIO 进程核心行为的已弃用设置。

本页中的设置可能随时被移除。用户应尽早迁移到推荐的替代项。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

mc admin console

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已在 mc RELEASE.2022-12-02T23-48-47Z 中被 mc admin logs 替代。

该命令此前已在 mc RELEASE.2022-06-26T18-51-48Z 中被 mc support logs show 替代。

描述

mc admin console 命令返回部署中每个 MinIO 服务器的服务端日志条目。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin rebalance

Mon, 01 Jan 0001 00:00:00 +0000

权限

执行此命令的用户必须拥有该部署的 admin:Rebalance 策略操作。

描述

mc admin rebalance 命令可用于在 MinIO 部署上启动、监控或停止再平衡操作。再平衡会在部署中的所有池之间重新分配对象。

当新增服务器池时，MinIO 不会自动对对象执行再平衡。相反，MinIO 会将新对象写入相较于部署中其他可用池可用空间更多的池。触发手动再平衡流程会促使 MinIO 扫描整个部署，并按需移动对象，以使所有池的可用空间大致相当。

mc head

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc head 命令显示对象的前 n 行，其中 n 是传递给该命令的参数。

mc head 不会对对象内容执行任何转换或格式化来提升可读性。你也可以将 mc head 用于本地文件系统，以获得与 head 命令行工具类似的结果。

mc admin idp ldap

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2023-05-26T23-31-54Z

mc admin idp ldap 及其子命令已由 mc idp ldap 替代。

说明

mc admin idp ldap 命令允许你为第三方 Active Directory 或 LDAP 身份与访问管理（IAM）集成添加、修改、查看、列出、移除、启用和禁用服务器配置。

mc admin replicate

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2023-01-11T03-14-16Z

mc admin replicate edit renamed to mc admin replicate update
mc admin replicate remove renamed to mc admin replicate rm

描述

mc admin replicate 命令用于为一组 MinIO 对等站点创建并管理站点复制。

站点复制类似于 active-active 存储桶复制，但适用于多个 MinIO 部署。在这组站点中，无论 IAM 设置、存储桶或对象发生何种变更，该变更都会在站点复制组中的所有站点间复制。

mc admin idp ldap policy

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2023-05-26T23-31-54Z

mc admin idp ldap policy 及其子命令已由 mc idp ldap policy 替代。

说明

mc admin idp ldap policy 命令用于查看策略与关联组或用户之间的映射关系。

mc admin idp ldap policy 命令包含以下子命令：

子命令	说明
`mc admin idp ldap policy attach`	将策略附加到实体
`mc admin idp ldap policy detach`	从实体分离策略
`mc admin idp ldap policy entities`	列出策略与实体的映射

语法

`attach`

mc-cmd

mc admin idp openid

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2023-05-26T23-31-54Z

mc admin idp openid 及其子命令已由 mc idp openid 替代。

描述

mc admin idp openid 命令允许你为第三方 OpenID 身份与访问管理（IAM）集成添加、修改、查看、列出、移除、启用和禁用服务器配置。

mc admin service

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin service 命令可用于重启或解除冻结 MinIO 服务器。

mc admin service 会同时影响目标部署中的所有 MinIO 服务器。该命令会中断 MinIO 部署上正在进行的 API 操作。对某个部署执行此命令时请谨慎。

mc idp ldap accesskey create-with-login

Mon, 01 Jan 0001 00:00:00 +0000

新增: mc

RELEASE.2024-04-18T16-45-29Z

描述

mc idp ldap accesskey create-with-login 使用基于终端的交互式提示与外部 AD/LDAP 服务器进行身份验证，并生成可供 MinIO 使用的访问密钥。

以下示例会提示用户提供其 AD/LDAP 凭证。然后使用与该 AD/LDAP 用户关联的一个或多个策略生成新的访问密钥对。

mc admin profile

Mon, 01 Jan 0001 00:00:00 +0000

说明

自 mc RELEASE.2023-04-06T16-51-10Z 起，该命令已由 mc support profile 取代。

描述

mc admin profile 命令会生成用于调试的性能分析数据。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin trace

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin trace 命令显示目标 MinIO 部署上发生的 API 操作。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin speedtest

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2022-07-24T02-25-13Z

mc admin speedtest 已由 mc support perf 替代。

描述

mc admin speedtest 命令通过 PUT 和 GET 操作测试每个主机的吞吐量。

speedtest 从 mc RELEASE.2021-09-02T09-21-27Z 开始可用，并支持运行 RELEASE.2021-07-30T00-02-00Z 或更高版本的分布式 MinIO 部署。

speedtest 不支持独立部署或 MinIO Gateway 部署。

mc admin update

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin update 命令会更新部署中的所有 MinIO 服务器。该命令还支持使用私有镜像服务器，适用于部署环境无法访问公网的场景。

运行该命令后，会显示确认更新的提示。输入 y 并按 [ENTER]，即可确认并继续更新。

mc idp openid

Mon, 01 Jan 0001 00:00:00 +0000

新增: RELEASE.2023-05-26T23-31-54Z

mc idp openid 及其子命令取代 mc admin idp openid。

描述

mc idp openid 命令允许你管理第三方 OpenID 身份与访问管理（IAM）集成的配置。

在设置 OpenID 连接时，可通过定义配置项作为使用环境变量的替代方式。mc idp openid 命令仅支持 MinIO 部署。

核心管理概念

Mon, 01 Jan 0001 00:00:00 +0000

以下核心概念是管理 MinIO 部署的基础，包括但不限于对象保留、加密和访问管理。

什么是对象存储？

对象是二进制数据，有时也称为 Binary Large OBject (BLOB)。 Blob 可以是图像、音频文件、电子表格，甚至是二进制可执行代码。像 MinIO 这样的对象存储平台提供专门的工具和能力，用于存储、检索和搜索 Blob。

mc admin tier

Mon, 01 Jan 0001 00:00:00 +0000

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

mc admin tier 已由 mc ilm tier 替代。

描述

mc admin tier 命令用于配置受支持的远程 S3 兼容服务，以支持 MinIO Lifecycle Management: Object Transition (“Tiering”)。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin top

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2022-08-11T00-30-48Z

mc admin top 已由 mc support top 替代。

描述

mc admin top 命令返回分布式 MinIO 部署的统计信息，类似于 top 命令的输出。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

使用 Object Lambda 进行转换

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 的 Object Lambda 使开发者能够按需以编程方式转换对象。你可以根据具体用例按需转换对象，例如脱敏个人身份信息（PII）、使用其他来源的信息增强数据，或在不同格式之间进行转换。

mc ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc ls 命令用于列出 MinIO 或其他 S3 兼容服务上的存储桶和对象。

你也可以对本地文件系统使用 mc ls，生成与 ls 命令类似的结果。

以下命令列出 myminio MinIO 部署中 mydata 存储桶内的所有对象及对象版本：

文件传输协议 (FTP/SFTP)

Mon, 01 Jan 0001 00:00:00 +0000

使用 FTP 和 SFTP 与 MinIO 进行文件传输

从 MinIO Operator 5.0.7 和 MinIO Server RELEASE.2023-04-20T17-56-55Z 起，你可以使用 SSH 文件传输协议 (SFTP) 与 MinIO Operator 租户部署中的对象交互。

mc mb

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc mb 命令在指定路径创建新的存储桶或目录。

你也可将 mc mb 用于本地文件系统，实现与 mkdir -p 命令行工具类似的效果。

以下命令会在 myminio MinIO 部署上创建一个新的存储桶 mydata。该命令创建的存储桶将启用对象锁定。

mc mirror

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc mirror 命令用于将内容同步到 MinIO 部署，类似于 rsync 工具。 mc mirror 支持以文件系统、MinIO 部署和其他 S3 兼容主机作为同步源。

说明

mc mirror 仅同步当前对象，不包含任何版本信息或元数据。若要同步对象的版本历史和元数据，可考虑对 bucket replication 使用 mc replicate，或对 site replication 使用 mc admin replicate。

mc mv

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc mv 命令将对象从源移动到目标，例如在不同 MinIO 部署之间移动，或在同一 MinIO 部署的不同存储桶之间移动。 mc mv 还支持在本地文件系统与 MinIO 之间移动对象。

你也可以对本地文件系统使用 mc mv，以获得与 mv 命令行工具类似的结果。

S3 API 兼容性

Mon, 01 Jan 0001 00:00:00 +0000

本页面记录 MinIO 对象存储支持的 S3 API。如需查看任意 API 的参考文档，请参阅 Amazon S3 的对应文档。

重要

MinIO 强烈建议使用 S3 兼容 SDK 执行对象存储操作。

对象 API

对象锁定

不支持的 API 对象端点

GetObjectAcl
PutObjectAcl

多部分上传

与 S3 API 在多部分上传方面的差异

ListMultipartUploads 需要使用精确的对象名称作为前缀。
PutBucketLifecycle 不支持 AbortIncompleteMultipartUpload 生命周期动作。

存储桶 API

存储桶复制

存储桶生命周期

存储桶通知

存储桶策略

不支持的 API 存储桶操作

GetBucketInventoryConfiguration
PutBucketInventoryConfiguration
DeleteBucketInventoryConfiguration
PutBucketCors
DeleteBucketCors
GetBucketMetricsConfiguration
PutBucketMetricsConfiguration
DeleteBucketMetricsConfiguration
PutBucketWebsite
GetBucketLogging
PutBucketLogging
PutBucketAccelerateConfiguration
DeleteBucketAccelerateConfiguration
PutBucketRequestPayment
DeleteBucketRequestPayment
PutBucketAcl
HeadBucketAcl
GetPublicAccessBlock
PutPublicAccessBlock
DeletePublicAccessBlock
GetBucketOwnershipControls
PutBucketOwnershipControls
DeleteBucketOwnershipControls
GetBucketIntelligentTieringConfiguration
PutBucketIntelligentTieringConfiguration
ListBucketIntelligentTieringConfigurations
DeleteBucketIntelligentTieringConfiguration
GetBucketAnalyticsConfiguration
PutBucketAnalyticsConfiguration
ListBucketAnalyticsConfigurations
DeleteBucketAnalyticsConfiguration
CreateSession

MinIO 针对不支持的存储桶资源的替代方案

对于 BucketACL 或 ObjectACL 操作调用，请使用 Policies。
不需要 BucketCORS 操作调用，因为默认情况下所有存储桶都已为所有 HTTP 动词启用 CORS。
对于 BucketWebsite 操作调用，请使用 caddy 或 nginx。
对于 BucketAnalytics、BucketMetrics 或 BucketLogging 操作调用，请使用存储桶通知。

mc od

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc od 命令将本地文件按指定的分片数量与分片大小复制到远程位置。该命令会输出上传该文件所耗费的时间。

使用 mc od 可模拟 Linux dd 命令的功能。

以下命令将文件的 200MiB 上传到存储桶中，分为 5 个 40MiB 的分片。输出会显示上传结果，包括完成上传所用的时长。

术语表

Mon, 01 Jan 0001 00:00:00 +0000

access keys

访问密钥

MinIO 部署或租户中的一种受限用户账户，通常用于 API 调用。访问密钥过去称为 “Service Account（服务账户）”。

active-active

双活

一种 replication 方式，提供数据的双向镜像。在 active-active 配置中，修改任一存储位置中的数据，也会同步修改其他存储位置中的数据。

mc ping

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc ping 命令对指定目标执行存活性检查。

以下命令向目标发送请求，并输出响应的最小、最大、平均与往返时间，以及处理请求时遇到的错误数量。

mc pipe

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc pipe 命令将内容从 STDIN 流式传输到目标对象。

以下命令将 STDIN 的内容写入 S3 兼容存储。

echo "My Meeting Notes" | mc pipe s3/engineering/meeting-notes.txt

该命令语法如下：

mc [GLOBALFLAGS] pipe \
 TARGET \
 [--attr "string"] \
 [--checksum "string"] \
 [--enc-kms "string"] \
 [--enc-s3 "string"] \
 [--enc-c "string"] \
 [--storage-class, --sc "string"] \
 [--tags "string"]

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

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

mc put

Mon, 01 Jan 0001 00:00:00 +0000

新增: mc

RELEASE.2024-02-24T01-33-20Z

语法

mc put 将对象从本地文件系统上传到目标 S3 部署中的存储桶。

与 mc cp 或 mc mirror 相比，mc put 为文件上传提供了更简化的接口。 mc put 使用单向上传机制，以牺牲效率为代价换取相较其他命令更低的复杂度。

mc rb

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc rb 命令用于删除 MinIO 或其他兼容 S3 服务上的一个或多个存储桶。

如仅需删除存储桶内容，请改用 mc rm。

重要

mc rb 会在目标部署上永久删除存储桶，包括所有对象版本以及存储桶配置，例如生命周期管理或复制。

mc ready

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc ready 命令用于检查集群状态，以及集群是否具有 read 和 write quorum。

以下命令向别名为 myminio 的集群发送 GET 请求，并返回其状态。

mc rm

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc rm 命令用于从 MinIO 部署的存储桶中删除对象。如需彻底删除存储桶，请改用 mc rb。

你也可以对本地文件系统使用 mc rm，以获得与 rm 命令行工具类似的结果。

有关 MinIO 如何对对象执行 DELETE 操作的更多信息，请参见对象删除。

mc sql

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc sql 命令提供 S3 Select 接口，用于对指定 MinIO 部署中的对象执行 SQL 查询。

有关 S3 Select 的行为和限制，请参阅 Selecting content from objects。

以下命令会查询 myminio MinIO 部署中 mydata 存储桶内的所有对象：

mc stat

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc stat 命令用于显示 MinIO 存储桶中对象的信息，包括对象元数据。你也可以使用它来检索存储桶元数据。

你可以对本地文件系统使用 mc stat，以获得与 stat 命令行工具类似的结果。

mc tree

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc tree 命令以树形格式列出 MinIO 存储桶中的所有前缀。该命令还可选支持在每个前缀处列出存储桶内的所有对象，包括存储桶根。

你也可以将 mc tree 用于本地文件系统目录，获得与 tree 命令行工具类似的结果。

mc undo

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc undo 命令用于撤销指定路径上由 PUT 或 DELETE 操作引起的更改。

以下命令会回滚 myminio 部署中 data 存储桶内 file.zip 对象最近三次上传和/或删除操作：

mc update

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc update 命令会自动将 mc 二进制更新到最新稳定版本。

运行此命令等同于手动下载最新稳定版二进制文件，并使用该文件替换主机上现有的 mc 安装。

以下命令会更新本地主机上的 mc 二进制文件：

mc watch

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc watch 命令用于监视指定 MinIO 存储桶或本地文件系统路径上的事件。对于 S3 服务，请使用 mc event add 在兼容 S3 的服务上配置存储桶事件通知。

你也可以将 mc watch 用于本地文件系统目录，以获得与运行 inotify -e modify,create,delete,move 命令类似的结果。

API

Mon, 01 Jan 0001 00:00:00 +0000

404: Not Found

用于 Amazon S3 兼容云存储的 MinIO Rust SDK

Mon, 01 Jan 0001 00:00:00 +0000

页面未找到

Mon, 01 Jan 0001 00:00:00 +0000

你访问的页面已移动、已删除，或不存在。

升级旧版 MinIO Operator

Mon, 01 Jan 0001 00:00:00 +0000

MinIO 为旧版 MinIO Operator 支持以下升级路径：

当前版本	支持升级到
5.0.15 及更高版本	7.1.1
5.0.0 到 5.0.14	5.0.15
4.2.3 到 4.5.7	4.5.8
4.0.0 到 4.2.2	4.2.3
3.X.X	4.2.2

如果要从 4.5.7 或更早版本升级到 7.1.1，你必须先升级到 4.5.8，然后再升级到 5.0.15。根据你当前的版本，可能需要经过一个或多个中间升级步骤才能到达 v4.5.8。

kubectl minio init

Mon, 01 Jan 0001 00:00:00 +0000

说明

kubectl minio init 命令用于初始化 MinIO Operator。

如果 Kubernetes 集群中已安装 MinIO Operator，此命令会将 Operator 升级到与 MinIO 插件版本一致。有关升级 MinIO Operator 的更多信息，请参见升级 MinIO Operator。

语法

以下命令会初始化一个运行 7.1.1 的新 MinIO Operator 部署。

mc idp ldap accesskey create

Mon, 01 Jan 0001 00:00:00 +0000

新增: mc

RELEASE.2023-12-23T08-47-21Z

描述

mc idp ldap accesskey create 允许添加 LDAP 访问密钥对。

以下示例在 minio alias 上创建一个新的访问密钥对，并使用与已认证用户相同的策略：

下载与安装 SILO

Mon, 01 Jan 0001 00:00:00 +0000