文档

MinIO 管理员客户端

MinIO 客户端 mc 命令行工具提供了用于在 MinIO 部署中执行管理任务的命令。

虽然 mc 支持任何与 S3 兼容的服务,但 mc admin *仅* 支持 MinIO 部署。

mc admin 具有以下语法

mc admin [FLAGS] COMMAND [ARGUMENTS]

命令快速参考

下表列出了 mc admin 命令

命令

描述

mc admin accesskey

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

mc admin cluster bucket

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

mc admin cluster iam

The mc admin cluster iam 命令及其子命令提供了用于手动导入和导出 MinIO 身份和访问管理 (IAM) 元数据的工具。

mc admin decommission

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

mc admin group

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

mc admin heal

命令 mc admin heal 会扫描损坏或已损坏的对象,并修复这些对象。

mc admin info

命令 mc admin info 会显示 MinIO 服务器的信息。对于分布式 MinIO 部署,mc admin info 会显示部署中每个 MinIO 服务器的信息。

mc admin kms key

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

mc admin logs

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

mc admin policy

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

mc admin prometheus

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

mc admin rebalance

命令 mc admin rebalance 允许在 MinIO 部署上启动、监控或停止重新平衡操作。重新平衡会将对象重新分布到部署中的所有池。

mc admin replicate

命令 mc admin replicate 用于创建和管理一组 MinIO 对等站点之间的 站点复制

站点复制模拟了活跃-活跃的存储桶复制,但适用于多个 MinIO 部署。无论在站点集中对 IAM 设置、存储桶或对象进行任何更改,该更改都会复制到站点复制组中的所有站点。

mc admin scanner

命令 mc admin scanner 提供有关 扫描程序 进程的信息。

mc admin service

命令 mc admin service 可以重启或解除 MinIO 服务器的冻结状态。

mc admin trace

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

mc admin update

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

mc admin user

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

安装

以下命令会将一个临时扩展添加到您的系统 PATH 中,以便运行 mc 实用程序。请参考您的操作系统的说明,以了解如何对系统 PATH 进行永久修改。

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

64 位 Intel

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 位 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

通过双击执行该文件,在命令提示符或 PowerShell 中运行以下命令

\path\to\mc.exe --help

从源代码安装适用于开发人员和高级用户,并且需要一个可用的 Golang 环境。请参阅 如何安装 Golang

在终端环境中运行以下命令以从源代码安装 mc

go install github.com/minio/mc@latest

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

快速入门

在开始此过程之前,请确保主机已 mc 安装

重要

以下示例会暂时禁用 bash 历史记录,以降低明文泄露身份验证凭据的风险。这只是一项基本的安全措施,并不能缓解所有可能的攻击途径。请参考您的操作系统的安全最佳实践,以了解如何在命令行中输入敏感信息。

使用命令 mc alias set 将部署添加到 mc 配置中。

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 相同的全局选项。请参阅 全局选项