核心设置
本页涵盖了控制 MinIO 进程核心行为的设置。
您可以通过定义以下内容来建立或修改设置：
an 环境变量在启动或重启 MinIO 服务器之前，请在主机系统上设置此环境变量。 有关如何定义环境变量，请参阅操作系统的文档。
a 配置设置使用
mc admin config set.
如果您同时定义了环境变量和类似的配置设置，MinIO 将使用环境变量的值。
某些设置只有环境变量或配置设置，但没有两者都提供。
重要
每个配置设置控制着 MinIO 的基本行为和功能。 MinIO强烈建议在应用到生产环境之前，先在较低环境（如开发环境或测试环境）中测试配置变更。
MinIO Server CLI 选项
可选
设置一个字符串参数在启动 MinIO 服务器时使用。
对于使用推荐的 MinIO 的类 Unix 系统systemd服务，请使用/etc/default/minio文件并创建一个环境变量MINIO_OPTS用于指定要附加到的参数miniosystemd 进程：
# Editing /etc/default/minio
MINIO_OPTS=' --console-address=":9001" --ftp="address=:8021" --ftp="passive-port-range=30000-40000" '
对于运行中的系统minio在命令行上，MINIO_OPTS是可选的。
要使用它，请使用标准 shell 语义声明环境变量，然后在启动 MinIO 服务器时引用该环境变量：
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"
重要
Theminio server命令无法读取$MINIO_OPTS直接地。
该变量只有在按照上述方式使用时才起作用。
存储卷
- MINIO_VOLUMES
目录或驱动器
minio server进程使用作为存储后端。功能上等同于设置
minio server DIRECTORIES在通过环境文件配置 MinIO 运行时使用此值。
此设置没有配置设置选项。
环境变量文件路径
- MINIO_CONFIG_ENV_FILE
指定 MinIO 服务器进程用于加载环境变量的文件的完整路径。
对于
systemdmanaged files, set this value to the path of the environment file (/etc/default/minio) 以在使用时指示 MinIO 重新加载对该文件的更改mc admin service restart重新启动部署。
此设置没有配置设置选项。
过期工作人员
域
此设置没有配置设置选项。
扫描仪速度
管理最大等待时间扫描仪在平衡 MinIO 读写性能与扫描器进程时。
MinIO 利用扫描仪for存储桶复制, 站点复制, 生命周期管理和愈合任务。
有效值包括：
|
移除扫描器在读写延迟上的等待，使扫描器能够以全速运行并消耗IOPS。 此设置可能导致读写性能下降。 |
|---|---|
|
设置较短的读写延迟扫描器等待时间，允许扫描器以更高的速度和IOPS消耗运行。 此设置可能导致读写性能下降。 |
|
设置适度的扫描器读写延迟等待时间，使扫描器能以平衡的速度和IOPS消耗运行。 该设置旨在维持读写性能的同时，允许扫描器持续进行活动。 |
|
设置中等扫描器在读写延迟上的等待时间，此时扫描器将以降低的速度和IOPS消耗运行。 该设置可在降低扫描器性能的同时，提供更好的读写性能。 可能会影响依赖于扫描仪的功能，例如生命周期管理和复制。 |
|
设置较大的扫描器读写延迟等待时间，使扫描器以显著较低的速度和IOPS消耗运行。 此设置优先保障读写操作，可能以牺牲扫描器操作为代价。 可能会影响依赖于扫描仪的功能，例如生命周期管理和复制。 |
批量复制
此设置没有配置设置选项。
数据压缩
以下部分记录了为对象启用数据压缩的设置。 参见数据压缩有关使用这些配置设置的教程。
此部分中的所有设置都属于以下顶级键：
启用压缩
可选
设置为on对新对象启用数据压缩。
默认为off.
启用或禁用数据压缩不会更改现有对象。
允许加密
可选
设置为on在压缩对象后进行加密。
默认为off.
加密压缩对象可能会影响安全性
MinIO 强烈建议不要对压缩对象进行加密。 如果您需要加密，请仔细评估可能泄露加密对象内容信息的风险。
压缩扩展
可选
要压缩的文件扩展名的逗号分隔列表。
设置新的文件扩展名列表将替换先前配置的列表。
默认值为".txt, .log, .csv, .json, .tar, .xml, .bin".
Changed in version RELEASE.2024-03-15T01-07-19Z:指定"*"将 MinIO 配置为压缩所有支持的文件类型。
MinIO 不支持对文件类型进行压缩排除的文件类型列表，即使在此参数中明确指定。
压缩 MIME 类型
可选
要压缩的 MIME 类型逗号分隔列表。
设置新的类型列表将替换先前配置的列表。
默认值为"text/*, application/json, application/xml, binary/octet-stream".
默认排除的文件
某些类型的文件无法显著减小大小。
MinIO会不压缩这些，即使指定在mime_typesargument.
请参阅排除的类型详情请参阅。
Erasure Stripe Size
可选
如果你设置了这个值，必须这样做之前您初始化集群 选定的条带大小为不可变的在集群初始化之后，此设置将生效，并影响后续添加到集群的任何服务器池。
MinIO SUBNET用户应登录并创建一个议题来讨论条带大小设置，然后再在任何环境中实施这些设置。
警告
不要除非 MinIO 工程团队指示，否则请勿更改条带大小设置。
更改条带大小会对部署功能、可用性、性能和行为产生重大影响。 MinIO的条带选择算法为大多数工作负载设置了适当的默认值。 从这个默认值更改条带大小是不常见的，通常没有必要也不建议这样做。
Maximum Object Versions
可选
定义每个对象允许的默认最大版本数。
默认情况下，MinIO 允许每个对象最多保留 Int64 最大值的版本数量，即超过 92 亿亿个版本。
Note
MinIO versions fromRELEASE.2023-08-04T17-40-21Z``to ``RELEASE.2024-03-26T22-10-45Z默认限制为 10,000 个对象版本。
此设置可用于将该限制覆盖为其他值。
每个对象的高版本号可能会导致某些操作性能下降，例如LIST在运行预算硬件或旋转驱动器（HDD）的系统上尤其如此。
每个对象产生数千或更多版本的应用程序或工作负载可能需要设计或架构审查，以减轻潜在的性能下降。
设置一个不超过100应该为大多数典型用例提供足够的版本。
评论
此设置没有环境变量选项。 请改用配置设置。
可选
指定与数据压缩配置关联的注释。