核心设置

本页介绍用于控制 MinIO 进程核心行为的设置。

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

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

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

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

MinIO Server CLI 选项

MINIO_OPTS

envvar

此变量没有对应的配置项，因为这些设置在服务器启动时生效。

可选

设置一个 参数 字符串，在启动 MinIO Server 时使用。

对于采用推荐 MinIO systemd 服务的类 Unix 系统，请使用 /etc/default/minio 文件并创建环境变量 MINIO_OPTS，用于指定要附加到 minio systemd 进程的参数：

# Editing /etc/default/minio

MINIO_OPTS=' --console-address=":9001" --ftp="address=:8021" --ftp="passive-port-range=30000-40000" '

对于在命令行运行 minio 的系统，MINIO_OPTS 是可选项。 如需使用，请按标准 shell 语义声明该环境变量，然后在启动 MinIO Server 时引用该环境变量：

export MINIO_OPTS=' --console-address=":9001" --ftp="address=:8021" --ftp="passive-port-range=30000-40000" '

minio server $MINIO_OPTS ...

# The above is equivalent to running the following:
# minio server --console-address=":9001" \
#              --ftp="address=:8021"     \
#              --ftp="passive-port-range=30000-40000"

存储卷

MINIO_VOLUMES

envvar

minio server 进程用作存储后端的目录或磁盘。

在功能上等价于设置 minio server DIRECTORIES。 在通过环境文件配置 MinIO 运行时使用此值。

此设置没有对应的配置项。

环境变量文件路径

MINIO_CONFIG_ENV_FILE

envvar

指定 MinIO server 进程用于加载环境变量的文件完整路径。

对于由 systemd 管理的文件，将该值设置为环境文件路径（/etc/default/minio），以便在使用 mc admin service restart 重启部署时，指示 MinIO 重新加载该文件中的变更。

此设置没有对应的配置项。

过期处理工作线程

MINIO_ILM_EXPIRY_WORKERS

envvar

指定用于处理按 ILM 过期规则配置对象过期任务的工作线程数。 未设置时，MinIO 默认最多使用可用处理器核心数的一半。

此设置没有对应的配置项。

域名

MINIO_DOMAIN

envvar

为 MinIO 部署启用 Virtual Host 风格请求。 将该值设置为完全限定域名（FQDN），使 MinIO 能够接受传入的虚拟主机请求。

省略此设置时，MinIO 仅接受默认的 path-style 请求。

例如，某个 MinIO 部署分配的 FQDN 为 minio.example.net。

  • 使用 path-style 访问时，应用可通过完整路径 minio.example.net/mybucket 访问存储桶。
  • 使用 virtual-host 访问时，应用可通过虚拟主机 mybucket.minio.example.net/ 访问存储桶。

此设置没有对应的配置项。

扫描器速度

MINIO_SCANNER_SPEED

envvar

scanner speed

mc-conf

用于在平衡 MinIO 读写性能与扫描进程时，管理 scanner 的最大等待周期。

MinIO 使用 scanner 执行 存储桶复制、 站点复制、 生命周期管理 和 自愈 任务。

有效值包括：

fastest

移除扫描器在读/写延迟上的等待时间，使扫描器以最高速度和 IOPS 消耗运行。 此设置可能导致读取和写入性能下降。

fast

将扫描器在读/写延迟上的等待时间设置为较短， 使扫描器以更高速度和 IOPS 消耗运行。 此设置可能导致读取和写入性能下降。

default

将扫描器在读/写延迟上的等待时间设置为中等， 使扫描器以平衡的速度和 IOPS 消耗运行。 此设置旨在在保持读写性能的同时允许扫描器持续工作。

slow

将扫描器在读/写延迟上的等待时间设置为中等， 此时扫描器以较低速度和 IOPS 消耗运行。 该设置在降低扫描器性能的同时，可提供更好的读写性能。

可能影响依赖扫描器的功能，例如生命周期管理和复制。

slowest

将扫描器在读/写延迟上的等待时间设置为较长， 此时扫描器以显著更低的速度和 IOPS 消耗运行。 该设置优先保障读写操作，但可能以牺牲扫描器操作为代价。

可能影响依赖扫描器的功能，例如生命周期管理和复制。

批量复制

此设置没有对应的配置项。

数据压缩

以下部分记录用于为对象启用数据压缩的设置。 有关如何使用这些配置设置的教程，请参见 数据压缩。

本节中的所有设置都归属于以下顶层键：

compression

mc-conf

启用压缩

MINIO_COMPRESSION_ENABLE

envvar

compression enable

mc-conf

可选

设置为 on 以对新对象启用数据压缩。 默认为 off。

启用或禁用数据压缩不会更改现有对象。

允许加密

MINIO_COMPRESSION_ALLOW_ENCRYPTION

envvar

compression allow_encryption

mc-conf

可选

设置为 on 以在压缩后对对象进行加密。 默认为 off。

压缩扩展名

MINIO_COMPRESSION_EXTENSIONS

envvar

compression extensions

mc-conf

可选

要压缩的文件扩展名列表，以逗号分隔。 设置新的扩展名列表会替换先前已配置的列表。 默认为 ".txt, .log, .csv, .json, .tar, .xml, .bin"。

即使在此参数中显式指定，MinIO 也不支持压缩 Excluded File Types 列表中的文件类型。

压缩 MIME 类型

MINIO_COMPRESSION_MIME_TYPES

envvar

compression mime_types

mc-conf

可选

要压缩的 MIME 类型列表，以逗号分隔。 设置新的类型列表会替换先前已配置的列表。 默认为 "text/*, application/json, application/xml, binary/octet-stream"。

注释

此设置没有环境变量选项。 请改用配置项。

compression comment

envvar

可选

指定一个与数据压缩配置关联的注释。

纠删码条带大小

MINIO_ERASURE_SET_DRIVE_COUNT

envvar

此设置没有对应的配置项。

可选

应用于指定 服务器池 中所有驱动器的 erasure set size。

如果设置此值，你必须在初始化集群之前完成设置。 集群初始化后，所选条带大小为不可变，并会影响后续添加到集群中的所有 服务器池。

MinIO SUBNET 用户应先登录并提交 issue，讨论条带大小设置后再在任何环境中实施。

最大对象版本数

MINIO_API_OBJECT_MAX_VERSIONS

envvar

api object_max_versions

mc-conf

可选

定义每个对象允许的默认最大版本数。

默认情况下，MinIO 允许每个对象的版本数最高达到 Int64 的最大值，即超过 9.2 quintillion。

为对象设置任意高的版本数可能导致某些操作（如 LIST）性能下降。 在使用低成本硬件或机械硬盘（HDD）的系统上，这一点尤为明显。 对于每个对象会生成数千个或更多版本的应用或工作负载，可能需要进行设计或架构评审，以缓解潜在的性能下降。

将上限设置为不超过 100，通常可满足大多数常见使用场景。

最后修改 August 2, 2026: init commit (8338d5b)

本页部分内容改编自 MinIO 对象存储文档，© 2020–至今 MinIO, Inc.，依据 CC BY 4.0 授权，由 Silo 项目转换与维护。归属与署名

本页为非官方中文翻译。如与英文原文有出入，以英文原文为准。