Установка и запуск Sapsan¶

На этой странице описано, как установить Sapsan, запустить его с минимальной конфигурацией и убедиться, что сервер работает.

Перед установкой¶

Note

TODO: системные требования (ОС, архитектуры, CPU/RAM, диски для DVR).

Установка из deb-пакета¶

Sapsan распространяется как deb-пакет sapsan из репозитория Flussonic:

echo "deb http://apt.flussonic.ru binary/" > /etc/apt/sources.list.d/flussonic.list
apt update
apt install sapsan

Запуск в Docker¶

Официальный образ — flussonic/sapsan. Пробросьте порты и конфигурационный файл внутрь контейнера:

docker run -d --name sapsan \
  -p 80:80 -p 554:554 -p 1935:1935 \
  -v /etc/sapsan/sapsan.yaml:/etc/sapsan/sapsan.yaml \
  -v /storage:/storage \
  flussonic/sapsan

Note

TODO: точный путь конфига внутри образа, переменные окружения, UDP-порты для SRT/WebRTC.

Минимальная конфигурация¶

Sapsan читает конфигурацию из файла sapsan.yaml (путь можно переопределить переменной окружения CONFIG_PATH). Минимальный конфиг — один HTTP-порт и один поток:

listeners:
  http:
    - port: 80

streams:
  demo:
    inputs:
    - syntetic: {}
    transcoder:
      output:
      - source: !content video
        codec: !set h264
      - source: !content audio
        codec: !set aac

Запуск и остановка¶

sapsan
# или с явным путем к конфигу:
CONFIG_PATH=/etc/sapsan/sapsan.yaml sapsan

Перечитать конфигурацию без остановки вещания: kill -HUP <pid>.
Корректно остановить сервер: kill -TERM <pid>.

Note

TODO: юнит systemd, логи по умолчанию, где смотреть статус.

Проверка работоспособности¶

Откройте плейлист тестового потока:

curl http://localhost/streaming/v/demo/index.m3u8

Если сервер вернул плейлист — Sapsan установлен и работает. Дальше настройте захват реального видео.