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

MinIO Documentation

MinIO Client Settings

本页面涵盖了以下设置:MinIO 客户端.

您可以通过定义以下内容来建立或修改设置:

  • an 环境变量在启动或重启 MinIO 服务器之前,请在主机系统上设置此环境变量。 有关如何定义环境变量,请参阅操作系统的文档。

  • a 配置设置使用mc admin config set.

如果您同时定义了环境变量和类似的配置设置,MinIO 将使用环境变量的值。

某些设置只有环境变量或配置设置,但没有两者都提供。

设置

主机凭据

使用此设置添加临时别名以用于mc命令。 例如,用于脚本编写。

临时别名使用AWS s3v4 signature.

MC_HOST_<ALIAS>

替换<ALIAS>在环境变量的末尾加上alias要设置的主机。

此设置没有配置设置选项。

使用mc alias set配置一个别名.

示例

静态凭据

export MC_HOST_<alias>=https://<Access Key>:<Secret Key>@<YOUR-S3-ENDPOINT>
export MC_HOST_myalias=https://Q3AM3UQ867SPQQA43P2F:zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG@play.min.io

Security Token Service (STS) Credentials

export MC_HOST_<alias>=https://<Access Key>:<Secret Key>:<Session Token>@<YOUR-S3-ENDPOINT>
export MC_HOST_myalias=https://Q3AM3UQ867SPQQA43P2F:zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG:eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhY2Nlc3NLZXkiOiJOVUlCT1JaWVRWMkhHMkJNUlNYUiIsImF1ZCI6IlBvRWdYUDZ1Vk80NUlzRU5SbmdEWGo1QXU1WWEiLCJhenAiOiJQb0VnWFA2dVZPNDVJc0VOUm5nRFhqNUF1NVlhIiwiZXhwIjoxNTM0ODk2NjI5LCJpYXQiOjE1MzQ4OTMwMjksImlzcyI6Imh0dHBzOi8vbG9jYWxob3N0Ojk0NDMvb2F1dGgyL3Rva2VuIiwianRpIjoiNjY2OTZjZTctN2U1Ny00ZjU5LWI0MWQtM2E1YTMzZGZiNjA4In0.eJONnVaSVHypiXKEARSMnSKgr-2mlC2Sr4fEGJitLcJF_at3LeNdTHv0_oHsv6ZZA3zueVGgFlVXMlREgr9LXA@play.min.io

STS服务

版本 mc 中的新功能:RELEASE.2023-11-06T04-19-23Z

使用此设置可添加用于 STS 的端点mc命令。

在版本 mc 中更改:RELEASE.2023-12-02T02-03-28Z

支持通过别名添加多个环境变量。

MC_STS_ENDPOINT_<alias>
export MC_STS_ENDPOINT_myalias=https://sts.minio-operator.svc.cluster.local:4223/sts/ns-1

此设置没有配置设置选项。

Web Token Identity

版本 mc 中的新功能:RELEASE.2023-11-06T04-19-23Z

使用此设置添加要用于的网络令牌身份mc命令。

在版本 mc 中更改:RELEASE.2023-12-02T02-03-28Z

支持通过别名添加多个环境变量。

MC_WEB_IDENTITY_TOKEN_<alias>
export MC_WEB_IDENTITY_TOKEN_FILE_myalias=/var/run/secrets/kubernetes.io/serviceaccount/token

此设置没有配置设置选项。

配置目录

指定 MinIO 客户端应使用的配置文件夹路径。

MC_CONFIG_DIR

此设置没有配置设置选项。

进度条

禁用 MinIO 客户端进度条。

MC_QUIET

此设置没有配置设置选项。

寻呼机

版本 mc 中的新功能:RELEASE.2024-04-29T09-56-05Z

在 CLI 中禁用 MinIO 客户端的翻页功能。 启用后,输出将直接打印到原始终端。STDOUT相反。

MC_DISABLE_PAGER

此设置没有配置设置选项。

Color Theme

禁用用于 MinIO Client 输出的颜色主题。

MC_NO_COLOR

此设置没有配置设置选项。

JSON

启用将输出格式化为JSON行的功能。

MC_JSON

此设置没有配置设置选项。

调试

启用调试输出。

MC_DEBUG

此设置没有配置设置选项。

禁用 SSL

禁用 SSL 证书验证。

MC_INSECURE

此设置没有配置设置选项。

限制下载带宽

限制 MinIO 客户端在某些命令中使用的下载带宽。

MC_LIMIT_DOWNLOAD

此设置没有配置设置选项。

如果未指定,MinIO Client 将使用所有可用带宽。

将客户端下载速率限制在指定的 KiB/s、MiB/s 或 GiB/s 范围内。这仅影响运行 MinIO Client 的本地设备的下载速度。有效单位包括:

  • B 表示字节

  • K 表示千字节

  • M 表示兆字节

  • G 表示千兆字节

  • Ki 表示 kibibytes

  • Mi 表示兆二进制字节

  • Gi 表示 gibibytes

例如,要在 Linux 系统上将下载速率限制在不超过 1 GiB/s,请使用以下命令:

export MC_LIMIT_DOWNLOAD=1G

请参考您的操作系统说明,以获取在非 Linux 系统上的等效命令。

限制上传带宽

限制 MinIO 客户端用于特定命令的上传带宽。

MC_LIMIT_UPLOAD

此设置没有配置设置选项。

如果未指定,MinIO Client 将使用所有可用带宽。

限制客户端上传速率不超过指定的 KiB/s、MiB/s 或 GiB/s 速率。这仅影响运行 MinIO Client 的本地设备的上传。有效单位包括:

  • B 表示字节

  • K 表示千字节

  • M 表示兆字节

  • G 表示千兆字节

  • Ki 表示 kibibytes

  • Mi 表示兆二进制字节

  • Gi 表示 gibibytes

例如,要在 Linux 系统上将上传速率限制在不超过 1 GiB/s,请使用以下命令:

export MC_LIMIT_UPLOAD=1G

请参考您的操作系统说明,以获取在非 Linux 系统上的等效命令。

SSE-KMS 加密

加密和解密选项使用SSE-KMS使用服务器托管密钥。

MC_ENC_KMS

使用键MC_ENC_KMS环境变量。

此设置没有配置设置选项。

SSE-S3 加密

加密和解密选项使用SSE-KMS使用服务器托管密钥。

MC_ENC_S3

指定用于执行 SSE-S3 加密的密钥。 指定的值必须与加密密钥设置中的值匹配MINIO_KMS_KES_KEY_NAME.

此设置没有配置设置选项。