Instalación y ejecución de Sapsan¶

Esta página describe cómo instalar Sapsan, activarlo con una licencia, ejecutarlo con una configuración mínima y comprobar que el servidor funciona.

Antes de la instalación¶

Sapsan no funciona sin licencia: el archivo license.txt debe estar presente antes del primer arranque, y el servidor necesita acceso a internet para la activación en línea. Consulte el licenciamiento para conocer los detalles.

Instalación desde el paquete deb¶

Sapsan se distribuye como paquete deb sapsan desde el repositorio de 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

El paquete instala el binario /usr/sbin/sapsan, la unidad de systemd sapsan.service, la configuración por defecto en /etc/sapsan/sapsan.yaml y crea el directorio de estado /var/lib/sapsan.

Activación¶

Antes de arrancar, coloque el archivo de licencia recibido junto a la configuración:

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

En el primer arranque, Sapsan se activa en línea y escribe los artefactos de activación en el directorio de estado /var/lib/sapsan:

Consulte el licenciamiento para ver los estados de la licencia y cómo comprobarlos.

Configuración mínima¶

Sapsan lee su configuración de sapsan.yaml (la ruta se puede redefinir con la variable de entorno CONFIG_PATH). Una configuración mínima es un puerto HTTP y un 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 es una lista: cada stream es un elemento con su propio name. Para pasar al vídeo real, consulte la captura de vídeo.

Ejecución en Docker¶

La imagen oficial es flussonic/sapsan. Mapee los puertos y monte la configuración, la licencia y el directorio de estado:

mkdir -p config data
# coloque config/sapsan.yaml y config/license.txt en su 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

El directorio data (/var/lib/sapsan) debe ser escribible y persistir entre reinicios — en él viven server.id, los archivos de activación y el directorio keys/. Las rutas CONFIG_PATH y SERVER_ID_PATH ya están fijadas en la imagen.

Inicio y parada¶

Cuando se instala desde el paquete deb, el servidor se gestiona mediante systemd:

systemctl start sapsan     # iniciar
systemctl status sapsan    # estado
systemctl stop sapsan      # detener
systemctl enable sapsan    # arrancar al iniciar el sistema

Recargue la configuración sin interrumpir el streaming mediante una señal:

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

Comprobación de funcionamiento¶

Asegúrese de que el proceso está en ejecución:

systemctl status sapsan

Compruebe que la licencia está activada:

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

El estado Licensed significa que Sapsan está instalado, activado y listo. Abra también la playlist del stream de prueba:

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

Si el servidor devuelve una playlist, el stream de demostración funciona. Después, configure la captura de vídeo real.