html_sanitize_hash_bucket_size
`html_sanitize_hash_bucket_size` 指令设置 NGINX HTML Sanitization 模块中用于 HTML 清理的哈希桶大小。
NGINX module to sanitize HTML 5 with whitelisted elements, attributes and CSS
·
location
语法html_sanitize_hash_bucket_size size;
默认值32;
上下文location
参数flag
说明
html_sanitize_hash_bucket_size 指令是一个配置参数，会影响用于清理 HTML 内容的 NGINX 模块的行为。该模块使用哈希表来高效存储和检索通过清理允许的白名单元素、属性和 CSS 属性。通过调整此指令的值，用户可以控制哈希桶的大小，这会直接影响 HTML 清理过程的性能和内存使用。
桶是哈希表中用于处理冲突的结构，当多个元素哈希到相同索引时便会发生冲突。合适的大小可以使条目在桶中得到最佳分布，减少冲突的可能性并保持快速访问时间。将此值设置得过低可能导致冲突增加和性能下降，而设置得过高又可能浪费内存。选择合适的 html_sanitize_hash_bucket_size 取决于 NGINX 服务器预计要处理的 HTML 属性和元素的种类与数量。
配置示例
location /sanitize {
html_sanitize on;
html_sanitize_hash_bucket_size 64;
}⚠
将 bucket size 设置得过低可能会由于 hash collisions 而导致性能问题。
⚠
确保 bucket size 与预期需要被清理的唯一元素和属性的数量相匹配。