alias

Описание

Директива 'alias' используется внутри контекста location, чтобы указать альтернативный путь в локальной файловой системе, к которому должна отображаться URI. Например, когда приходит запрос к URI, который соответствует указанному блоку location, NGINX использует значение 'alias' для дальнейшей обработки и извлечения файлов вместо поведения по умолчанию. Это позволяет гибко настраивать расположение статических файлов, сохраняя при этом осмысленные URL в запросах клиентов. Директива 'alias' принимает один аргумент — путь к каталогу или файлу, который должен быть возвращён в ответ на соответствующие запросы. Важно отметить, что при использовании 'alias' совпадающая часть URI заменяется путём из alias. Это отличается от директивы 'root', при которой request URI добавляется к пути, указанному в 'root'. Поэтому при настройке 'alias' следует проявлять осторожность, чтобы гарантировать корректное сопоставление структуры URI с соответствующей структурой файловой системы. Один распространённый вариант использования 'alias' — обслуживание изображений или статических файлов из каталога, который не следует структуре document root. Например, если у вас изображения хранятся в '/var/www/images', но вы хотите обслуживать их по URI '/images', вы можете использовать директиву 'alias' для реализации такого сопоставления без изменения структуры файловой системы бэкенда.

Пример конфига

location /images {
    alias /var/www/images/;
}