html_sanitize_hash_max_size
定义用于存储已清理 HTML 元素的哈希表的最大大小。
NGINX module to sanitize HTML 5 with whitelisted elements, attributes and CSS
·
location
语法html_sanitize_hash_max_size size;
默认值none
上下文location
参数flag
说明
指令 html_sanitize_hash_max_size 配置 NGINX 中 HTML 清理模块使用的哈希表的最大大小。该指令在处理 HTML 内容清理时对控制内存消耗特别有用。通过设置该指令，用户可以限制在清理过程中可存储于哈希表中的唯一元素和属性数量，从而优化资源使用。
当唯一元素或属性的数量超过指定大小时，较旧的条目可能会被丢弃。这可能导致在清理过程中需要重新评估先前遇到的元素或属性的情况。因此，基于预期的工作负载和内容复杂度设置合适的值非常重要。该指令以一个标志（flag）作为其参数，该标志必须表示哈希表中条目的最大数量。
本质上，该指令在请求处理阶段对平衡性能与资源管理起着关键作用，尤其是在处理可能较大或复杂的 HTML 内容结构时。
配置示例
location /sanitize {
html_sanitize on;
html_sanitize_hash_max_size 1024;
}⚠
将此值设置得过低可能会导致在重新计算哈希条目时处理时间增加。
⚠
如果在没有足够资源的情况下将 html_sanitize_hash_max_size 设置为非常大的值，可能会导致内存使用量增加。