play_local_path

Директива 'play_local_path' задаёт путь в локальной файловой системе для воспроизведения медиа в модуле NGINX RTMP.

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

Описание

Директива 'play_local_path' в модуле NGINX RTMP позволяет задать конкретный путь в локальной файловой системе, где хранятся MP4-файлы и откуда они могут обслуживаться для воспроизведения. При потоковой передаче через RTMP сервер может извлекать и отдавать файлы из указанной директории, что делает эту настройку ключевой для приложений с воспроизведением по запросу.

Эта директива принимает один аргумент — корректный файловый путь. Путь может указывать на каталог, где расположены медиафайлы (например, MP4-файлы). Если поступает запрос на воспроизведение потока, сервер NGINX будет искать в этой директории соответствующий файл для отправки клиентам. Использование этой возможности даёт более тонкий контроль над видеоресурсами и позволяет реализовать структурированные схемы воспроизведения, например, обслуживание заранее записанного контента.

С точки зрения поведения, если указанный путь не существует или возникают проблемы с правами доступа, запросы на воспроизведение будут завершаться ошибкой. Поэтому важно убедиться как в существовании пути, так и в том, что пользователь NGINX имеет соответствующие права на чтение. Это требование добавляет уровень административной ответственности при управлении путями к медиафайлам в среде, работающей на основе RTMP.

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

application playlocal {
    play_local_path /var/www/media;
    live on;
}
⚠

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

⚠

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

⚠

Избегайте использования путей со пробелами или специальными символами, поскольку это может привести к неверной интерпретации сервером.

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