Instalación de Watcher Cluster y Single¶

Watcher puede funcionar en un servidor o separar gestión y vídeo. Se describe instalación APT en Linux. NVR tiene un procedimiento separado.

Orden de instalación¶

Elija función del servidor de gestión e instale su paquete.
En clúster, instale watcher-streamer en receptores y grabadores.
Añada streamers y configure direcciones y almacenamiento.
Conecte una cámara de prueba; verifique directo y archivo.

Prepare DNS, sincronización horaria y red. Gestión necesita API de streamers; clientes, interfaz y direcciones de vídeo. No exponga PostgreSQL ni Redis a clientes.

Instalar Flussonic Watcher¶

Elija:

Tarea	Paquete	Componentes
Un servidor para gestión y vídeo, o gestión con streamer local	`flussonic-watcher`	Watcher VMS, `watcher-streamer`, PostgreSQL, Redis y Central
Gestión sin vídeo	`watcher-standalone`	Watcher VMS, Angie, PostgreSQL, Redis y Central; no incluye streamer separado
Servidor adicional de recepción y entrega	`watcher-streamer`	Capa multimedia gestionada desde Watcher

En 26.11, watcher-streamer depende de flussonic >= 26.09, nombre técnico de la dependencia multimedia. APT elige según repositorios; versión del paquete y motor pueden diferir. Instalar no cambia automáticamente a otro motor.

Ejecute como root en Ubuntu 24.04 LTS x86-64 preparado. Revise antes dimensionamiento.

Añada repositorio estable:

apt-get update
apt-get install --yes ca-certificates curl gnupg
install -d -m 0755 /usr/share/keyrings
curl --fail --location --silent --show-error \
  https://apt.flussonic.com/repo/binary/gpg.key \
  -o /usr/share/keyrings/flussonic.gpg
printf '%s\n' 'deb [signed-by=/usr/share/keyrings/flussonic.gpg] https://apt.flussonic.com/repo binary/' \
  > /etc/apt/sources.list.d/flussonic.list
apt-get update

Con streamer local:

apt-get install flussonic-watcher=26.11

Sin él, añada primero Angie para su SO. En Ubuntu 24.04:

curl --fail --location --silent --show-error \
  https://angie.software/keys/angie-signing.gpg \
  -o /usr/share/keyrings/angie-signing.gpg
printf '%s\n' 'deb [signed-by=/usr/share/keyrings/angie-signing.gpg] https://download.angie.software/angie/ubuntu/24.04 noble main' \
  > /etc/apt/sources.list.d/angie.list
apt-get update
apt-get install watcher-standalone=26.11

Espere configuración de paquetes. Establezca usuario y contraseña administrativos en el instalador. Abra http://watcher.example.com/watcher/client/ con su dirección e inicie sesión.

Compruebe versiones:

dpkg-query -W -f='${Package}    ${Version}\n' \
  watcher-vms flussonic-central postgresql redis-server
systemctl --failed

En un servidor se crea streamer local automáticamente. En watcher-standalone, añada otro antes de cámaras.

Configurar dominio¶

Use DNS accesible por usuarios, streamers y agentes. Cree registro, nombre de host y compruebe desde cada red:

hostname -f
getent hosts watcher.example.com
timedatectl status

La entrega de vídeo puede usar dirección distinta a gestión. Una web HTTPS también necesita vídeo HTTPS con certificado válido. Consulte dirección pública en streamers.

Watcher Standalone¶

Angie gestiona HTTP(S). Elija antes de ejecutar:

Let’s Encrypt — emisión automática para DNS accesible externamente; siga el apartado siguiente.
Certificado propio — de su organización o red privada; vaya a configuración manual, sin ejecutar emisión automática.

Emisión automática Let’s Encrypt¶

Tras configurar DNS y HTTP, solicite:

/opt/flussonic/bin/watcher-ssl-enable.sh watcher.example.com

Compruebe resultado y https://watcher.example.com/watcher/client/. Si falla, revise DNS y acceso externo; la instalación puede continuar por HTTP.

Certificado propio¶

Configure HTTPS manualmente. Prepare certificado con cadena y clave privada para el DNS; clientes y agentes deben confiar en la autoridad emisora.

Añada SKIP_SSL=TRUE en una línea de /etc/watcher/watcher.conf. Impide emisión automática en configuraciones posteriores del paquete sin desactivar HTTPS existente. No ejecute watcher-ssl-enable.sh sobre su configuración: sobrescribe el archivo HTTPS.

Coloque certificado y clave en el directorio elegido; restrinja la clave. Copie /etc/angie/watcher-standalone-ssl.conf antes de sustituirlo, cambiando dominio y rutas:

server {
    listen 443 ssl http2 default_server;
    listen [::]:443 ssl http2 default_server;
    server_name watcher.example.com;

    ssl_certificate /etc/angie/certs/watcher-fullchain.pem;
    ssl_certificate_key /etc/angie/certs/watcher-key.pem;
    include /opt/flussonic/contrib/nginx-standalone-ssl-params.conf;

    client_max_body_size 100M;
    client_header_buffer_size 16k;
    large_client_header_buffers 4 16k;

    include /opt/flussonic/contrib/nginx-standalone-locations.conf;
}

Los archivos /opt/flussonic/contrib/ vienen en el paquete. Mantenga ambos include: el primero configura compatibilidad TLS de agentes y el segundo rutas Watcher/Central, incluido /endpoint. Una configuración solo para web puede romper agentes.

Compruebe y aplique:
```
angie -t && systemctl reload angie
```
Establezca API_URL=https://watcher.example.com en /etc/watcher/watcher.conf y la misma dirección en API_URL y UPSTREAM_URL de /etc/central/central.conf. Reemplace valores existentes, sin duplicados. Reinicie durante mantenimiento:
```
systemctl restart central central-layouter watcher-vms watcher-go
```
Compruebe HTTPS desde cliente, inicio de sesión, agente existente y su vídeo. La página de acceso no prueba /endpoint ni TLS del agente.

Esto configura el certificado de gestión. Si cambia DNS existente, revise la dirección guardada en agentes: API_URL no la reconfigura. Compruebe certificados y URL de API y URL de carga pública de streamers aparte.

Solo clúster: instalar y configurar Watcher Streamer¶

Añada el repositorio estable e instale en cada servidor:

apt-get update
apt-get install watcher-streamer=26.11
systemctl start flussonic

Configure la clave acordada en /etc/flussonic/flussonic.conf.d/cluster.conf:
```
{"cluster_key":"EXAMPLE_CLUSTER_KEY"}
```
Use su clave para comunicación de confianza; no la publique en documentación de integración ni aplicaciones cliente.

Aplique:

systemctl reload flussonic
systemctl status flussonic --no-pager

Compruebe tiempo, acceso API desde gestión y prepare discos y montajes.

watcher-streamer desactiva la administración propia de la capa multimedia. Gestione cámaras y servidor desde Watcher.

Convertir streamers existentes a watcher-streamer¶

Guarde configuración y revise APT antes de cambiar paquetes:

apt-get update
apt-get --simulate install watcher-streamer=26.11

Si el plan coincide, instale en mantenimiento. watcher-streamer aplica configuración mediante reload; actualizar dependencias puede reiniciar multimedia. La orden no garantiza continuidad de emisiones.

Solo clúster: crear el clúster¶

Abra Streamers y creación. En modo manual indique host único y clave; guarde.

Nombre de host y clave de clúster.
Compruebe URL de API, accesible a gestión, y URL de carga pública, dirección de vídeo para usuarios.

Direcciones de gestión y vídeo; dominio y alias se configuran aparte.
Configure almacenamiento en DVR y compruebe estado.

Formulario de almacenamiento; compruebe grabación tras guardar.
Conecte cámara de prueba y compruebe vídeo y nuevo intervalo grabado.

Crear un registro no basta: deben funcionar API, recepción y entrega al cliente. Use zonas para limitar asignación.