types_hash_max_size

设置 NGINX 中用于 MIME 类型处理的哈希表的最大大小。 — NGINX HTTP Core

types_hash_max_size
httpserverlocation
语法types_hash_max_size size;
默认值512
上下文http, server, location
模块NGINX HTTP Core
参数1

说明

`types_hash_max_size` 指令控制 NGINX 用来存储 MIME 类型的哈希表的最大大小。它指定哈希表可容纳的最大条目数,从而高效地将文件扩展名映射到相应的 MIME 类型。当为该指令设置值时,NGINX 会分配足够的内存以适应指定的大小,从而增强其在不降低性能的情况下处理大量文件类型的能力。 传递给 `types_hash_max_size` 的参数通常是正整数。如果哈希表大小被超出,NGINX 将退回到使用较低效的存储方式。根据预期的 MIME 类型数量适当调整此值,能显著提升服务器对特定内容类型文件请求的响应性能。注意此指令在 `http`、`server` 和 `location` 等上下文中是相关的。对于服务多种文件类型的部署来说,这一点尤为关键,可确保映射过程的最佳性能。 设置时应注意避免将值设得过高,因为这会导致不必要的内存使用增加。相反,设置过低可能引起性能瓶颈。因此,建议监控应用并根据观察到的需求调整此指令。

配置示例

http {
    types_hash_max_size 2048;
}

将该值设置得过低可能由于哈希冲突导致性能瓶颈。

将该值设置得过高会不必要地增加内存使用。