Skip to content

Конфигурация Sapsan

Sapsan и central являются неразрывным целым и поставляются вместе. Настройка Sapsan выполняется через API central.

В руководстве по Sapsan параметры функций могут быть представлены фрагментами YAML. Эти фрагменты можно вводить через API central. Они описывают конфигурацию Sapsan, а адрес запроса и формат обращения к API central следует брать из документации выбранного решения.

Ниже показана структура конфигурации Sapsan и правила её применения.

Присоединение машины к кластеру, окно разрешения join и авторизация описаны в разделе присоединения стримеров.

Структура конфигурации

listeners:        # порты, которые слушает сервер
  http:
    - port: 80
  rtsp:
    - port: 554
  rtmp:
    - port: 1935
  webrtc:
    - port: 5005

streams:          # список потоков
  - name: cam1
    inputs:
    - rtsp:
        url: rtsp://admin:password@10.0.0.5/stream0
    dvr: {}

dvr:              # общее хранилище архива
  root: /storage
  disks:
  - path: d1

auth: {}            # авторизация проигрывания и публикации
rproxy: {}          # шлюз Peeklio
api_auth:           # логин/пароль Admin API
  login: admin
  password: secret
Секция Что настраивает Подробнее
listeners HTTP, RTSP, RTMP и WebRTC порты сервера эта страница
streams потоки: источники, транскодер, DVR, пуши, скриншоты захват видео
dvr дисковое хранилище архива запись архива
auth токены и auth-бекенды авторизация
rproxy шлюз Peeklio для агентов шлюз Peeklio
api_auth доступ к Admin API Admin API

Валидация

Sapsan проверяет конфигурацию при загрузке и отказывается стартовать с некорректной:

  • неизвестные поля — ошибка (защита от опечаток);
  • каждый вход потока должен содержать ровно один протокол;
  • порты не могут повторяться между слушателями и потоками;
  • если у потока включен dvr, обязана существовать глобальная секция dvr.

Горячая перезагрузка

Изменения конфигурации передаются через API central. На уровне процесса Sapsan поддерживает перечитывание sapsan.yaml по сигналу SIGHUP без перезапуска:

  • потоки, авторизация и DVR перенастраиваются на лету;
  • слушатели перепривязываются, только если изменился порт;
  • шлюз rproxy сохраняет подключения агентов между перезагрузками (но смена streampoint_key / endpoint_auth_url требует перезапуска процесса).