Конфигурация 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требует перезапуска процесса).