Skip to content

Сетевое ограничение управления

Эдж-стример отдаёт медиа в интернет, но тот же HTTP-порт публикует admin API, консоль, метрики и диагностику. Сетевое ограничение закрывает управляющую плоскость для доверенных сетей, сохраняя воспроизведение, публикацию и собственный трафик кластера.

Ограничение — это список IPv4/IPv6-адресов и CIDR в настройке management_allowed_ips. Пока список задан, управляющий маршрут отвечает запросу из любой другой сети 403 без редиректа. При отсутствии списка или пустом ничего не ограничивается.

Что управление, а что нет

Разделение зафиксировано в коде и не настраивается:

  • Медиа остаётся публичным — HLS, DASH, MPEG-TS/fMP4-фрагменты, превью, VOD, legacy-маршруты воспроизведения, публикация (MPEG-TS push, WHIP/WHEP) и подписанная загрузка VOD. Действует обычная авторизация: play token, publish-сессии, upload grant.
  • Управление — всё остальное — admin API (v3/v4), консоль и её ресурсы, метрики, диагностика, ONVIF relay, встроенное перенаправление запросов в момент его исполнения, NMOS и на общем, и на собственном порту, а также любой незнакомый серверу маршрут. Health-check относится к управлению: балансировщик, проверяющий сервер, обязан сидеть в разрешённой сети.

Авторизация никуда не девается: разрешённый адрес всё равно проходит обычный логин, API-ключи и роли. Ограничение сужает, кто может постучаться, а не кого впустят.

Настройка политики

В кластере политика живёт в консоли central, раздел «Настройки → Сетевое ограничение управления». Три состояния:

  • Не задано (наследуется) — действует значение менее приоритетного слоя; для управляемого стримера это его локальная конфигурация.
  • Выключено (все сети) — сохраняется пустым списком [] и явно выключает ограничение, перекрывая нижние слои.
  • Разрешённые сети — по одному адресу или CIDR в строке.

Сервер хранит и возвращает адреса в каноническом виде: адрес без маски превращается в 192.0.2.10/32 или 2001:db8::10/128, маска с указанием хоста внутри сети маскируется до самой сети (198.51.100.77/24 хранится как 198.51.100.0/24). Порядок элементов сохраняется. Опечатка в строке отклоняется при сохранении: 422 с указанием строки, и сообщение видно прямо на поле.

Форма предупреждает перед сохранением непустого списка: убедитесь, что сеть, из которой вы работаете, входит в него, иначе консоль сама станет недоступна. Если это случилось, правьте настройку с машины внутри разрешённой сети (или по внеполосному пути — например, консоль гипервизора). Автоматического «разрешить мой текущий адрес» нет.

Для standalone-стримера без central это то же поле management_allowed_ips верхнего уровня конфигурации сервера.

Слои и карточка стримера

Политика собирается из слоёв, сильнейший применяется последним: основной файл конфигурации машины, затем настройка из central, затем дополнительные файлы (drop-in) в каталоге .d рядом с конфигурацией. Там читаются только файлы *.json и *.conf — *.yaml молча игнорируется, так что называйте drop-in соответственно, иначе список в нём не применится. На управляемых стримерах central доставляет настройку как значение только для чтения; своей политики для отдельной машины задать нельзя. Если документ стримера каким-то образом содержит собственный management_allowed_ips, сервер отклоняет запись с 422, не меняя документ; устаревший сохранённый ключ можно убрать, записав null — это чистит доставленную копию, не трогая общую политику.

Карточка стримера показывает обе стороны раздельно:

  • Задано в central — общая политика со страницы настроек.
  • Применено нодой (последний отчёт) — список, который машина реально исполняет, из последнего отчёта, с временем его получения.

Списки могут различаться: локальный drop-in на машине перекрывает central, и карточка говорит об этом. Пустой присланный список — ограничение на машине выключено; отсутствие отчёта — «нет данных», а не выключенное ограничение: общая настройка вместо отсутствующего отчёта никогда не подставляется. При потере связи последний присланный список остаётся на карточке с пометкой, что состояние не подтверждено.

Как проверяется запрос

Проверяется только адрес непосредственного TCP-соединения (peer). Заголовки X-Forwarded-For, X-Real-IP и Forwarded игнорируются: настройка доверенных прокси для определения адреса зрителя на управление не влияет, подделанный заголовок ничего не меняет. IPv4-адрес в форме IPv4-mapped IPv6 сопоставляется с IPv4-записями списка; явная IPv6-сеть сохраняет своё сопоставление.

Если в список внесён адрес reverse proxy, всем запросам с него доверяют: стример не отличит клиентов прокси друг от друга. Держите управляющий путь прямым LAN/VPN-маршрутом либо повторите ограничение своим списком на самом прокси.

Применение и доставка

Изменение списка применяется сразу, без перезапуска и без перепривязки портов: раздача зрителям не прерывается. Управляемый стример стартует из сохранённой копии конфигурации даже без связи с central; настройка, пришедшая от central позже, ложится сверху. Если перезагрузка конфигурации не удалась до применения, действует прежний список; при частичном применении (например, новый список уже опубликован, а другой шаг упал) новый список остаётся в силе вместе с ошибкой — карточка показывает значение и config_error раздельно, молчаливого отката нет. Нечитаемый drop-in пропускается с предупреждением, как и раньше: если он нёс самый строгий список, действующая политика может ослабнуть — следите за содержимым каталога .d.

Embedded central

Если central стоит на той же машине, что и стример (встроенный вариант поставки), он настройку принимает, хранит и доставляет управляемым стримерам, но к собственным управляющим маршрутам пока не применяет — карточка этой ноды в списке машин показывает это прямо: «задано в central» есть, а «применено нодой» — «выключено», с пояснением. Сохранённый список ещё не значит, что сам central защищён: управляемые стримеры исполняют политику независимо от него.

Откат и downgrade

Если откатить версию самого стримера, настройка пропадёт только из его локальных конфигурационных файлов; настройка, сохранённая в central, и локальная копия доставленной конфигурации останутся и восстановятся при следующем обновлении. Если откатить только central, он может доставить стримерам документ без этого поля — и общая настройка на новых стримерах снимется. После возврата новой версии central снова сохраните нужный список в общих настройках (даже если он там уже написан — пересохраните тот же текст) и проверьте по карточкам стримеров, что список применился: одного перезапуска или нетронутого документа для восстановления доставки недостаточно.

Чем ограничение не является

  • Не firewall: оно охраняет HTTP-маршруты управления сервера, а не машину. Сетевую фильтрацию на уровне ОС это не отменяет.
  • Не замена авторизации: логины, токены и роли работают как прежде.
  • Не ограничение медийных протоколов: RTSP, RTMP, SRT и другие не-HTTP протоколы вне этого механизма.