proxy_headers_hash_max_size

定义用于存储代理头的哈希表的最大大小。 — NGINX HTTP Core

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

说明

`proxy_headers_hash_max_size` 指令在 NGINX HTTP 服务器中用于在使用 `proxy_set_header` 指令时设置用于存储 HTTP 头键的哈希表的最大大小。这在 NGINX 作为反向代理运行时尤为重要,因为它有助于将入站头映射到相应的后端服务器头。 该指令的参数是一个数字,用于确定可创建的哈希条目数量。在可能设置或修改大量不同头的场景中,增大此值可以帮助防止哈希表冲突并提高性能。必须在两者之间取得平衡——将此值设置得过高会导致内存消耗增加,而设置得过低则可能导致哈希冲突,从而在检索头时引发问题。 该指令可在 `http`、`server` 和 `location` 上下文中使用,允许在 NGINX 层级的不同级别进行灵活配置。正确配置后,它可增强 NGINX 在管理代理头方面的能力,特别是在存在大量不同头类型且负载较高的情况下。

配置示例

proxy_headers_hash_max_size 1024;

将 `proxy_headers_hash_max_size` 设置得过低可能导致由于哈希冲突而造成性能下降。

增大该值可能会导致更高的内存使用,因此在扩展之前请考虑服务器的可用资源。