record_suffix

Директива `record_suffix` в NGINX RTMP-модуле задаёт суффикс, который добавляется к записанным видеофайлам на основе текущей метки времени.

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

Описание

Директива record_suffix используется в контексте NGINX RTMP-модуля, в частности при записи потоков. Когда поток публикуется, эта директива позволяет задать суффикс, который будет добавлен к именам записанных файлов. Эта возможность особенно полезна для различения нескольких записей одного и того же потока — она позволяет избежать конфликтов имён файлов за счёт добавления уникальных меток времени или идентификаторов.

Директива принимает один строковый аргумент, который служит суффиксом для записываемых файлов. NGINX RTMP-модуль использует этот суффикс в процессе записи; следовательно, записанные файлы будут именоваться в формате <stream-name>_<timestamp><record_suffix>.flv. Благодаря этой функциональности пользователи могут эффективно управлять записанными потоками, особенно в сценариях, где ожидается несколько записей из разных сессий или экземпляров трансляции.

Например, если поток опубликован в определённое время и record_suffix установлен в _v1, итоговый записанный файл может называться liveStream_1634920810_v1.flv. Это помогает при идентификации и сортировке записанных медиафайлов, особенно в продукционной среде с множеством одновременных трансляций.

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

application my_app {
    live on;
    record all;
    record_suffix _%Y%m%d_%H%M%S;
    record_path /var/www/html/records;
}

Убедитесь, что суффикс имеет допустимый формат; недопустимые символы могут привести к непредсказуемым именам файлов.

Если record_unique включен, суффикс может работать не так, как задумано из‑за переопределения имен файлов.

Записи будут перезаписывать существующие файлы с тем же именем, если не используются уникальные идентификаторы. Пожалуйста, будьте осторожны с перезаписью.

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