zstd_dict_file

Директива `zstd_dict_file` указывает внешний файл словаря, который будет использоваться для сжатия Zstandard.

Синтаксис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.

Подтвердите, что и клиент, и сервер настроены на использование одного и того же словаря, чтобы избежать проблем совместимости.

Проверьте влияние на производительность при использовании внешних словарей, так как они могут добавить накладные расходы в зависимости от размера и скорости доступа.

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