混合云对象存储
裸机
纠删码计算器
参考硬件
核心设置
本页面介绍了控制MinIO进程核心行为的设置。
您可以通过定义以下内容来建立或修改设置：
在启动或重新启动 MinIO 服务器之前，在宿主系统上定义一个 环境变量。 请参阅您的操作系统的文档，了解如何定义环境变量。
使用
mc admin config set命令来设置一个 配置项。使用 MinIO控制台 的 管理员 > 设置 页面来设置一个 配置项。
如果您同时定义了环境变量和类似的配置设置，MinIO 将使用环境变量的值。
有些设置只有环境变量或配置设置，而不是两者都有。
重要
每个配置设置都控制着MinIO的基本行为和功能。 MinIO 强烈建议 在较低的环境中，如DEV或QA，测试配置更改，然后再将其应用到生产环境中。
MinIO 服务器 CLI 选项
可选
设置一个字符串，其中包含在启动MinIO服务器时要使用的 parameters。
对于使用推荐的 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 服务器时引用环境变量:
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 server 命令不会直接读取 $MINIO_OPTS`。 该变量只有在如上所述的情况下才能发挥作用。
存储卷
- MINIO_VOLUMES
minio server进程用作存储后端的目录或驱动器。这相当于设置了
minio server DIRECTORIES。 在配置MinIO以使用环境变量配置文件运行时，请使用此值。
这个设置没有配置选项。
环境变量文件路径
- MINIO_CONFIG_ENV_FILE
指定MinIO服务器进程用于加载环境变量的文件的全路径。
对于使用
systemd管理的文件，将此值设置为环境变量配置文件的路径（例如/etc/default/minio），以指示MinIO在使用mc admin service restart命令重新启动部署时重新加载该文件的变化。
这个设置没有配置选项。
Workers for Expiration
Domain
这个设置没有配置选项。
Scanner Speed
管理扫描器在平衡MinIO读/写性能到 扫描器 进程时等待的最大时间段。
MinIO 使用 扫描器（scanner） 进行：术语 桶复制、 站点复制、 生命周期管理 和 修复 任务。
有效值包括：
|
消除扫描器在读/写延迟上的等待，使扫描器能够以全速运行和消耗IOPS。 这个设置可能会导致读写性能下降。 |
|---|---|
|
设置较短的扫描器等待时间来应对读/写延迟，使得扫描器可以以更高的速度运行和消耗IOPS。 这个设置可能会导致读写性能下降。 |
|
设置适度的扫描器等待时间来应对读/写延迟，使得扫描器可以以平衡的速度运行和消耗IOPS。 此设置旨在保持读写性能，同时允许进行持续的扫描器活动。 |
|
设置适中的扫描器等待时间以应对读/写延迟，从而使扫描器以降低的速度和IOPS消耗运行。 此设置可以在降低扫描器性能的同时实现更好的读写性能。 可能会影响基于扫描器的功能，例如生命周期管理和复制。 |
|
此设置将在读/写延迟上设置较长的扫描器等待时间，使得扫描器以大幅降低的速度和IOPS消耗运行。 此设置将优先考虑读写操作，但可能会以牺牲扫描器操作为代价。 可能会影响基于扫描器的功能，例如生命周期管理和复制。 |
Batch Replication
这个设置没有配置选项。
Data Compression
以下部分记录了启用对象数据压缩的设置。 请参阅 数据压缩，了解使用这些配置设置的教程。
本节中的所有设置都属于以下顶级键：
Enable Compression
可选
将此设置为 on 以启用对新对象的数据压缩。
默认为 off 。
启用或禁用数据压缩不会改变现有对象。
Enable Compression
可选
将此设置设为 on 以在压缩对象后对其进行加密。
默认为 off 。
Encrypting compressed objects may compromise security
MinIO 强烈建议不要对已压缩的对象进行加密。 如果需要加密，请仔细评估潜在风险，可能会泄露关于加密对象内容的线索。
Compression Extensions
可选
以逗号分隔的文件扩展名列表，用于压缩。
设置新的文件扩展名列表将替换先前配置的列表。
默认为 .txt, .log, .csv, .json, .tar, .xml, .bin 。
在 RELEASE.2024-03-15T01-07-19Z 版本发生变更: 指定 * 以指示MinIO压缩所有支持的文件类型。
MinIO 不支持压缩在 Excluded File Types 列表中的文件类型，即使在此参数中明确指定也是如此。
Compression MIME Types
可选
以逗号分隔的MIME类型列表，用于压缩。
设置新的类型列表将替换先前配置的列表。
默认为 text/*, application/json, application/xml, binary/octet-stream 。
Default excluded files
一些文件类型无法显著减小大小。
MinIO将 不会 压缩这些文件，即使已在 mime_types 参数中指定了。
有关详细信息，请参阅 排除的类型。
擦除条带大小
可选
如果您设置了这个值，您 必须 在初始化集群之前这样做 选择的分条大小在集群初始化后是 不可变的，并影响将来添加到集群的任何服务器池。
MinIO SUBNET 用户应在在任何环境实施之前，登录并打开一个问题讨论条纹大小设置。
警告
不要 更改条纹大小设置，除非 MinIO 工程部门指示您这样做。
更改条纹大小对部署功能、可用性、性能和行为有重大影响。 MinIO 的条纹选择算法为大多数工作负载设置了合适的默认值。 从默认值更改条纹大小是不常见的，通常不是必要的，也不建议这样做。
最大对象版本
可选
定义每个对象允许的默认最大版本。
默认情况下，MinIO 允许每个对象最多使用 Int64 版本的最大值，即超过 9.2 万亿次。
备注
从 RELEASE.2023-08-04T17-40-21Z 到 RELEASE.2024-03-26T22-10-45Z 的 MinIO 版本默认限制为 10,000 个对象版本。
此设置可用于将该限制覆盖为另一个值。
每个对象的版本过高可能会导致某些操作（如 LIST ）的性能下降。
对于运行预算硬件或旋转硬盘(HDD)的系统来说，尤其如此。
对于每个对象会产生数千个或更多版本的应用或工作负载，可能需要对设计或架构进行审查，以减少潜在的性能下降。
设置不超过 100 的限制应能为大多数典型用例提供足够的版本。
商业支持购买咨询
Comments
此设置没有环境变量选项。 请使用配置设置 instead.
可选
指定一个注释，以与数据压缩配置相关联。