文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

阈值和限制

本页面反映了适用于 MinIO 的限制和阈值。

参考硬件软件有关建议和要求。

S3 API 限制

项目

规格说明

最大对象大小

50 TiB

最小对象大小

0 B

每次 PUT 操作的最大对象大小

5 TiB 用于非分段上传
50 TiB 用于分段上传

每次上传的最大分块数量

10,000

零件尺寸范围

5 MiB 到 5 GiB。最后一部分可以是 0 B 到 5 GiB

每个列表部件请求返回的最大部件数量

10,000

每次列表对象请求返回的最大对象数量

1,000

每个列表分段上传请求返回的最大分段上传数量

1,000

存储桶名称的最大长度

63

对象名称的最大长度

1024

每条的最大长度/对象名称的分离段

255

单个对象的对象版本最大数量

10000 (可配置)

Erasure Code Limits

项目

规格说明

每个集群的最大服务器数量

没有限制

最低服务器数量

1

当服务器数量为1时,每台服务器的最小驱动器数量

1 (对于SNSD部署(不提供额外的可靠性或可用性)

当服务器数量为2个或更多时,每台服务器的最小驱动器数量

1

每台服务器最大驱动器数量

没有限制

读取仲裁

\(N/2\)

写入仲裁

\((N/2)+1\)

对象名称限制

文件系统和操作系统限制

MinIO中的对象名称主要受本地操作系统和文件系统的限制。 Windows和其他一些操作系统会限制文件系统使用某些特殊字符,例如^, *, |, \, /, &, ";.

此列表并非详尽无遗,且可能不适用于您的操作系统和文件系统组合。

在类Unix操作系统中,具有路径名的对象., ../返回一个错误file access denied.

请咨询您的操作系统供应商或查阅文件系统文档,以获取适用于您具体情况的完整列表。

MinIO 建议在生产环境中使用基于 XFS 文件系统的 Linux 操作系统。

冲突对象

应用程序必须为所有对象分配不冲突的唯一键。 这包括避免创建名称可能与父对象或同级对象冲突的对象。 MinIO会在冲突位置对LIST操作返回空集合。

例如,以下操作会导致命名空间冲突

PUT data/invoices/2024/january/vendors.csv
PUT data/invoices/2024/january <- collides with existing object prefix
PUT data/invoices/2024/january
PUT data/invoices/2024/january/vendors.csv <- collides with existing object

虽然您可以对这些对象执行 GET 或 HEAD 操作,但名称冲突会导致 LIST 操作返回空结果集/invoices/2024/januarypath.