文档

MinIO 客户端设置

本页面涵盖 MinIO 客户端 的设置。

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

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

  • 使用 mc admin config set 定义一个配置设置

  • 使用 MinIO 控制台的 管理员 > 设置 页面定义一个配置设置

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

某些设置只有环境变量或配置设置,而不会同时存在。

设置

主机凭据

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

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:[email protected]

安全令牌服务 (STS) 凭据

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 令牌身份

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

使用此设置添加一个 Web 令牌身份,用于 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

DISABLE_PAGER

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

颜色主题

禁用用于 MinIO 客户端输出的颜色主题。

MC_NO_COLOR

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

JSON

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

MC_JSON

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

调试

启用调试输出。

MC_DEBUG

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

禁用 SSL

禁用 SSL 证书验证。

MC_INSECURE

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

限制下载带宽

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

MC_LIMIT_DOWNLOAD

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

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

将客户端下载速率限制为不超过以 KiB/s、MiB/s 或 GiB/s 为单位的指定速率。这仅影响从运行 MinIO 客户端的本地设备进行的下载。有效单位包括

  • B 表示字节

  • K 表示千字节

  • M 表示兆字节

  • G 表示吉字节

  • Ki 表示千位字节

  • Mi 表示兆位字节

  • Gi 表示吉位字节

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

export MC_LIMIT_DOWNLOAD=1G

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

限制上传带宽

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

MC_LIMIT_UPLOAD

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

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

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

  • B 表示字节

  • K 表示千字节

  • M 表示兆字节

  • G 表示吉字节

  • Ki 表示千位字节

  • Mi 表示兆位字节

  • Gi 表示吉位字节

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

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 中设置的加密密钥匹配。

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