exec_options

Директива exec_options в модуле NGINX RTMP задаёт параметры выполнения для событий живой трансляции и записи.

Синтаксисexec_options command;
По умолчаниюnone
Контекст
Аргументы1

Описание

Директива exec_options позволяет настраивать поведение выполнения при наступлении определённых действий потоковой передачи в настройке RTMP-приложения. Например, эта директива даёт пользователям возможность определить выполнение shell-команд в ответ на определённые события, такие как запуск или остановка сеансов трансляции. Такая функциональность облегчает интеграцию с внешними процессами, позволяя разработчикам автоматически вызывать скрипты или приложения на основе событий в реальном времени, что обеспечивает более динамичные решения для потоковой передачи.

При использовании директива exec_options обычно принимает один аргумент, который указывает команду для выполнения. Например, это может быть путь к shell-скрипту или конкретная командная строка, которая выполняется при наступлении определённого события RTMP. Команда может включать переменные, связанные с сеансом трансляции, которые передаются выполняемой программе, чтобы предоставить контекст о состоянии потока или метаданных.

Правильная работа директивы exec_options также требует тщательной обработки ошибок, так как проблемы в выполняемой команде могут повлиять на стабильность сервера потоковой передачи. Пользователям важно тщательно проверять свои команды и обеспечивать их выполнение без причинения сбоев в общей работе сервера RTMP. Эта возможность выполнения, привязанная к контексту, может значительно повысить гибкость и производительность сервера, делая её ценным инструментом для разработчиков и системных администраторов, работающих с медиа‑потоками.

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

application live {
    live on;
    exec_options /path/to/script.sh;
}

Убедитесь, что команда исполняема и имеет правильные права доступа.

Указанные пути должны быть абсолютными, чтобы избежать ошибок выполнения.

Проверьте скрипт отдельно, чтобы убедиться, что он работает как ожидается, перед интеграцией с NGINX.

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