Автоиндексация Nginx только с определённым аргументом URI?

Question 1

Это немного сложно описать. По сути, я хочу, чтобы nginx отвечал autoindex вместо установленного файла index.html, если в URI есть ?listing=true.

Я уже пытался добавить это внутрь моего location / {...}, чтобы не было видно никакого индекса:

if ($arg_listing = "true") {
    index =404;
    add_header Content-Type application/json;
    return 200;
}

Но это привело к тому, что служба nginx не запускается, потому что, видимо, нельзя использовать index или autoindex внутри блока if. Я знаю, что блок if работает, по крайней мере, потому что 200 возвращается, если я удаляю index.

У меня не так много опыта в использовании nginx, поэтому я не знаю, что делать. Вот полная конфигурация /etc/nginx/sites-enabled/default: https://pastebin.com/iRiMpCk9

Редактировать: Изменил ссылку на Pastebin, потому что раньше она была неправильной.

Question 2

На самом деле, директива if в nginx, когда используется в контексте location, имеет очень мало общего с аналогичными конструкциями из императивных языков программирования. Одно из лучших объяснений того, как эта директива действительно работает, предоставил Ичунь Чжан, автор известного lua-nginx-module и сборки OpenResty. Фактически, каждая директива if неявно создает вложенный location, который пытается унаследовать все объявления от родительского location. Однако, есть определенные ограничения на то, какие директивы могут использоваться в так называемом контексте “if в location” (если могут, это будет явно указано в документации), и вы только что столкнулись с одним из них (директива autoindex не может использоваться в этом контексте). Наиболее распространенным решением таких ситуаций является использование переменных в качестве аргументов для этих директив.

К сожалению, не все директивы nginx допускают использование переменных в качестве своих параметров (как правило, если это возможно, это явно указывается в документации для соответствующей директивы). В частности, директива autoindex не поддерживает указание своего параметра как переменной, значение которой могло бы быть либо on, либо off. Поэтому, действительно, решение с использованием двух отдельных именованных location с разной конфигурацией для этой директивы скорее всего единственно возможный вариант. Однако, как я уже сказал, вы не можете перейти в именованный location через директиву rewrite. Вместо этого вы можете сделать это через директиву try_files, как описано здесь:

map $arg_listing $autoindex {
    true     @autoindex_on;
    default  @autoindex_off;
}

server {
    ... listen, server_name, root и другие общие параметры блока "server" здесь

    location / {
        try_files "" $autoindex;
    }
    location @autoindex_on {
        autoindex on;
        autoindex_format json;
    }
    location @autoindex_off {
        return 403;
    }

    ... ваши другие location здесь
}

Но имейте в виду, что для того, чтобы директива autoindex вступила в силу, в запрашиваемом каталоге веб-сервера не должно быть файла индекса (index.html по умолчанию).

Question 3

Попробуйте это:

server {
    listen 80;
    server_name example.com;
    root /var/www/html;

    # Поведение по умолчанию: обслуживание файлов или index.html
    location / {
        try_files $uri $uri/ /index.html;
    }

    # Именованный location для autoindex
    location @listing {
        autoindex on;
        autoindex_exact_size off;  # Необязательно: делает размеры файлов удобочитаемыми
        autoindex_localtime on;   # Необязательно: отображает локальное время для файлов
    }

    # Переписывание на основе присутствия параметра запроса
    location / {
        if ($arg_listing = "true") {
            rewrite ^ /@listing last;
        }
        try_files $uri $uri/ /index.html;
    }
}

Автоиндексация Nginx только с определённым аргументом URI?

Вопрос или проблема

Ответ или решение

Теория

Пример

Применение

Заключение