zstd_dict_file
`zstd_dict_file` 指令指定用于 Zstandard 压缩的外部字典文件。
NGINX module for the Zstandard compression
·
http
语法zstd_dict_file /path/to/dict;
默认值none
上下文http
参数1
说明
zstd_dict_file 指令在 NGINX 配置中用于指定一个外部字典文件，Zstandard 压缩算法在压缩响应时将使用该文件。该文件可以显著提高压缩率，尤其对于重复性内容，通过让 Zstandard 算法引用常见模式来提升效率。为该指令提供的路径必须准确指向运行 NGINX 的服务器上的有效字典文件。
需要注意的是，使用外部字典需要在客户端和服务器之间小心处理。连接双方必须了解并同意使用相同的字典，因为 HTTP 协议并没有为此提供内置的协商或同步机制。用户必须确保客户端明确支持并使用指定的字典，可能通过适当的 HTTP 头或事先约定实现。这个限制强调了在配置带字典的 Zstandard 压缩时兼容性的重要性。
还应注意使用外部字典对性能的影响，因为加载和管理该文件如果处理不当可能带来开销。在高性能场景中，建议对字典使用对响应时间和资源利用的影响进行基准测试。
配置示例
http {
zstd_dict_file /etc/nginx/zstd-dict;
server {
listen 80;
server_name example.com;
location / {
zstd on;
zstd_min_length 256;
zstd_comp_level 3;
proxy_pass http://backend;
}
}
}⚠
确保字典文件对 NGINX 工作进程可访问且可读。
⚠
确认客户端和服务器都配置为使用相同的字典，以避免兼容性问题。
⚠
在使用外部字典时检查性能影响，因为它们可能会根据大小和访问速度增加开销。