record_path

Директива 'record_path' указывает путь к директории, куда сохраняются записанные потоки при использовании модуля NGINX RTMP.

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

Описание

Директива 'record_path' в модуле NGINX RTMP используется для указания конкретной директории, в которой во время записи сохраняются видеопотоки. Она важна для приложений, использующих возможности прямой трансляции, поскольку позволяет управлять записанным контентом. Когда поток публикуется, все данные этого потока захватываются и записываются в указанный путь. Этот путь должен быть доступен пользователю NGINX и иметь соответствующие права для записи файлов.

При настройке 'record_path' убедитесь, что указан корректный путь к директории. Путь может быть абсолютным или относительным относительно рабочей директории NGINX. Если указанная директория не существует или возникают проблемы с правами доступа, записи не будут созданы, что может привести к прерыванию сервиса или потере данных. Также важно управлять свободным местом на диске, учитывая, что размер записанных потоков может быстро расти в зависимости от продолжительности трансляции и bitrate.

Помимо указания пути хранения, пользователи могут комбинировать 'record_path' с другими директивами для большего контроля над процессом записи, такими как 'record_max_size', которая ограничивает размер записываемых файлов, или 'record_unique', которая обеспечивает уникальность имён файлов записанных потоков на основе временных меток. Это помогает эффективно организовывать записанный контент и избегать перезаписи файлов.

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

rtmp {
    server {
        listen 1935;
        application live {
            live on;
            record all;
            record_path /var/rtmp/recordings;
            record_max_size 1G;
            record_unique on;
        }
    }
}
⚠

Убедитесь, что указанный путь доступен для записи пользователем NGINX, чтобы предотвратить ошибки permission denied.

⚠

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

⚠

Если свободное место на диске не контролируется, сохраняемые файлы могут заполнить диск, что приведёт к сбою NGINX или его неотзывчивости.

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