zstd_static

Директива `zstd_static` позволяет отдавать заранее сжатые статические файлы с использованием сжатия Zstandard в NGINX.

Синтаксис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 имел к ним доступ.

← Ко всем директивам