nchan_subscribe_existing_channels_only

Директива `nchan_subscribe_existing_channels_only` ограничивает подписчиков возможностью подключаться только к уже существующим каналам, предотвращая создание новых каналов при подписке.

Синтаксисnchan_subscribe_existing_channels_only on | off;
По умолчаниюoff
Контекстhttp, server, location
Аргументы1

Описание

Директива nchan_subscribe_existing_channels_only, при установленном значении on, гарантирует, что подписчики могут подключаться только к каналам, которые были ранее созданы и в данный момент активны в системе Nchan. Эта функциональность особенно полезна в сценариях, где ресурсы каналов должны строго контролироваться, предотвращая непреднамеренное создание новых каналов подписчиками. По умолчанию, если подписчик пытается подключиться к несуществующему каналу, Nchan может создать для него новый канал в обычных обстоятельствах; однако эта директива предотвращает такое поведение.

Установка этой директивы в off (значение по умолчанию) позволяет подписчикам динамически создавать новые каналы при подписке. Это может привести к множеству каналов, что не всегда желательно. Данная директива часто используется в средах со сложными требованиями к управлению каналами, обеспечивая, что только определённый набор каналов может использоваться подписчиками, что способствует лучшей предсказуемости и управлению ресурсами.

Для эффективного применения эту директиву можно включить в контексты http, server или location вашей конфигурации Nginx. При применении любая попытка подписчика использовать неизвестный идентификатор канала приведёт к ответу с ошибкой, помогая поддерживать строгие правила работы с каналами, заданные требованиями приложения.

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

location /nchan {
    nchan_subscribe_existing_channels_only on;
    nchan_pubsub;
}

Когда установлено в on, убедитесь, что каналы предварительно созданы; в противном случае подписчики не будут получать сообщения из несуществующих каналов.

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

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