文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

MinIO Admin Client

MinIO Clientmc命令行工具提供mc admin用于在您的 MinIO 部署上执行管理任务的命令。

mc支持任何与S3兼容的服务,mc admin 支持 MinIO 部署。

mc admin具有以下语法:

mc admin [FLAGS] COMMAND [ARGUMENTS]

命令快速参考

下表列出了mc admin命令:

命令

描述

mc admin accesskey

Themc admin accesskey命令及其子命令用于创建和管理访问密钥对于MinIO部署中的内部管理用户。

mc admin cluster bucket

Themc admin cluster bucket该命令及其子命令提供了用于手动导入和导出 MinIO 存储桶元数据的工具。

mc admin cluster iam

Themc admin cluster iamcommand 及其子命令提供了用于手动导入和导出 MinIO 的工具。身份和访问管理 (IAM)metadata.

mc admin decommission

Themc admin decommission命令启动 MinIO 的退役流程服务器池. 退役功能旨在移除较旧的服务器池,这些池的硬件与部署中的其他池相比已不再足够或性能不足。MinIO 会根据每个池中可用空闲空间的比例,自动将退役池中的数据迁移到部署中剩余的池中。

mc admin group

Themc admin group命令用于管理 MinIO 部署中的用户组。

mc admin heal

Themc admin heal命令扫描损坏或损坏的对象并修复这些对象。

mc admin info

Themc admin infocommand displays information on a MinIO server. 对于分布式 MinIO 部署,mc admin info显示部署中每个 MinIO 服务器的信息。

mc admin kms key

Themc admin kms key该命令通过 MinIO 密钥加密服务 (KES) 执行加密密钥管理操作。

mc admin logs

使用mc admin logs显示 MinIO 服务器日志的命令。

mc admin policy

Themc admin policy命令管理用于策略的策略MinIO 基于策略的访问控制(PBAC)。 MinIO PBAC 使用与 IAM 兼容的策略 JSON 文档来定义访问 MinIO 服务器上资源的规则。

mc admin prometheus

Themc admin prometheus该命令及其子命令提供对 MinIO Prometheus 指标的访问。

mc admin rebalance

Themc admin rebalancecommand 命令允许在 MinIO 部署上启动、监控或停止重新平衡操作。 重新平衡会在部署中的所有池之间重新分配对象。

mc admin replicate

Themc admin replicate命令创建和管理站点复制对于一组MinIO对等站点。

站点复制模拟了主动-主动存储桶复制,但适用于多个MinIO部署。 无论在整个站点集合中的IAM设置、存储桶或对象发生任何更改,这些更改都会在站点复制组中的所有站点之间进行复制。

mc admin scanner

Themc admin scanner命令提供有关扫描仪过程。

mc admin service

Themc admin service该命令可以重启或解冻 MinIO 服务器。

mc admin trace

Themc admin trace该命令显示目标 MinIO 部署中发生的 API 操作。

mc admin update

Themc admin update该命令会更新部署中的所有 MinIO 服务器。 该命令还支持在部署环境无法访问公共互联网的情况下使用私有镜像服务器。

mc admin user

Themc admin user命令及其子命令管理MinIO 用户.

安装

以下命令添加一个临时的extension to your system PATH for running themc实用工具。请参考您的操作系统说明来对系统PATH进行永久性修改。

或者,执行mc通过导航到父文件夹并运行./mc --help

64位英特尔

curl https://dl.min.io/client/mc/release/linux-amd64/mc \
  --create-dirs \
  -o $HOME/minio-binaries/mc

chmod +x $HOME/minio-binaries/mc
export PATH=$PATH:$HOME/minio-binaries/

mc --help

64-bit PPC

curl https://dl.min.io/client/mc/release/linux-ppc64le/mc \
  --create-dirs \
  -o ~/minio-binaries/mc

chmod +x $HOME/minio-binaries/mc
export PATH=$PATH:$HOME/minio-binaries/

mc --help

ARM64

curl https://dl.min.io/client/mc/release/linux-arm64/mc \
  --create-dirs \
  -o ~/minio-binaries/mc

chmod +x $HOME/minio-binaries/mc
export PATH=$PATH:$HOME/minio-binaries/

mc --help

从 MinIO 下载页面安装

MinIO 不正式将其二进制文件发布到常见的 Linux 软件仓库或软件包管理器(Ubuntu、RHEL、Archlinux/AUR)。 MinIO 二进制文件的唯一官方来源是MinIO 下载页面.

MinIO 不推荐通过包管理器安装,因为上游存储库可能会安装错误的软件包或重命名的软件包。

所有文档都假定已安装官方 mc通过下载页面获取客户端二进制文件,且二进制文件命名保持不变。

brew install minio/stable/mc
mc --help

在浏览器中打开以下文件:

https://dl.min.io/client/mc/release/windows-amd64/mc.exe

双击该文件即可执行。or在命令提示符或 PowerShell 中运行以下命令:

\path\to\mc.exe --help

从源码安装适用于开发者和高级用户 需要可正常工作的 Golang 环境。参见如何安装 Golang.

在终端环境中运行以下命令进行安装mc来自源:

go install github.com/minio/mc@latest

mc update不支持基于源代码的安装。

快速入门

确保主机具有mc 已安装在开始此过程之前。

重要

以下示例临时禁用 bash 历史记录,以降低认证凭证以明文形式泄露的风险。这是一项基本安全措施,并不能防范所有可能的攻击途径。在命令行输入敏感信息时,请遵循您操作系统的安全最佳实践。

使用mc alias set命令以将 部署添加到mcconfiguration.

bash +o history
mc config host add <ALIAS> <ENDPOINT> ACCESS_KEY SECRET_KEY
bash -o history

将每个参数替换为所需的值。仅指定mc config host add命令启动一个输入提示,用于输入所需的值。

使用mc admin info测试与新添加的 MinIO 部署连接的命令:

mc admin info <ALIAS>

全局选项

mc admin支持与...相同的全局选项mc.全局选项.