MinIO 客户端设置
本页面介绍 MinIO Client 的设置。
你可以通过以下方式建立或修改设置:
在启动或重启 MinIO Server 之前,在宿主机系统上定义 环境变量。 如何定义环境变量,请参考所用操作系统的文档。
使用
mc admin config set定义 配置项。
如果同时定义了环境变量和对应的配置项,MinIO 使用环境变量的值。
有些设置只有环境变量或配置项中的一种,而不是两者同时存在。
设置
主机凭证
使用此设置可为 mc 命令添加一个临时别名。 例如,可用于脚本场景。
该临时别名使用 AWS s3v4 signature。
此设置没有对应的配置项。
使用 mc alias set 配置 alias。
示例
静态凭证
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) 凭证
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 服务
New in version mc: RELEASE.2023-11-06T04-19-23Z
使用此设置可添加一个用于 mc 命令的 STS endpoint。
Changed in version mc: RELEASE.2023-12-02T02-03-28Z
支持按 alias 添加多个环境变量。
Web Token Identity
New in version mc: RELEASE.2023-11-06T04-19-23Z
使用此设置可添加一个用于 mc 命令的 Web Token Identity。
Changed in version mc: RELEASE.2023-12-02T02-03-28Z
支持按 alias 添加多个环境变量。
配置目录
指定 MinIO Client 应使用的配置目录路径。
进度条
禁用 MinIO Client 进度条。
Pager
New in version mc: RELEASE.2024-04-29T09-56-05Z
在 CLI 中禁用 MinIO Client 的分页器功能。
使用该设置后,输出将改为直接打印到原始 STDOUT。
颜色主题
禁用 MinIO Client 输出使用的颜色主题。
JSON
启用将输出格式化为 JSON lines。
调试
启用调试输出。
禁用 SSL
禁用 SSL 证书校验。
限制下载带宽
限制 MinIO Client 在某些命令中使用的下载带宽。
若未指定,MinIO Client 使用全部可用带宽。
将客户端侧下载速率限制为不超过指定值(KiB/s、MiB/s 或 GiB/s)。该设置仅影响运行 MinIO Client 的本地设备发起的下载。支持的单位包括:
B 表示 bytes
K 表示 kilobytes
M 表示 megabytes
G 表示 gigabytes
Ki 表示 kibibytes
Mi 表示 mibibytes
Gi 表示 gibibytes
例如,要将下载速率限制为不超过 1 GiB/s,可在 Linux 系统上使用以下命令:
export MC_LIMIT_DOWNLOAD=1G
在非 Linux 系统上,请参考你的操作系统文档使用等效命令。
限制上传带宽
限制 MinIO Client 在某些命令中使用的上传带宽。
若未指定,MinIO Client 使用全部可用带宽。
将客户端侧上传速率限制为不超过指定值(KiB/s、MiB/s 或 GiB/s)。该设置仅影响运行 MinIO Client 的本地设备发起的上传。支持的单位包括:
B 表示 bytes
K 表示 kilobytes
M 表示 megabytes
G 表示 gigabytes
Ki 表示 kibibytes
Mi 表示 mibibytes
Gi 表示 gibibytes
例如,要将上传速率限制为不超过 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中设置的加密密钥匹配。
此设置没有对应的配置项。