Instalação e execução do Sapsan¶

Esta página descreve como instalar o Sapsan, ativá-lo com uma licença, executá-lo com uma configuração mínima e verificar que o servidor funciona.

Antes da instalação¶

O Sapsan não funciona sem licença: o arquivo license.txt precisa existir antes do primeiro início, e o servidor precisa de acesso à internet para a ativação online. Consulte o licenciamento para conhecer os detalhes.

Instalação a partir do pacote deb¶

O Sapsan é distribuído como pacote deb sapsan do repositório da Flussonic:

curl -sSf http://apt.flussonic.com/binary/gpg.key > /etc/apt/trusted.gpg.d/flussonic.gpg
echo "deb http://apt.flussonic.com binary/" > /etc/apt/sources.list.d/flussonic.list
apt update
apt install sapsan

O pacote instala o binário /usr/sbin/sapsan, a unidade de systemd sapsan.service, a configuração padrão em /etc/sapsan/sapsan.yaml e cria o diretório de estado /var/lib/sapsan.

Ativação¶

Antes de iniciar, coloque o arquivo de licença recebido junto à configuração:

cp license.txt /etc/sapsan/license.txt
chmod 600 /etc/sapsan/license.txt

No primeiro início, o Sapsan se ativa online e grava os artefatos de ativação no diretório de estado /var/lib/sapsan:

Consulte o licenciamento para ver os estados da licença e como verificá-los.

Configuração mínima¶

O Sapsan lê sua configuração de sapsan.yaml (o caminho pode ser redefinido com a variável de ambiente CONFIG_PATH). Uma configuração mínima é uma porta HTTP e um stream:

listeners:
  http:
    - port: 80

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

streams é uma lista: cada stream é um item com seu próprio name. Para avançar ao vídeo real, consulte a captura de vídeo.

Execução no Docker¶

A imagem oficial é flussonic/sapsan. Mapeie as portas e monte a configuração, a licença e o diretório de estado:

mkdir -p config data
# coloque config/sapsan.yaml e config/license.txt no lugar

docker run --rm -p 80:80 -p 554:554 -p 1935:1935 \
  -v "$(pwd)/config/sapsan.yaml:/etc/sapsan/sapsan.yaml:ro" \
  -v "$(pwd)/config/license.txt:/etc/sapsan/license.txt:ro" \
  -v "$(pwd)/data:/var/lib/sapsan" \
  flussonic/sapsan:latest

O diretório data (/var/lib/sapsan) precisa ser gravável e persistir entre reinícios — nele vivem server.id, os arquivos de ativação e o diretório keys/. Os caminhos CONFIG_PATH e SERVER_ID_PATH já estão definidos na imagem.

Início e parada¶

Quando instalado a partir do pacote deb, o servidor é gerenciado pelo systemd:

systemctl start sapsan     # iniciar
systemctl status sapsan    # estado
systemctl stop sapsan      # parar
systemctl enable sapsan    # iniciar na inicialização do sistema

Recarregue a configuração sem interromper o streaming com um sinal:

kill -HUP "$(systemctl show -p MainPID --value sapsan)"

Verificação de funcionamento¶

Verifique se o processo está rodando:

systemctl status sapsan

Verifique se a licença está ativada:

curl http://localhost/streamer/api-v4/license/status

O estado Licensed significa que o Sapsan está instalado, ativado e pronto. Abra também a playlist do stream de teste:

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

Se o servidor devolver uma playlist, o stream de demonstração funciona. Em seguida, configure a captura de vídeo real.