MinIO Client (mc) 命令手册


mc admin

mc admin accesskey

为 AIStor 部署中内部管理的用户创建和管理访问密钥(Access Key)。

mc admin cluster bucket

导入和导出 AIStor 存储桶的元数据。

mc admin cluster iam

导入和导出 AIStor 身份与访问管理(IAM)相关的元数据。

mc admin decommission

启动 AIStor 服务器池的退役流程,并将数据从退役池迁移到其余池中。

mc admin group

管理 AIStor 部署中的用户组。

mc admin heal

扫描并修复损坏或丢失的对象副本(适用于纠删码部署)。

mc admin info

显示 AIStor 服务器的信息;在分布式部署中,显示每个节点的状态。

mc admin kms key

通过 MinIO 密钥加密服务(KES)执行加密密钥管理操作(如创建、列出、删除密钥)。

mc admin logs

查看 AIStor 对象存储服务的日志输出。

mc admin policy

使用符合 IAM 规范的 JSON 策略文档,管理 MinIO 基于策略的访问控制(PBAC)策略。

mc admin prometheus

提供对 MinIO 内置 Prometheus 指标端点的访问(用于监控集成)。

mc admin rebalance

启动、监控或停止再平衡操作,将对象在所有存储池之间重新均匀分布。

mc admin replicate

为一组 AIStor 对等站点配置和管理站点级复制(Site Replication),实现跨站点配置与数据同步。

mc admin scanner

提供关于后台扫描器(scanner)进程的运行状态和统计信息。

mc admin service

重启或解冻(unfreeze)AIStor 服务器实例。

mc admin trace

实时显示目标 AIStor 部署上发生的 API 请求和操作(用于调试和性能分析)。

mc admin update

更新部署中的所有 AIStor 服务器,支持使用私有镜像源进行离线升级。

mc admin user

管理 AIStor 部署中的用户账户(创建、删除、禁用、列出等)。

add

命令用于向目标 AIStor 部署中添加一个新用户。

mc admin user add

disable

命令用于禁用目标 AIStor 部署中的指定用户,使其无法登录或执行操作。

mc admin user disable

enable

命令用于启用目标 AIStor 部署中已被禁用的用户。

mc admin user enable

info

命令返回目标 AIStor 部署中指定用户的详细信息,包括状态、所属组、策略等。

mc admin user info

ls

命令列出目标 AIStor 部署中的所有用户。

mc admin user ls

rm

命令从目标 AIStor 部署中删除指定用户(需确保该用户无活跃会话或依赖资源)。

mc admin user rm

sts info

命令用于查询指定 STS(Security Token Service)临时凭证的详细信息,包括生成该凭证的父用户、关联策略、过期时间等。

mc admin user sts info

mc alias

支持连接到 S3 兼容主机并对其执行操作。

mc anonymous

支持在存储桶及其内容上设置或移除匿名策略。允许公共访问,客户端无需身份验证即可执行策略授予的任何操作。

mc batch

在 AIStor 部署上运行一个或多个作业任务。

mc cat

将文件或对象的内容连接到另一个文件或对象,或者将内容输出到标准输出(STDOUT)。

mc cp

在 AIStor 部署与本地文件系统之间复制对象(支持双向)。

mc diff

计算两个文件系统目录或 AIStor 存储桶之间的差异。仅列出缺失或大小不同的对象;不比较内容。

mc du

汇总存储桶和文件夹的磁盘使用情况。也可用于本地文件系统。

mc encrypt

设置、更新或禁用存储桶的默认服务器端加密(SSE)模式。

mc event

添加、移除或列出存储桶的事件通知配置。

mc find

在 AIStor 部署或本地文件系统中搜索对象或文件。

mc get

从目标 S3 兼容服务下载对象到本地文件系统。

mc head

显示对象的前 n 行内容(n 由参数指定)。

mc idp ldap

管理第三方 Active Directory 或 LDAP 身份与访问管理(IAM)集成的配置。

mc idp openid

管理第三方 OpenID Connect(OIDC)身份提供商(IdP)的集成配置。

mc idp ldap policy

显示 LDAP 策略与关联用户或用户组之间的映射关系。

mc ilm rule

管理 AIStor 部署上的对象生命周期管理(ILM)规则。

mc ilm tier

管理 AIStor 部署中的存储分层(如冷热数据分层)配置。

mc legalhold

设置、移除或查询对象的法律保留(Legal Hold / WORM)状态。

mc license

用于 MinIO SUBNET 集群注册:注册部署、查看许可证信息或更新许可证密钥。

mc ls

列出 AIStor 或其他 S3 兼容服务中的存储桶和对象。

mc mb

在指定路径创建新的存储桶(或本地目录)。

mc mirror

同步内容到 AIStor 部署,功能类似于 rsync。支持本地文件系统、AIStor 或其他 S3 兼容服务作为源。

mc mv

移动对象,例如在不同存储桶、不同 MinIO 部署之间,或在本地与远程之间移动。

mc od

将本地文件按指定分片数量和分片大小上传至远程位置,并输出上传耗时,用于性能测试。

mc ping

对指定目标执行存活检查(Liveness Check),验证连接可用性。

mc pipe

将标准输入(STDIN)流式写入目标对象(常用于管道操作)。

mc put

将本地文件系统中的对象上传到目标 S3 兼容服务的存储桶中。

mc rb

删除一个或多个存储桶(需为空)。若仅想清空内容,请使用 mc rm

mc ready

检查集群状态,确认是否具备读写仲裁(Quorum),判断集群是否就绪。

mc replicate

配置和管理服务器端存储桶复制(包括主动-主动复制、重新同步等)。

mc retention

为存储桶中的对象配置 WORM(一次写入多次读取)保留策略,也可设置存储桶默认锁定配置。

mc rm

从存储桶中删除一个或多个对象。若要删除整个存储桶,请使用 mc rb

mc share

生成预签名 URL,用于临时共享对象的上传或下载权限。

mc sql

提供 S3 Select 功能,支持对存储桶中的对象执行 SQL 查询(如 CSV/JSON/Parquet 文件)。

mc stat

显示对象或存储桶的详细元数据信息(如大小、修改时间、ETag、加密状态等)。

mc support

提供部署健康诊断工具,可生成并上传健康报告供 MinIO 工程团队分析。

mc tag

为存储桶或对象添加、删除或列出标签(Tag)。

mc tree

以树形结构列出存储桶内的所有前缀(Prefix),可选包含每个前缀下的对象列表。

mc undo

撤销指定路径上最近一次的 PUT(上传)或 DELETE(删除)操作(需启用了版本控制)。

mc update

mc 客户端二进制文件升级到最新稳定版本。

mc version

启用、禁用或查询存储桶的版本控制状态。

mc watch

监听指定存储桶或本地路径的事件变化(如对象创建、删除等)。