Cluebase VMS Manual de usuario
Introducción
Cluebase VMS (sistema de gestión de video) es una solución de software integral diseñada para conectar cámaras de videovigilancia a una infraestructura de servidor. Permite una amplia variedad de funciones, como grabación de video, transmisión en vivo, análisis de video con IA, integración con control de acceso, conexión con alarmas contra incendio, administración de dispositivos IoT y muchas otras funciones avanzadas orientadas a las necesidades modernas de seguridad y automatización. El sistema admite implementaciones locales, híbridas y en la nube, por lo que es adecuado tanto para instalaciones pequeñas como para entornos empresariales grandes y distribuidos.
Cluebase VMS está diseñado con flexibilidad y escalabilidad. Funciona como una solución de plataforma abierta, lo que garantiza compatibilidad con una amplia variedad de hardware y sistemas de terceros. Ya sea que implemente una instalación en un solo edificio o administre una red con múltiples sitios, cámaras y sensores, Cluebase VMS ofrece las herramientas necesarias para monitoreo confiable, respuesta rápida y automatización inteligente.
Cluebase VMS se distribuye como un producto comercial bajo un Acuerdo de licencia de usuario final (EULA), que describe los derechos de uso, los términos de distribución y las condiciones de licencia.
Cluebase VMS está diseñado como una plataforma modular y escalable de gestión de video que se ejecuta en un entorno de orquestación Docker Compose. La arquitectura separa las funciones principales del sistema en contenedores individuales, lo que permite una implementación eficiente, actualizaciones sencillas e independencia de plataforma.
Toda la funcionalidad de backend está contenida y orquestada mediante Docker Compose. Cada componente está aislado para ofrecer estabilidad, escalabilidad y portabilidad:
Contenedor Backend - Maneja la lógica de API, la autenticación y la lógica del sistema. Se comunica con la base de datos, el frontend y las aplicaciones cliente.
Contenedor de Base de datos - Almacena todos los datos de configuración, registros, historial de eventos, cuentas de usuario y estados del sistema.
Contenedor Frontend - Entrega la interfaz de usuario basada en web.
Contenedor de Procesamiento de IA - Ejecuta tareas de análisis de video, como detección de objetos, clasificación y análisis de comportamiento. Utiliza aceleración por GPU cuando está disponible.
Contenedor de Servidor RTSP - Actúa como servidor de origen RTSP para cámaras retransmitidas.
Servidor de transmisión en vivo - Maneja transmisiones WS, WebRTC o HLS para vista previa en tiempo real, visualización multiusuario y compatibilidad móvil.
Puertos utilizados por Cluebase VMS: 80, 554, 2001, 8550-8599, 3000-3999, 443, 20000-40000
Requisitos de hardware y software
Requisitos mínimos del servidor: ARM o Intel/AMD de cuatro núcleos (32 o 64 bits), 4 GB de RAM, 2 GB de HDD/SSD.
El cliente de escritorio requiere una computadora PC o Mac con Intel/AMD de 32 o 64 bits, Apple Silicon u otra CPU ARM con al menos 2 núcleos de 1.5 GHz cada uno.
Navegadores compatibles: Google Chrome v.92+, Mozilla Firefox v.90+, Safari v.14+
La calculadora de hardware está disponible para calcular con precisión los recursos necesarios para VMS.
Sistemas operativos compatibles:
- Versiones de escritorio y servidor de Ubuntu 18.04 o posteriores; para uso de GPU recomendamos Ubuntu 22.04.
- Windows 11 o posterior con WSL, Windows Server 2016 o posterior con WSL.
⚠️ Tenga en cuenta que la red debe configurarse con una dirección IP estática. Si cambia la dirección IP, es necesario detener el servidor y ejecutar el script newIP.sh.
Compatibilidad
Códecs: Cluebase VMS está listo para trabajar con cualquier transmisión de video h.264 y h.265.
Todas las cámaras IP y DVR/NVR son compatibles.
Las cámaras y NVR se conectan a Cluebase VMS mediante ONVIF, RTSP o protocolos nativos.
Instalación de la aplicación cliente
Tenga en cuenta que la aplicación cliente web está disponible de inmediato al acceder a la dirección IP del servidor desde un navegador web. Sin embargo, si necesita instalar una aplicación cliente en su computadora de escritorio, puede descargarla en https://vcloud.ai/downloads
Instalación de la aplicación en Linux
Una vez que descargue el archivo Cluebase_VMS_Linux_x_x.deb, puede instalarlo desde la interfaz haciendo doble clic y siguiendo las instrucciones en pantalla, o desde la línea de comandos:
sudo apt install Cluebase_ VMS_Linux_x_x.deb
Instalación de la aplicación en Windows
Una vez que descargue el archivo Cluebase_VMS_WIN_x_x.exe, puede instalarlo desde la interfaz haciendo doble clic y siguiendo las instrucciones en pantalla.
Instalación de la aplicación en macOS
Una vez que descargue el archivo Cluebase_VMS_MacOS_x_x.dmg, puede instalarlo desde la interfaz haciendo doble clic y siguiendo las instrucciones en pantalla.
Inicio de sesión
Después de ejecutar la aplicación por primera vez, verá la pantalla de inicio de sesión.
La página de inicio de sesión proporciona acceso seguro a la interfaz de Cluebase VMS. Solo los usuarios autorizados con credenciales válidas pueden iniciar sesión para administrar o monitorear el sistema.
Campos y controles
Usuario - Ingrese el nombre de usuario de su cuenta. Usuario administrativo predeterminado: admin (se puede cambiar después en la configuración).
Contraseña - Ingrese la contraseña correspondiente. Para ver la contraseña mientras la escribe, haga clic en el icono del ojo junto al campo de entrada.
Recordarme (casilla) - Cuando está activada, las credenciales de sesión se almacenan en el navegador para mantener la sesión iniciada entre visitas. ⚠️ Recomendado solo en dispositivos privados y de confianza.
Botón Iniciar sesión - Haga clic para enviar sus credenciales y acceder al panel del sistema.
Selector de idioma - Ubicado en la esquina superior derecha de la página; haga clic en el icono de globo para seleccionar el idioma de interfaz que prefiera.
⚠️ Consejo para administradores: Después de la configuración inicial, se recomienda ampliamente cambiar la contraseña predeterminada y crear cuentas de usuario separadas con niveles de acceso adecuados para los miembros del equipo.
Ingrese su usuario y contraseña válidos y haga clic en Iniciar sesión. Después de la instalación puede usar las credenciales predeterminadas: admin/admin.
Activación de licencia
Para activar Cluebase VMS, debe obtener un archivo de licencia válido. Las licencias pueden solicitarse en línea o sin conexión, según la conectividad del sistema.
Esta sección explica cómo solicitar y aplicar una licencia mediante la interfaz integrada.
Vaya a Menú principal -> Configuración -> Licencia y llene el formulario de solicitud de licencia de VMS.
Campos de solicitud de licencia
Correo electrónico del cliente - Ingrese una dirección de correo válida. Se utiliza para identificar la solicitud de licencia y recibir la clave de licencia.
Nombre del cliente - Ingrese el nombre completo de la empresa o persona a quien se emitirá la licencia.
Número de cámaras conectadas a VMS - Especifique el número total de cámaras que se usarán con la instancia de VMS. La licencia quedará vinculada a esta cantidad.
Tipo de licencia - Seleccione el tipo de licencia requerido:
- Permanente - Licencia completa sin vencimiento.
- Temporal - Licencia de prueba o demostración válida solo por un periodo limitado.
Opciones de solicitud
- Solicitar en línea - Envía la solicitud de licencia directamente desde la interfaz de VMS al servidor de licencias. Requiere conectividad a Internet.
- Solicitar sin conexión - Genera un archivo de solicitud de licencia que se puede enviar manualmente al proveedor de licencias por correo electrónico o carga de archivo; es útil para sistemas aislados o sin acceso a Internet.
Activación de una licencia
Si ya recibió un archivo de licencia:
- Haga clic en el botón … para buscar y seleccionar el archivo .lic.
- Haga clic en Activar para aplicar la licencia al sistema.
✅ Después de una activación correcta, el sistema quedará completamente operativo de acuerdo con la cantidad de cámaras y las funciones incluidas en su licencia. 🔗 La licencia está sujeta al Acuerdo de licencia de usuario final (EULA)
Menú principal
El Menú principal ofrece acceso rápido a todas las funciones principales de la plataforma Cluebase VMS. Ubicado del lado izquierdo de la interfaz, permite a los operadores cambiar y crear distribuciones, acceder rápidamente a todas las cámaras de todos los servidores, administrar mapas, ver eventos e informes, cambiar el idioma de la interfaz y acceder a la configuración del sistema.
Distribuciones
Permite a los usuarios crear y cambiar entre distribuciones personalizadas de cuadrícula de cámaras para visualización en vivo. Al hacer clic en el menú desplegable se muestran las distribuciones predefinidas disponibles.
Árbol de cámaras
Muestra todas las cámaras y dispositivos disponibles organizados por servidor.
Muestra listas de cámaras agrupadas por nombre de servidor.
Cada cámara se indica con un punto rojo o verde (sin conexión/en línea).
Puede arrastrar cámaras individuales a una distribución para acceder a ellas de inmediato.
Iconos de navegación
Mapas - Abre el editor de mapas donde puede colocar y monitorear transmisiones de cámaras sobre un plano de piso o mapa del sitio.
Eventos - Permite acceder al historial de eventos con filtros y detalles.
Informes - Permite generar y ver informes a partir de eventos.
Configuración - Abre las opciones de configuración de todo el sistema, incluidas las configuraciones de servidor, cámara, usuario y análisis de video.
Sección de usuario
Nombre de usuario (por ejemplo, admin) - Indica el usuario conectado actualmente. Puede haber permisos diferentes según el rol del usuario.
Cerrar sesión - Finaliza la sesión y regresa a la pantalla de inicio de sesión.
Selector de idioma - Cambia el idioma de la interfaz. Haga clic en el icono de globo para elegir entre los idiomas compatibles.
Agregar cámaras
Ver el video Cómo agregar cámaras en los tutoriales de Cluebase VMS en YouTube
Herramienta de búsqueda de cámaras
La herramienta de búsqueda de cámaras está disponible para simplificar y acelerar los procesos de descubrimiento y conexión de cámaras.
Vaya a Configuración->Cámaras->Buscar
Todas las cámaras compatibles de la red local se encontrarán automáticamente (normalmente en 5 a 10 segundos).
Después de especificar las credenciales de las cámaras (nombre/usuario/contraseña), puede agregarlas una por una con el botón ‘+’ del lado izquierdo
O puede hacer clic en Agregar todos los dispositivos para agregar todas las cámaras con las credenciales especificadas.
Haga clic en Actualizar búsqueda para buscar nuevamente en la red.
Puede especificar manualmente el rango de búsqueda.
De forma predeterminada, el sistema buscará en la subred actual.
Agregar cámaras manualmente
Vaya a Configuración->Cámaras->Agregar cámara
Asigne un nombre a la cámara, seleccione el tipo de conexión, ingrese la dirección IP y el puerto para ONVIF o la URL para RTSP, capture el usuario y la contraseña de la cámara, seleccione la zona horaria y haga clic en Agregar.
Cree una nueva distribución para las cámaras como se describe más adelante.
Agregar cámaras RTMP
Cluebase VMS permite agregar cámaras y fuentes de video mediante el protocolo RTMP. Esta opción se utiliza cuando una cámara, codificador, DVR/NVR o servidor intermedio de streaming proporciona una transmisión de video RTMP.
Para agregar una cámara RTMP, abra Configuración, vaya a Cámaras y haga clic en Agregar cámara.
Se abrirá el formulario de configuración de la cámara.
Llene los siguientes campos:
Nombre del dispositivo - ingrese el nombre de la cámara que se mostrará en el árbol de cámaras y en las distribuciones.
Tipo de cámara - seleccione RTMP en la lista desplegable.
URL - ingrese la URL completa de la transmisión RTMP.
Ejemplo de URL RTMP:
rtmp://192.168.1.100/live/camera1
Después de ingresar la información requerida, haga clic en Agregar.
La cámara aparecerá en el árbol de cámaras bajo el servidor seleccionado. Si la transmisión RTMP está disponible y la URL es correcta, el indicador de estado de la cámara se pondrá en verde. La cámara podrá utilizarse en vista en vivo, distribuciones, grabación y otras funciones de VMS.
Uso de un servidor RTMP intermedio
Un servidor intermedio de streaming solo es necesario si la cámara no proporciona directamente una transmisión RTMP.
En este caso, la cámara envía su transmisión de video al servidor intermedio y Cluebase VMS recibe la transmisión de ese servidor como RTMP.
Como servidor intermedio puede usar simple-rtsp-server / MediaMTX.
Al usar MediaMTX, asegúrese de que RTMP esté habilitado en su archivo de configuración YAML. Después de habilitar RTMP, configure la cámara, codificador o DVR/NVR para enviar la transmisión al servidor MediaMTX. Esta opción suele estar disponible en la interfaz web de la cámara, configuración del codificador o configuración de streaming del DVR/NVR.
El flujo típico es:
Habilitar RTMP en la configuración YAML de MediaMTX.
Configurar la cámara, codificador o DVR/NVR para publicar la transmisión en MediaMTX.
Copiar la URL RTMP resultante.
En Cluebase VMS, abrir Configuración, ir a Cámaras y hacer clic en Agregar cámara.
Seleccionar RTMP como tipo de cámara.
Pegar la URL RTMP en el campo URL.
Hacer clic en Agregar.
Notas
Use RTMP solo cuando la fuente de video proporcione una transmisión RTMP directamente o a través de un servidor intermedio de streaming.
Si la cámara admite RTSP pero no admite RTMP, puede agregarse a Cluebase VMS como cámara RTSP o retransmitirse mediante un servidor intermedio con RTMP habilitado.
Asegúrese de que el servidor Cluebase VMS tenga acceso de red a la fuente RTMP.
Distribuciones
Ver el video Cómo crear una nueva distribución en los tutoriales de Cluebase VMS en YouTube
Haga clic en Nueva distribución en el menú principal.
Se abrirá la página de edición de Distribución. El menú de Distribución permite a los usuarios crear y personalizar cuadrículas de visualización con varias cámaras. Ofrece una forma potente y flexible de monitorear varias transmisiones de video simultáneamente, adaptar distribuciones para diferentes pantallas y habilitar respuesta rápida ante alarmas mediante vistas dedicadas.
Asigne un Nombre a la nueva distribución, elija una plantilla de distribución y arrastre cámaras o grupos completos a la cuadrícula del lado derecho.
Panel de configuración de distribución (lado izquierdo)
Campo Nombre - Ingrese un nombre personalizado para la distribución actual (por ejemplo, “Vista entrada principal” o “Turno nocturno”).
Plantillas de distribución - Seleccione una cuadrícula predefinida eligiendo una de las opciones disponibles:
1, 4, 9, 16, 25, 36 o Todas (3x3 desplazable), según cuántas cámaras desee ver al mismo tiempo.
Búsqueda de cámara - Use el campo de entrada para encontrar rápidamente una cámara por nombre o número entre todos los dispositivos registrados.
Árbol de cámaras - Muestra todas las cámaras disponibles, organizadas por servidor (por ejemplo, Servidor local y Oficina).
Las cámaras están etiquetadas por nombre/número y pueden arrastrarse y soltarse en cualquier celda de la cuadrícula.
Mapas - Si están configurados, los mapas pueden agregarse como elemento de la distribución para visualizar geoespacialmente las ubicaciones de las cámaras.
Ventana de alarma - Mosaico especial de video que cambia automáticamente para mostrar la transmisión en vivo de la cámara que activó el evento o alarma más reciente.
Configuración de muro de video
Muestra la distribución de pantalla seleccionada actualmente (por ejemplo, Pantalla 1).
Cada cuadro vacío es una ranura donde puede colocarse una cámara.
Las cámaras pueden arrastrarse desde el panel izquierdo hacia cualquier celda de la cuadrícula.
Use el botón + de la parte superior para agregar pantallas adicionales al espacio de trabajo (por ejemplo, para configuraciones con varios monitores).
Haga clic en Guardar para guardar la distribución.
Para editar distribuciones existentes, haga clic en el botón de lápiz del menú de pestañas de distribución en la parte superior de la pantalla.
Cuando la distribución está abierta en pantalla, puede arrastrar y soltar las ventanas de video y las pestañas de distribución para reordenarlas. Los cambios se guardan automáticamente.
Zoom digital
La función de zoom digital permite acercar y alejar cualquier cámara en modo en vivo y archivo desplazando la rueda del mouse o seleccionando un área específica con el botón derecho.
Para seleccionar el área de interés, mantenga presionado el botón derecho del mouse, mueva el mouse para seleccionar el área (aparecerá un rectángulo verde rayado) y luego suelte el botón derecho.
El área de interés se ampliará.
Pan Tilt Zoom (PTZ)
El menú de control PTZ (Pan-Tilt-Zoom) proporciona control intuitivo en tiempo real para cámaras compatibles con PTZ. Permite a los operadores mover la cámara manual o automáticamente hacia las vistas deseadas, acercar o alejar la imagen y activar posiciones preestablecidas o secuencias de patrullaje.
⚠️ Nota: La opción PTZ debe habilitarse en el menú de configuración de cada cámara (Menú principal -> Configuración -> Cámaras) únicamente para cámaras PTZ y cámaras con zoom motorizado.
Control PTZ manual
Pad direccional - Use la rueda de control central para mover la cámara:
Arriba / Abajo / Izquierda / Derecha - Inclina o gira la cámara en la dirección seleccionada. Las flechas del teclado físico también funcionan para este propósito.
Círculo central - Detiene el movimiento al hacer clic (si aplica).
Control deslizante de zoom
+ para acercar. La tecla '+' del teclado físico también funciona.
- para alejar. La tecla '-' del teclado físico también funciona.
Arrastre el control deslizante para ajustar suavemente el nivel de zoom.
Preajustes PTZ
Botones numerados (1-9) - Presione un número para mover la cámara a una posición preestablecida guardada previamente. Las teclas 1-9 del teclado físico también funcionan.
Guardar - Elija un número (1-9), después de ajustar la posición de la cámara, y luego presione Guardar para guardar la posición PTZ actual como preajuste.
Borrar - Elimina la posición preestablecida seleccionada y la deja disponible para configurarla de nuevo.
Modo patrulla
Botón Patrulla - Activa el modo de patrulla automática, que recorre todos los preajustes guardados en orden numérico.
Retraso (segundos) - Define el tiempo de espera entre cada posición preestablecida durante el modo patrulla.
Ejemplo: 10 s significa que la cámara permanecerá en cada preajuste durante 10 segundos antes de pasar al siguiente.
Comandos del teclado físico
Cluebase VMS admite comandos de teclado físico para operar más rápido en vista en vivo, distribuciones, control PTZ y modo archivo. Estos atajos son útiles para operadores que necesitan navegar entre cámaras, controlar ventanas de video, cambiar distribuciones o trabajar con reproducción de archivo sin usar el mouse.
Navegación general con teclado:
Flechas - Mueven la selección entre cámaras en la distribución actual. La cámara seleccionada se resalta con un marco azul.
Enter - Agranda la ventana de video seleccionada. Presione de nuevo o use los controles de la interfaz para volver a la vista de distribución.
A - Cambia la cámara seleccionada a modo archivo.
Shift y Flecha izquierda / Shift y Flecha derecha - Cambia a la distribución anterior o siguiente.
M - Abre o cierra el menú principal.
E - Abre o cierra el panel de eventos.
Control PTZ con teclado:
Cuando la ventana de control PTZ está abierta, el teclado puede usarse para controlar la cámara PTZ seleccionada.
Flechas Mueven la cámara PTZ hacia arriba, abajo, izquierda o derecha.
+ / - Acerca o aleja el zoom.
Teclas numéricas 1-9 Mueven la cámara a la posición preestablecida PTZ correspondiente.
Control de modo archivo con teclado:
Cuando la cámara seleccionada está abierta en modo archivo, están disponibles los siguientes comandos:
Flecha izquierda / Flecha derecha Retrocede o avanza entre segmentos de archivo.
+ / - Aumenta o disminuye la velocidad de reproducción.
Shift y '+' / Shift y '-' Acerca o aleja la línea de tiempo del archivo.
T - Abre el panel de navegación por marca de tiempo. El cursor se coloca automáticamente en el campo de hora, para que el operador pueda ingresar de inmediato la hora requerida. Presione Enter para ir a la marca de tiempo seleccionada.
Funcionalidad multiservidor
Cluebase VMS permite crear sistemas multiservidor para:
- Administrar todos los servidores y cámaras desde un solo cliente.
- Crear distribuciones unificadas que contengan cámaras de varios servidores.
- Recibir alarmas de varios servidores en un solo cliente.
Vaya a: Menú principal -> Configuración-> Cámaras -> Vincular servidor
Llene los campos de acceso al servidor y haga clic en vincular.
Configuración de almacenamiento
Configuración general de almacenamiento
Para acceder a la configuración de almacenamiento, vaya a: Menú principal -> Configuración-> Almacenamiento
Para habilitar un volumen de almacenamiento para grabación, seleccione el volumen de almacenamiento y enciéndalo:
Después seleccione las cámaras que deben grabarse, establezca la profundidad del archivo, seleccione la calidad y haga clic en Guardar. El almacenamiento se activará para grabación de inmediato.
De forma predeterminada, VMS debe identificar todas las unidades montadas en el sistema.
Para usar varias unidades de almacenamiento, debe montar los discos en el sistema operativo y reiniciar VMS.
El sistema de archivos de las unidades debe ser EXT4.
Timelapse
El modo de grabación Timelapse permite que Cluebase VMS grabe cámaras seleccionadas con un intervalo de cuadros reducido en lugar de una grabación continua a tiempo completo. Esto es útil para escenarios de monitoreo a largo plazo donde se necesita conservar historial visual durante periodos extensos reduciendo el consumo de almacenamiento.
Para configurar la grabación Timelapse:
- Vaya a Menú principal → Configuración → Almacenamiento.
- Seleccione el volumen de almacenamiento donde se grabará el archivo de la cámara.
- Asegúrese de que el volumen de almacenamiento seleccionado esté Encendido.
- En la lista de cámaras, encuentre la cámara que debe grabarse en modo Timelapse.
- En la columna Lógica de grabación, abra el menú desplegable de la cámara requerida.
- Seleccione Timelapse.
- En el campo Frecuencia de Timelapse (min), especifique cada cuánto Cluebase VMS debe guardar un cuadro en el archivo. El valor puede establecerse de 1 a 1440 minutos. Ejemplo:
- 1 - se guarda un cuadro cada minuto.
- 60 - se guarda un cuadro cada hora.
- 1440 - se guarda un cuadro una vez al día.
- Establezca la Profundidad del archivo (días) requerida para la cámara.
- Haga clic en Guardar para aplicar la configuración de almacenamiento y grabación.
Después de guardar la configuración, Cluebase VMS comenzará a grabar la cámara seleccionada de acuerdo con la frecuencia Timelapse especificada.
Nota: La frecuencia Timelapse se configura en minutos y se aplica a las cámaras con Timelapse seleccionado como lógica de grabación.
Configuración de almacenamiento NAS (Network Attached Storage) e iSCSI
Para usar almacenamiento NAS en Cluebase VMS, debe montar la unidad NAS en el sistema operativo. Después, en un plazo aproximado de 2 minutos, Cluebase VMS conectará automáticamente la unidad NAS montada.
Estos son algunos puntos importantes a considerar:
El sistema no ofrece una interfaz para conectar almacenamiento al servidor; debe hacerlo manualmente. Los siguientes artículos pueden ayudarle a seguir el procedimiento:
- https://ubuntu.com/server/docs/service-iscsi
- https://www.seagate.com/gb/en/manuals/lyve-mobile-rackmount-receiver/iscsi-network-setup-linux-ubuntu-debian/
Una vez agregado el almacenamiento al servidor con la utilidad "open-iscsi", no es necesario reiniciar VMS. El servidor revisa periódicamente los almacenamientos disponibles (cada 4 minutos) y, cuando detecta almacenamiento NAS que aún no se usa, lo monta automáticamente y lo agrega al sistema.
Durante esta revisión, el servidor también comprueba si el almacenamiento sigue conectado o si el sistema de archivos pasó a modo de solo lectura (puede ocurrir si la conexión iSCSI se interrumpe durante algún tiempo). En términos generales, el sistema verifica todo para mantener actualizado el estado del disco y administrar todos los procesos relacionados, como montaje, remontaje y grabación de archivo.
El mismo almacenamiento NAS también puede configurarse en servidores de conmutación por error para que el archivo escrito desde el servidor principal esté disponible desde el servidor de conmutación por error.
Configuración de hora
La hora precisa del servidor es esencial para el registro confiable de eventos, marcas de tiempo de video y sincronización entre sistemas. Esta sección permite configurar la hora del servidor VMS manualmente o automáticamente mediante NTP. Vaya a Menú principal->Configuración->Configuración general->Configuración de hora:
Establecer la hora del servidor manualmente
Use los campos de hora, minuto y segundo para ajustar manualmente el reloj del sistema.
Este método es útil si la sincronización NTP está deshabilitada o no está disponible.
Seleccionar zona horaria
Elija su zona horaria local en la lista desplegable.
El formato es Región/Ciudad (desfase GMT).
Sincronización NTP
Interruptor Encendido / Apagado - Habilite esta opción para sincronizar automáticamente la hora del servidor mediante un servidor NTP (Network Time Protocol). Esto ayuda a mantener una hora consistente y precisa durante periodos prolongados.
URL del servidor NTP - Especifique el servidor NTP con el que se sincronizará. Predeterminado: ntp.ubuntu.com. Puede cambiarlo por cualquier servidor horario preferido (por ejemplo, pool.ntp.org o un servidor NTP local).
Administración de acceso de usuarios
Administración de roles Vaya a Configuración->Usuarios->Agregar rol
Asigne un nombre al rol y otorgue acceso a cámaras y funciones específicas. Haga clic en guardar.
Tenga en cuenta que todos los usuarios con este rol tendrán acceso a las cámaras y funciones especificadas.
Administración de usuarios Vaya a Configuración->Usuarios->Agregar nuevo usuario
Especifique las credenciales del nuevo usuario: Usuario, Contraseña y el Rol requerido. El acceso otorgado al Rol seleccionado se indica abajo, pero no está disponible para edición. Para editar los permisos debe editar el Rol haciendo clic en el botón de lápiz.
Administración de organizaciones
De forma predeterminada, todos los roles y usuarios se agregan a la organización raíz. Si necesita una capa adicional de acceso de usuarios para multiarrendamiento, cree más organizaciones y cree roles y usuarios dentro de ellas.
Mapas y planos de piso
El menú Mapas permite visualizar y monitorear ubicaciones de cámaras tanto en mapas interactivos como en planos de piso, lo que lo hace ideal para conciencia espacial en tiempo real, vista general del sitio y respuesta coordinada de seguridad.
Para ubicar una cámara, sensor de alarma o puerta en un mapa o plano de piso, puede configurarlo en el menú Mapas. Vaya a Menú principal->Mapas y haga clic en “+” agregar para crear un elemento de distribución de mapa. Siga las instrucciones de la pantalla inicial para crear un mapa. Haga clic derecho en cualquier ubicación del mapa para colocar una cámara, sensor de alarma o puerta. Agregue el mapa a Distribuciones para mantenerlo visible mientras trabaja con cámaras.
El editor de planos de piso permite colocar y vincular cámaras, sensores y puertas directamente sobre diagramas arquitectónicos del sitio. Esto proporciona una vista general visual de los componentes del sistema y permite a los operadores identificar, monitorear y reaccionar rápidamente ante eventos de manera espacial.
Panel de configuración de sensor
Al hacer clic en el icono de un sensor, aparece el siguiente panel de configuración:
ID de sensor - Identificador único del sensor. Se utiliza para referencia interna e integración.
Vincular con cámara - Use el menú desplegable para vincular el sensor con una cámara específica. Cuando se active el sensor, la cámara vinculada se mostrará automáticamente.
Parpadear en rojo al activarse - Cuando está habilitado, el icono del sensor en el mapa parpadeará en rojo en tiempo real al activarse.
Editar ubicación - Permite reposicionar el icono del sensor en el mapa sin eliminarlo.
Eliminar sensor del mapa - Elimina el icono del sensor del plano de piso.
Botón Guardar - Confirma y aplica los cambios al sensor seleccionado.
Piso 1 / Piso 2 - Permite navegar entre varios pisos o niveles de la instalación. Cada pestaña representa una capa de plano de piso independiente donde pueden colocarse diferentes dispositivos.
Mapas geográficos sin conexión
Cluebase VMS puede utilizar mapas geográficos sin conexión en instalaciones donde el servidor o la estación de trabajo del operador tiene acceso limitado o nulo a Internet. Los mapas sin conexión se crean como un tipo de mapa separado, y las regiones geográficas requeridas deben descargarse antes de usarlos.
Para crear un mapa sin conexión:
- Abra Menú principal -> Mapas y haga clic en + para agregar un nuevo mapa.
- Introduzca el título del mapa.
- En el campo Tipo de mapa, seleccione Mapa global sin conexión.
- Haga clic en Crear.
Después de crear el mapa sin conexión, abra la ventana de descarga de regiones usando el botón de regiones/descarga en la esquina inferior derecha del editor de mapas.
En la ventana Regiones, expanda el continente, país o área requerida. La lista muestra las regiones disponibles y el tamaño aproximado de descarga de cada una.
Para descargar una región, haga clic en el botón de descarga junto a su nombre. Repita esta acción para cada región que deba estar disponible sin conexión.
Una vez descargadas las regiones requeridas, el mapa sin conexión se puede usar de la misma forma que otros mapas. Los operadores pueden ampliar y desplazarse por el área descargada, dibujar polígonos y colocar cámaras, sensores o puertas en el mapa.
Grupos de cámaras
Vaya a Configuración->Cámaras->Agregar grupo y llene el campo de nombre del grupo. Después haga clic en “Agregar”.
Para editar un grupo, haga clic en el icono de ‘lápiz’ del lado derecho del grupo.
Ahora puede editar o eliminar el grupo.
Para agregar una cámara a un grupo específico, vaya a la configuración de la cámara y seleccione el grupo requerido.
💡 También es posible arrastrar y soltar cámaras dentro de los grupos con el mouse.
Configuración de transmisión de video
El sistema permite administrar transmisiones de video en Configuración -> Configuración general -> Configuración de transmisión de video:
Este menú incluye controles que permiten configurar cómo se maneja la información de video para visualización en vivo y archivo. Ajuste estas opciones para equilibrar rendimiento y calidad de video según las capacidades del sistema y el caso de uso.
Tamaño de fragmento de transmisión en vivo (segundos) - WS Define la duración del fragmento (en segundos) usado para transmisión de video en vivo mediante WebSocket. Los valores más pequeños reducen la latencia, pero pueden aumentar la carga de CPU/red.
Tamaño de fragmento de archivo (segundos) Define la duración de los fragmentos de video almacenados en el archivo. Los fragmentos más largos reducen la cantidad de archivos y pueden optimizar el almacenamiento, pero pueden aumentar el tiempo de acceso al revisar archivos.
Extraer transmisiones SD y HD simultáneamente Cuando está habilitado, el sistema obtiene al mismo tiempo las transmisiones de definición estándar y alta definición. Esto puede mejorar la velocidad de cambio de transmisión, pero puede aumentar significativamente la carga de CPU. Predeterminado: Deshabilitado.
Revisar transmisión al agregar cámara nueva Cuando está habilitado, el sistema verifica automáticamente la transmisión de video al agregar una cámara nueva. Esto ayuda a asegurar que la cámara esté correctamente conectada y transmitiendo antes de agregarla al sistema. Predeterminado: Habilitado.
Análisis de video
Información general
Cluebase VMS ofrece soporte sólido para una variedad de tecnologías de análisis de video, con flexibilidad para distintos escenarios de implementación y requisitos de usuario. El sistema admite seis tipos de análisis de video, cada uno diseñado para necesidades específicas:
- Análisis de video integrado Incluye detectores estándar como:
- Detección de movimiento
- Detección de sabotaje de cámara
- Detección de objetos
- Detección humana
- Detección de vehículos
- Conteo de personas
- Conteo de vehículos
- Reconocimiento facial Lite
- Detección de humo e incendio
- Detección de EPP (equipo de protección personal)
- Detección de estacionamiento indebido
- Detección de residuos
- Otros modelos adicionales de IA incluidos con el software
- Análisis de video YOLO personalizado Integre sus propios modelos entrenados a la medida usando la arquitectura YOLO (You Only Look Once) para detección de objetos adaptada a casos de uso específicos.
- Visual Assistant - Análisis basado en LLM Módulo de vanguardia impulsado por modelos de lenguaje grandes (LLM) para flujos avanzados y personalizables de análisis de video mediante lógica en lenguaje natural.
- Módulos de análisis de video de terceros VMS puede integrarse con proveedores externos de análisis, lo que permite soporte flexible para diversas soluciones específicas de la industria.
Análisis de video con IA
Cluebase VMS incluye una amplia variedad de análisis de video integrados.
Haga clic en el botón 
en la parte inferior de la ventana de video para abrir la configuración de análisis de video de la cámara actual.
En el menú , elija el detector de análisis de video deseado, habilítelo, configúrelo y haga clic en 
para aplicar la configuración.
Cuando sea necesario, habilite la opción Ver zona en la configuración del detector para usar la zona de detección (máscara).
Análisis de video YOLO personalizado
Cluebase VMS admite la integración de modelos YOLO entrenados a la medida para soluciones personalizadas de análisis de video. Esta función es ideal para usuarios que necesitan detectar objetos o comportamientos muy específicos no cubiertos por los detectores estándar.
⚠️ Nota: Al igual que los Módulos adicionales de IA, esta función requiere que esté instalado el contenedor ai. Si el contenedor no se instala durante la configuración, el sistema no podrá ejecutar modelos YOLO personalizados y devolverá el error: “Analytics server is unavailable.”
Capacidades principales:
- Los usuarios pueden cargar y ejecutar sus propios modelos YOLO en formato .pt (PyTorch).
- Los modelos pueden entrenarse con conjuntos de imágenes personalizados, por ejemplo usando plataformas como Roboflow, que simplifican la preparación, etiquetado y entrenamiento de datasets.
- Una vez implementados, estos modelos pueden aplicarse a transmisiones de cámaras mediante el menú de IA en la interfaz de Cluebase VMS.
Esta capacidad permite a las organizaciones implementar casos de detección altamente especializados, como identificar equipo único, comportamientos o eventos específicos de la industria.
Para usar un modelo YOLO entrenado por el usuario (por ejemplo, creado con Roboflow) para detección personalizada de objetos, siga estos pasos en la interfaz de Cluebase VMS:
- Vaya a Menú principal -> Configuración -> Análisis -> Modelo de IA personalizado (YOLO)
- Seleccione “Nuevo modelo” En el campo desplegable Modelo, elija “Nuevo modelo” para indicar que está agregando uno nuevo al sistema, o seleccione un modelo existente.
- Ingrese un nombre En el campo Nombre del modelo, asigne un nombre descriptivo. Ejemplo: Modelo de detección de drones.
- Cargue el archivo del modelo Haga clic en el botón “…” junto al campo Archivo del modelo para buscar y cargar su archivo de modelo YOLO .pt. Ejemplo: drone-detection.pt ⚠️ Asegúrese de que el modelo esté en formato .pt y haya sido entrenado correctamente usando plataformas como Roboflow u otras herramientas compatibles con YOLO.
- Haga clic en “Agregar” Una vez llenos el archivo y nombre del modelo, haga clic en el botón “Agregar” en la parte inferior derecha para guardar y cargar el modelo.
Una vez agregado, el modelo YOLO personalizado aparecerá en la lista del menú dentro de la ventana de video de Distribución y podrá configurarse y usarse igual que los análisis integrados.
Visual Assistant
La función Visual Assistant introduce un enfoque innovador al análisis de video al permitir que los usuarios definan lógica de detección usando lenguaje natural. Impulsado por modelos de lenguaje grandes (LLM), este módulo facilita crear escenarios de detección personalizados sin programación ni entrenamiento de modelos.
Visual Assistant permite crear reglas de detección potentes y conscientes del contexto con solo describirlas en texto simple. Por ejemplo: “Answer only 'yes' when you detect a fight”
El sistema interpreta la regla, la aplica a la transmisión de video y comienza a detectar de acuerdo con ella.
Instalación
Para habilitar Visual Assistant:
- Vaya a Menú principal → Configuración → Análisis → Visual Assistant
- Haga clic en el botón Instalar
⚠️ Requisitos del sistema: Esta función requiere una GPU con soporte CUDA. Consulte la lista de GPU compatibles aquí: Lista de GPU compatibles
Si el sistema no cuenta con una GPU compatible, la instalación no continuará y la funcionalidad de Visual Assistant no estará disponible.
Creación de una regla de detección nueva en Visual Assistant
La interfaz de Visual Assistant permite definir una regla personalizada de análisis de video mediante una instrucción en lenguaje natural. Siga estos pasos para agregar una regla nueva:
1. Iniciar una regla nueva
En el campo “Regla de detección”, escriba el nombre de la regla nueva.
Ejemplo: Detección de pelea
2. Seleccionar regla de detección
En el menú desplegable “Seleccionar regla de detección”, elija “Nueva regla” si es la primera vez que la crea.
Una vez guardada, aparecerá aquí para reutilizarla o modificarla.
3. Escribir el prompt
En el campo Prompt, describa en lenguaje simple lo que la IA debe detectar.
Ejemplo:
say only 'yes' if you see a real fight 💡 La IA evaluará cada cuadro con base en esta instrucción y devolverá una respuesta simple como “yes”, “no” o un conteo.
4. Definir la lógica
- Use el menú desplegable Lógica para definir cómo debe reaccionar el sistema ante la respuesta de la IA:
- Alarma si la respuesta es ‘yes’ - activa una alerta cuando el modelo responde “yes”.
- Alarma si la respuesta es ‘no’ - activa una alerta cuando la respuesta es “no”.
- Conteo - devuelve un conteo numérico en lugar de activar una alarma.
5. Probar la regla (opcional)
- Cargue una imagen de muestra (JPG o PNG) en “Probar en una imagen” para verificar cómo funciona el prompt antes de guardarlo.
- Haga clic en Ejecutar para correr el prompt sobre la imagen.
Ejemplo: Esta captura muestra cómo un usuario configuró una regla de detección personalizada con el módulo Visual Assistant para detectar peleas en una transmisión de video usando lógica de IA en lenguaje natural.
Desglose de configuración:
Nombre de la regla de detección: Fight detection - Es el nombre personalizado asignado a la regla para identificarla fácilmente.
Prompt: say only 'yes' if you see a real fight - Es la instrucción en lenguaje natural dada a Visual Assistant. Le indica a la IA analizar la entrada y devolver “yes” solo si se observa una pelea real.
Lógica: Alarm if answer is 'yes' - Esta opción define qué ocurre según la respuesta de la IA. Si la IA devuelve “yes”, el sistema activará una alarma.
Imagen de prueba: El usuario cargó una foto que muestra una escena caótica con varias personas y una persona en el suelo, lo que podría indicar una pelea. Esta imagen se usa para probar la regla antes de implementarla en video en vivo.
Resultado de prueba (a la derecha): El sistema ejecutó el prompt y devolvió:
➜ “Yes” - significa que la IA detectó lo que interpretó como una pelea real y, con base en la lógica definida, esto activaría una alerta en VMS.
Resultado final:
- El usuario validó que la lógica de detección funciona correctamente con una imagen de prueba.
- Cuando esté satisfecho, el usuario puede hacer clic en “Guardar regla” para aplicar esta lógica a transmisiones de video en vivo.
6. Guardar la regla
Cuando esté satisfecho con la configuración, haga clic en “Guardar regla” para aplicarla. Una vez guardado, el detector personalizado aparecerá en la lista del menú dentro de la ventana de video de Distribución y podrá configurarse y usarse igual que los análisis integrados.
Listas de reconocimiento facial
Para usar las listas de reconocimiento facial, vaya a Menú principal -> Configuración -> Análisis -> Listas de reconocimiento facial.
El menú de listas de reconocimiento facial permite crear, editar y eliminar listas de rostros para los detectores de reconocimiento facial integrados y VCA; también permite agregar y eliminar rostros en las listas.
Listas LPR (listas de reconocimiento de placas vehiculares)
Para usar las listas LPR, vaya a Menú principal -> Configuración -> Análisis -> Listas LPR *solo disponible si el servidor VCA está configurado.
Use este menú para crear, editar y eliminar listas LPR para el detector VCA LPR; también para agregar y eliminar números de placas vehiculares en las listas.
Panel de alarmas
El Panel de alarmas ofrece una vista centralizada de todos los eventos detectados por el sistema, como detecciones de objetos, alertas de movimiento y eventos activados por cámaras. Los usuarios pueden filtrar, revisar y exportar datos de eventos con contexto visual, lo que lo hace ideal para monitoreo en tiempo real y análisis posterior a incidentes.
Para ver análisis de video y eventos del sistema en tiempo real, abra el Panel de alarmas haciendo clic en el botón de campana en la esquina superior derecha de la distribución.
Filtros y búsqueda
Use la sección superior para filtrar y buscar entre eventos:
Menú desplegable Tipo de evento: Filtra eventos por tipo (por ejemplo, Detección de objetos, Movimiento, Intrusión).
Menú desplegable Subtipo: Refina aún más la categoría del evento (por ejemplo, Persona, Vehículo).
Selección de cámara: Filtra eventos según una o más cámaras específicas.
Rango de fecha y hora: Define una ventana de tiempo para acotar la búsqueda usando los campos Desde y Hasta.
Restablecer: Borra todos los filtros y restaura la lista completa de eventos. Descarga de informe
Descargar informe Exporta la lista de eventos filtrados en el formato elegido. Formatos compatibles: PDF (predeterminado).
Resultados por página Ajusta el número de eventos mostrados o incluidos en el informe (el valor predeterminado es 50).
Guardar cambios Aplica los filtros o ajustes nuevos seleccionados arriba.
Cada entrada de la lista incluye:
Miniatura de captura Vista previa de imagen del momento en que ocurrió el evento.
Tipo de evento (por ejemplo, Detección de objetos)
Nombre de cámara Indica qué cámara activó el evento.
Tipo de objeto Clasifica el objeto detectado (por ejemplo, Persona, Vehículo).
Nivel de confianza Muestra el porcentaje de certeza de la IA en la detección.
Marca de tiempo Indica cuándo se registró el evento.
Botones de acción de evento (lado derecho de cada evento)
Comentarios - Abre un cuadro de comentario donde los operadores pueden anotar el evento para referencia interna o entrega de turno.
Descargar captura del evento - Descarga de inmediato el cuadro de imagen asociado con la detección del evento.
Descargar clip de video del evento - Descarga de inmediato un clip de video corto del momento del evento, útil para revisión de incidentes o archivo de evidencia.
Haga doble clic en el botón de campana para ajustar el volumen del sonido de notificación.
Exportar e importar configuración de VMS
Esta sección permite exportar, importar y restablecer la configuración del sistema, además de enviar opcionalmente respaldos de configuración a Telegram en intervalos regulares: Menú principal->Configuración->Configuración general->Configuración:
Guardar y cargar configuración
Haga clic en el botón Guardar para exportar la configuración actual a un archivo. Esto es útil para respaldos o para transferir configuración a otro sistema.
Cargar archivo de configuración - Haga clic en el botón … para seleccionar un archivo de configuración guardado previamente en su dispositivo, y luego presione Cargar para importarlo al sistema.
Restablecer a valores predeterminados - Restaura el sistema a su configuración original de fábrica.
⚠️ Advertencia: Esta acción eliminará toda la configuración personalizada y no se puede deshacer.
Enviar configuración a Telegram
Esta función permite enviar automáticamente respaldos de configuración a un chat de Telegram designado usando un bot.
Habilitar/Deshabilitar - Use estos botones para activar o desactivar el envío automático a Telegram.
Token del bot de Telegram - Ingrese el token de API de su bot de Telegram. Este bot debe crearse previamente mediante @BotFather en Telegram.
ID de chat de Telegram - Especifique el ID de chat al que se enviará el archivo de configuración. Puede ser un chat personal o un grupo donde el bot esté agregado como miembro.
Intervalo entre envíos de configuración (minutos) - Define cada cuánto se enviará el archivo de configuración a Telegram.
Notificaciones
Esta sección permite configurar cómo el sistema envía alertas y notificaciones en respuesta a varios eventos o estados del sistema, como alarmas de análisis de video y desconexiones de cámaras. Puede enviar alertas por correo electrónico, Telegram o a un panel de alarmas externo, y también automatizar respuestas personalizadas usando escenarios predefinidos. Vaya a Menú principal->Configuración->Notificaciones:
Enviar eventos por correo electrónico
+ Agregar correo - Haga clic en este enlace para agregar una o más direcciones de correo donde se enviarán notificaciones de eventos. El sistema notificará a estas direcciones según los activadores seleccionados.
Enviar eventos a Telegram
Habilitar / Deshabilitar - Activa o desactiva las notificaciones de eventos por Telegram.
Token del bot de Telegram - Ingrese aquí el token de API de su bot de Telegram. Debe crear el bot primero mediante @BotFather.
ID de chat de Telegram - Especifique el ID de chat donde se enviarán las notificaciones de eventos. Puede ser un chat individual o grupal donde el bot esté presente.
Enviar notificaciones cuando se pierde la conexión de una cámara
Seleccione cómo desea recibir notificaciones si una cámara queda sin conexión:
Correo electrónico - Envía una alerta por correo.
Telegram - Envía un mensaje mediante Telegram.
Panel de alarmas - Envía una señal al panel de alarmas.
Escenarios de automatización
Esta función permite automatizar respuestas a ciertos eventos de cámaras seleccionadas.
Método - Elija entre métodos HTTP como GET o POST para definir cómo se contactará al sistema externo.
URL - Especifique el endpoint que se activará cuando se cumplan las condiciones del escenario (por ejemplo, http://admin:admin@192.168.1.1/...).
Cámaras - Seleccione una o más cámaras que activarán esta automatización.
Eventos - Elija qué eventos (por ejemplo, detección de movimiento, desconexión) activarán el escenario.
Incluir información del evento - Habilite esta opción si desea enviar datos detallados del evento en un archivo JSON.
Eliminar - Haga clic para quitar un escenario.
+ Agregar escenario - Agrega un escenario de automatización nuevo con parámetros personalizados.
Horario
Asigne un horario específico creado previamente a las reglas de automatización o notificación para recibir notificaciones solo durante las horas programadas.
Automatización
El módulo de Automatización en Cluebase VMS permite crear flujos visuales que conectan cámaras, detectores, acciones de usuario, horarios y llamadas API externas. Las automatizaciones pueden usarse para activar acciones automáticamente cuando ocurre un evento específico, como abrir una puerta cuando se reconoce un rostro.
Abrir el editor de Automatización
Para abrir el módulo de Automatización, seleccione Automatización en Menú principal -> Configuración -> Automatización.
El espacio de trabajo de Automatización contiene:
- Un panel izquierdo con escenarios disponibles
- Un campo de búsqueda para encontrar escenarios rápidamente
- Un editor visual de flujo de trabajo
- Un interruptor Encendido / Apagado para habilitar o deshabilitar el escenario seleccionado
- Un botón Agregar bloque para agregar elementos nuevos al flujo
- Un botón Guardar para guardar los cambios
Crear un escenario de automatización nuevo
Para crear un escenario de automatización nuevo:
- En el panel izquierdo, haga clic en el botón +.
- Ingrese el nombre de la automatización.
- Haga clic en Crear.
El escenario nuevo aparecerá en la lista de escenarios del lado izquierdo de la pantalla.
Agregar bloques al flujo de trabajo
Los escenarios de automatización se crean con bloques. Cada bloque representa un objeto, evento, condición o acción dentro del flujo.
Para agregar un bloque:
- Haga clic en + Agregar bloque en la esquina inferior derecha del editor de flujo.
- Seleccione una categoría de bloque.
- Seleccione el elemento requerido de la lista.
- Haga clic en + Agregar bloque en la ventana de selección de bloques.
Las categorías de bloques disponibles incluyen:
Cámaras
Use esta categoría para seleccionar una cámara o grupo de cámaras.
Un bloque de cámara puede usarse como origen para eventos o condiciones de detector.
Detectores
Use esta categoría para agregar eventos de análisis de video al flujo.
Los tipos de eventos de detector disponibles pueden incluir:
- Todos los eventos
- Detección de movimiento
- Reconocimiento facial
- Reconocimiento de placas vehiculares
- Detección de objetos
- Detección de multitudes
- EPP
- Humo e incendio
Los bloques de detector suelen usarse después de un bloque de cámara. Por ejemplo, un flujo puede iniciar con la cámara Gate y continuar cuando se active Reconocimiento facial.
Interacción
Use esta categoría para agregar bloques de interacción, como acciones API.
El bloque API permite que Cluebase VMS envíe una solicitud HTTP a un sistema externo cuando se activa la automatización.
Hora
Use esta categoría para agregar condiciones basadas en tiempo de espera al flujo.
Los bloques de tiempo pueden usarse cuando una automatización debe tener una demora antes de ejecutar otro bloque.
Ejemplo: Abrir una puerta mediante reconocimiento facial
Las capturas muestran un escenario de automatización de ejemplo donde Cluebase VMS envía una solicitud API para abrir una puerta después de un evento de reconocimiento facial.
Paso 1. Crear o seleccionar un escenario
Seleccione un escenario existente en el panel izquierdo o cree uno nuevo con el botón +.
Nombre de escenario de ejemplo:
Open door/gate
Paso 2. Agregar un bloque de cámara
Haga clic en + Agregar bloque, abra la categoría Cámaras y seleccione la cámara requerida.
En este ejemplo, la cámara seleccionada es:
Gate
Haga clic en + Agregar bloque para colocarlo en el lienzo del flujo.
Paso 3. Agregar un bloque de detector
Haga clic de nuevo en + Agregar bloque y abra la categoría Detectores.
Seleccione el evento de detector requerido.
En este ejemplo:
Reconocimiento facial
Haga clic en + Agregar bloque para agregar el detector al flujo.
Paso 4. Agregar un bloque API
Haga clic en + Agregar bloque y abra la categoría Interacción.
Seleccione:
API
Haga clic en + Agregar bloque para colocar el bloque API en el lienzo del flujo.
Paso 5. Configurar el bloque API
Haga clic en el icono de configuración del bloque API.
Se abrirá la ventana Editar bloque.
Configure la solicitud:
- Método: Seleccione el método HTTP, por ejemplo
POST. - URL: Ingrese la URL del endpoint de API.
- Parámetros de consulta: Agregue parámetros opcionales si se requieren.
- Encabezados: Agregue encabezados de solicitud si se requieren.
- Cuerpo: Seleccione el tipo de cuerpo de la solicitud, por ejemplo Carga del evento.
- Autenticación: Seleccione el tipo de autenticación o déjelo como Ninguna.
URL de ejemplo:
http://192.168.1.14/openDoor
Haga clic en Guardar para aplicar la configuración del bloque API.
Conectar bloques
Después de agregar bloques, conéctelos en el orden requerido.
Para conectar bloques:
- Haga clic en el conector de salida del lado derecho del primer bloque.
- Arrastre la línea de conexión al conector de entrada del siguiente bloque.
- Repita el proceso para cada paso siguiente del flujo.
Flujo de ejemplo:
Cámara Gate → Detector de reconocimiento facial → Solicitud API
Esto significa que cuando la cámara seleccionada detecta un evento de reconocimiento facial, Cluebase VMS activará la solicitud API configurada.
Habilitar la automatización
Después de configurar el flujo:
- Cambie el escenario de Apagado a Encendido.
- Haga clic en Guardar.
La automatización solo se ejecutará cuando esté habilitada y guardada.
Guardar cambios
Haga clic en Guardar en la esquina inferior derecha después de crear o editar el flujo.
Los cambios sin guardar pueden perderse si sale de la página o cambia a otro escenario.
Use estos controles para actualizar o quitar elementos del flujo.
Escenario de automatización con botón de cámara
El bloque Botón de cámara permite agregar un botón de automatización personalizado directamente en la barra inferior de la ventana de video de una cámara. Este botón puede ser usado por un operador para activar manualmente una acción de automatización, como abrir una puerta, llamar una API externa, activar un relé o enviar un comando a un sistema de terceros.
Este escenario es útil cuando la automatización debe iniciarse por una acción del usuario en lugar de activarse automáticamente por análisis de video o detección de movimiento.
Caso de uso típico
Un ejemplo común es un escenario de control de puerta.
Un operador observa la cámara Gate. Cuando llega un visitante, el operador puede hacer clic en el botón de automatización en la barra inferior de la ventana de la cámara. Cluebase VMS envía una solicitud API al controlador de la puerta y abre la puerta.
Flujo de ejemplo:
Botón de cámara: Gate → Solicitud API: Open door
Crear una automatización con Botón de cámara
Abra el módulo Automatización y seleccione el escenario requerido en el panel izquierdo, o cree uno nuevo.
Asegúrese de que el escenario esté habilitado cambiándolo de Apagado a Encendido.
Agregar un bloque Botón de cámara
Para agregar un botón de cámara al flujo de automatización:
- Haga clic en + Agregar bloque en la esquina inferior derecha del editor de flujo.
- En la ventana de selección de bloques, seleccione Botones de cámara.
- Elija la cámara donde debe aparecer el botón.
- Haga clic en + Agregar bloque.
Se agregará un bloque nuevo al lienzo del flujo.
Esto significa que el botón de automatización estará disponible en la barra inferior de la ventana de video de la cámara Gate.
Conectar el Botón de cámara a una acción
Después de agregar el bloque Botón de cámara, conéctelo con la acción que debe ejecutarse cuando el usuario haga clic en el botón.
Por ejemplo, conecte el bloque Botón de cámara a un bloque API.
Ejemplo:
Botón de cámara: Gate → API: http://192.168.1.14/openDoor
En este caso, cuando el operador hace clic en el botón de automatización en la cámara Gate, Cluebase VMS envía la solicitud API configurada.
Configurar la acción API
El bloque API debe estar configurado previamente o editarse haciendo clic en el icono de configuración del bloque.
En la configuración del bloque API, configure:
- Método HTTP, por ejemplo
POST - URL del sistema externo
- Parámetros de consulta, si se requieren
- Encabezados, si se requieren
- Tipo de cuerpo
- Tipo de autenticación
URL de ejemplo:
http://192.168.1.14/openDoor
Haga clic en Guardar dentro de la ventana de configuración del bloque después de editar la solicitud API.
Guardar la automatización
Después de crear el flujo:
- Verifique que el bloque Botón de cámara esté conectado al bloque de acción requerido.
- Asegúrese de que el escenario esté en Encendido.
- Haga clic en Guardar en la esquina inferior derecha del editor de flujo.
El botón quedará disponible en la barra inferior de la ventana de video de la cámara seleccionada.
Usar el botón de automatización en la ventana de cámara
Abra la ventana de video de la cámara seleccionada en el bloque Botón de cámara.
En la barra inferior de la ventana de video aparecerá un botón de automatización. El botón usa el icono de automatización.
Cuando el operador haga clic en este botón, se activará el flujo de automatización conectado.
Informes
Cluebase VMS permite crear informes gráficos sobre análisis de video basados en conteo.
Para abrir Informes, vaya a Menú principal -> Informes.
Funciones en la nube
Cluebase VMS contiene las siguientes funciones en la nube:
- Modo nube: optimiza VMS para uso en la nube, evitando tráfico innecesario entre servidores en arquitectura multiservidor y limitando también la conexión de VMS a una cámara.
- Calidad de transmisión en vivo: habilita la transcodificación del lado del servidor de las transmisiones en vivo a una tasa de bits especificada. Esto no afecta la calidad de grabación del archivo. Tenga en cuenta que esta función requiere recursos significativos de CPU.
- Túnel: habilita un túnel seguro entre el servidor y el servicio vCloud.ai CloudLink, lo que permite acceder al servidor local desde cualquier ubicación a través de Internet. Una vez habilitado, la URL de CloudLink se mostrará en pantalla. Asegúrese de usar una contraseña de administrador segura antes de activar el túnel.
Para acceder a la configuración de nube, vaya a Menú principal->Configuración->Configuración general->Nube
Marca
Cluebase VMS permite aplicar marca de usuario: logotipo, título de la aplicación, favicon e imagen de la página de inicio de sesión.
Registros
El menú Registros proporciona herramientas para auditar la actividad del sistema mediante informes detallados de acciones de usuario, cambios de configuración, eventos de cámaras y operaciones del sistema. Esto es esencial para administradores que necesitan monitorear el uso, investigar problemas o mantener cumplimiento.
Vaya a Menú principal->Configuración->Configuración general->Registros. Configure los filtros según lo necesite seleccionando usuarios específicos, periodo de tiempo y tipos de evento. Haga clic en Ver informe de registros para abrir el informe en una pestaña separada o Descargar para obtener la versión de archivo de texto.
Filtros
Menú desplegable Usuario - Seleccione un usuario específico para filtrar registros por actividad asociada con esa cuenta, o elija Todos los usuarios para ver registros de todo el sistema.
Rango de fechas (Desde / Hasta) - Use los selectores de calendario para definir el rango de tiempo de los registros que desea recuperar.
Tipos de evento
Seleccione una o más categorías de acciones registradas para incluir en el informe:
Inicio/cierre de sesión - Acciones de inicio y cierre de sesión de usuarios.
Exportación de archivo - Datos de archivo exportados por usuarios.
Edición de distribución - Cambios en distribuciones de cámaras.
Configuración de análisis - Modificaciones en configuraciones de análisis de video.
Configuración de cámara - Cambios realizados en configuraciones de cámaras.
Cámara desconectada - Registros cuando una cámara deja de estar disponible.
Control PTZ - Operaciones PTZ (Pan-Tilt-Zoom) iniciadas por usuarios.
Reproducción de archivo - Registros cuando se visualiza video archivado.
Notificación de evento - Registros relacionados con eventos y alertas activadas.
Licencia - Activación, actualizaciones o problemas de licencia.
Configuración general - Cambios en preferencias generales del sistema.
Configuración de almacenamiento - Cambios en la configuración de almacenamiento.
Almacenamiento desconectado - Registros cuando los dispositivos de almacenamiento se pierden o se reconectan.
Configuración de usuarios - Modificaciones a cuentas o permisos de usuario.
Todos los eventos - Habilita rápidamente todos los tipos de evento para auditoría completa.
✅ Las casillas marcadas indican qué tipos de registros se incluirán en el informe generado.
Conmutación por error
El menú de Conmutación por error permite a los administradores configurar servidores redundantes que asumen automáticamente las tareas de procesamiento y administración de video si falla un servidor principal. Esto garantiza alta disponibilidad y continuidad del servicio, esenciales en entornos críticos como seguridad y videovigilancia.
Vaya a Menú principal -> Configuración -> Conmutación por error:
Cluebase VMS admite funcionalidad de conmutación por error (hot swap) con las siguientes opciones:
- 1 a 1 - cada servidor del sistema tiene un servidor de conmutación por error.
- Muchos a 1 - varios servidores pueden ser sustituidos en caliente por 1 servidor de conmutación por error.
- Muchos a muchos - varios servidores pueden ser sustituidos en caliente por varios servidores de conmutación por error.
Tenga en cuenta:
- Al usar la funcionalidad de conmutación por error, es importante asegurarse de que se utilice almacenamiento de red (Object storage o NAS).
- El hardware del servidor de conmutación por error debe poder manejar el número requerido de cámaras, por lo que el hardware de estos servidores debe calcularse y configurarse con precisión.
- La configuración se envía automáticamente del servidor principal al servidor de conmutación por error cada 5 minutos.
Configuración:
Para configurar un sistema de conmutación por error necesita al menos 1 servidor principal y 1 servidor de conmutación por error.
Vaya a la interfaz de usuario del servidor principal y abra la configuración de Conmutación por error: Configuración->Conmutación por error->Agregar servidor de conmutación por error, y llene los campos con las credenciales del servidor de conmutación por error. En el campo Lógica, elija el servidor o servidores que deben ser sustituidos en caliente por el servidor de conmutación por error actual. Después haga clic en Guardar.
Opción de restablecimiento de fábrica
La opción Restablecimiento de fábrica permite borrar todos los datos existentes y volver la configuración del sistema a su estado predeterminado original.
Vaya a Menú principal -> Configuración -> Configuración general -> Configuración
Use el botón Restablecer a valores predeterminados para eliminar todos los datos actuales del sistema y restaurar la configuración predeterminada.
Configuración de reinicio automático del servidor
La configuración de reinicio automático del servidor permite programar reinicios periódicos del servidor.
Vaya a Menú principal -> Configuración -> Configuración general -> Configuración de administrador
- Use el botón Habilitar para activar el reinicio automático del servidor.
- Seleccione la frecuencia de reinicio en la lista desplegable (por ejemplo, Cada semana).
Actualizar y reiniciar el servidor
Vaya a Menú principal -> Configuración -> Configuración general -> Información del sistema
Actualizar el sistema
- Use el botón Actualizar ubicado en la parte inferior derecha para actualizar la interfaz y el servidor a la versión más reciente disponible.
Reiniciar el servidor
- Use el botón Reiniciar ubicado en la parte inferior izquierda para reiniciar el servidor.
Soporte técnico
El soporte técnico de vCloud.ai opera 24/7; el tiempo promedio de respuesta es de 3 horas. El soporte técnico puede solicitarse por correo electrónico: support@vcloud.ai