vod_fallback_upstream_location

Директива `vod_fallback_upstream_location` указывает upstream-локацию, к которой следует обращаться в случае, если запрошенный видеофайл не найден.

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

Описание

Директива vod_fallback_upstream_location является важной функцией модуля NGINX VOD Packager: она позволяет разработчикам задать механизм резервного обращения для видеозапросов, которые не могут быть обслужены из основного источника (например, локальных или сопоставленных файлов). Если запрос видео не удаётся выполнить из‑за отсутствия запрошенного файла, NGINX перенаправит запрос на указанную резервную upstream-локацию. Это особенно полезно в средах с несколькими дата-центрами или распределёнными файловыми системами, поскольку обеспечивает доступность контента и бесшовную доставку конечным пользователям.

Директива принимает один аргумент — URI резервной upstream-локации. Этот URI должен указывать на действующий upstream block или server, способный обрабатывать видеозапросы. Следует учитывать, что директива применяется только при определённых условиях, например при отсутствии запрошенного медиафайла, что предотвращает ненужную нагрузку от попыток доступа к изначально недоступным ресурсам. Кроме того, при обращении к резервной локации она должна соответствовать тем же требованиям к доступу и кодированию, что и основной источник, чтобы обеспечить совместимость форматов воспроизведения.

В конфигурируемых контекстах HTTP, server или location директива может размещаться стратегически в соответствии с потребностями развертывания, что даёт большую гибкость в обработке медиа-контента. Правильная реализация может улучшить пользовательский опыт, снижая простои из‑за недоступных файлов и обеспечивая непрерывную доставку контента.

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

location /vod {
    vod_fallback_upstream_location http://backup-server/vod;
    # other VOD-related configurations here
}

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

Использование этой директивы без надлежащего тестирования может привести к непредвиденному поведению в рабочих средах.

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

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