Silo 客户端设置

本页面介绍 MinIO Client 的设置。

你可以通过以下方式建立或修改设置：

• 在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。 如何定义环境变量，请参考所用操作系统的文档。
• 使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

有些设置只有环境变量或配置项中的一种，而不是两者同时存在。

设置

主机凭证

使用此设置可为 mc 命令添加一个临时别名。 例如，可用于脚本场景。

该临时别名使用 AWS s3v4 signature。

示例

静态凭证

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 服务

使用此设置可添加一个用于 mc 命令的 STS endpoint。

支持按 alias 添加多个环境变量。

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

Web Token Identity

使用此设置可添加一个用于 mc 命令的 Web Token Identity。

支持按 alias 添加多个环境变量。

export MC_WEB_IDENTITY_TOKEN_FILE_myalias=/var/run/secrets/kubernetes.io/serviceaccount/token

配置目录

指定 MinIO Client 应使用的配置目录路径。在 pgsty/mc 容器镜像（20261109+）中，/.mc 目录预创建为 1777 权限，支持任意非 root UID 初始化配置。

S3 区域（Region）覆盖

可通过环境变量固定 S3 签名区域，并覆盖 config.json 中别名的 region。固定区域会跳过 SDK 的桶区域发现；详见 Alias 区域设计。

生效优先级：MC_REGION > AWS_REGION > config.json 中别名的 region 字段 > SDK 自动发现区域。S3 客户端缓存键包含实际生效的 region，切换 MC_REGION 或 AWS_REGION 时不会复用旧区域的签名客户端。

export MC_REGION=ap-southeast-1

进度条

禁用 MinIO Client 进度条。

Pager

在 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 对对象进行加密和解密。

SSE-S3 加密

请求使用服务端管理密钥的 SSE-S3 加密。