Custom Variables & Drop-ins

Пользовательские переменные (drop-ins)¶

Некоторые сторонние модули NGINX определяют дополнительные переменные (например, $brotli_ratio). По умолчанию Gixy предупреждает, когда не может разрешить переменную. Можно обучить Gixy дополнительным переменным через простые drop-in файлы.

Включение¶

Укажите один или несколько каталогов с определениями переменных через CLI или конфигурационный файл:

CLI: --vars-dirs /etc/gixy/vars,~/.config/gixy/vars
gixy.cfg: vars-dirs = [/etc/gixy/vars, ~/.config/gixy/vars]

Все файлы с расширениями .cfg или .conf в этих каталогах будут прочитаны.

Формат файла¶

Каждая непустая и некомментная строка определяет одну переменную в виде name value. Поддерживаются значения:

Кавычки: '...' или "..." → литерал (не пользовательский ввод)
Регулярное выражение: r'...' или r"..." → шаблон допустимого содержимого
none/null (без учёта регистра) → помечает значение как не контролируемое пользователем
Допускается завершающая запятая после значения

Примеры:

# /etc/gixy/vars/nginx-module-brotli.cfg
brotli_ratio none

# /etc/gixy/vars/nginx-module-foo.cfg
foo_host "example.com"
foo_uri  r'/[^\s]*',

Поддерживаются префиксные переменные: имена, оканчивающиеся на _ (как у встроенных), например http_ сопоставит $http_foo.

Примечания¶

При совпадении имён, drop-in переменные перекрывают встроенные;
Создаются только переменные, к которым был обращён анализ;
Механизм влияет только на разрешение переменных и не меняет поведение NGINX.