zstd_static
指令 `zstd_static` 使得在 NGINX 中可以使用 Zstandard 压缩提供预压缩的静态文件。
NGINX module for the Zstandard compression
·
httpserverlocation
语法zstd_static on | off;
默认值off
上下文http, server, location
参数1
说明
zstd_static 指令允许你提供使用 Zstandard (zstd) 算法预先压缩的静态文件。启用后,NGINX 会直接提供这些静态文件而不重新压缩,从而优化性能并在请求处理过程中减少 CPU 使用率。对于提供大型静态资产(例如图像、JavaScript 或 CSS 文件)尤其有益。当对静态文件发起请求时,NGINX 会检查该文件是否存在压缩版本,如果可用则提供该版本。
要有效使用 zstd_static 指令,必须使用 Zstandard 算法对静态文件进行预压缩并将其存放在指定目录中。该指令可在 http、server 或 location 上下文中使用,使其对各种 NGINX 配置都具有灵活性。重要的是要确保客户端能够处理 Zstandard 压缩的内容,因为媒体类型需要正确协商才能利用此功能。如果未做到这一点,可能导致客户端无法接收到预期的压缩内容。
配置示例
server {
listen 127.0.0.1:8080;
server_name localhost;
location / {
zstd_static on;
root /path/to/static/files;
}
}⚠
确保在提供之前,静态文件已使用 Zstandard 预压缩。
⚠
确认客户端能够处理使用 Zstandard 压缩的文件,以避免兼容性问题。
⚠
确保已在压缩文件上设置正确的文件权限,以便 NGINX 可以访问它们。