Ceelimp Monitoreo

Documentación completa del proyecto: cómo se construyó, paso a paso, con los errores reales que aparecieron y cómo se resolvieron. Pensada para seguirse sin conocimientos previos.

Guía de instalación · Desarrollado por HYSSOTEC

1Qué es y cómo nació

Ceelimp Monitoreo es un panel web propio, instalado en una laptop de la oficina, que reúne en un solo lugar las cámaras, el control de accesos (relojes de huella y tarjeta), la administración de las computadoras y TV, el control de la red y el WiFi, y una medición de ocupación de la oficina con inteligencia artificial. Se entra con usuario y contraseña, desde el celular o la computadora, dentro y fuera de la oficina, sin pagar mensualidad y sin que la información salga a internet.

De dónde partió

Todo empezó con un problema concreto: el DVR Hikvision de las cámaras aparecía Desconectado (0xe0000105) y no se podía ver por la app Hik-Connect. La meta inicial era simple: ver las cámaras desde fuera de la oficina sin depender de la app del fabricante. Al resolverlo, el proyecto creció hasta convertirse en una plataforma que administra casi toda la oficina.

Idea centralUna sola laptop encendida hace de "servidor". Habla con los equipos por la red local y publica un panel web. Desde fuera se entra por un túnel cifrado (Tailscale), sin abrir puertos en el router.

2Lo que necesitas (y alternativas baratas)

ElementoLo que usamosAlternativa más barata
ServidorLaptop Intel Core i5 (10.ª gen), 16 GB RAMPara solo cámaras: Raspberry Pi 4 (4 GB) o un mini-PC usado. Para IA y ocupación sí conviene un i5/i3 con 8 GB.
CámarasDVR Hikvision + 6 cámaras analógicasLas que ya tengas. Cámaras IP ONVIF nuevas también sirven.
Control de acceso2 relojes ZKTeco MA300 + lectores FR1200Cualquier reloj ZKTeco con red (puerto 4370).
RedSwitch Cisco administrable + access points TP-Link (Omada)Un switch administrable económico (TP-Link) y EAP sueltos; el controlador Omada se instala gratis en la misma laptop.
Acceso remotoTailscale (plan personal gratis)Cloudflare Tunnel (gratis) si prefieres un enlace con tu dominio.
SistemaWindows 10 Pro + Hyper-V + Ubuntu Server (máquina virtual)Si la laptop se puede dedicar: instalar Ubuntu Server directo, sin Windows ni máquina virtual (más liviano).
Lo más económico posibleSi solo quieres ver cámaras desde fuera: una Raspberry Pi 4, el panel y Tailscale. Cero mensualidad. Los módulos de accesos, red, equipos e IA se activan después, cuando los necesites.

3Cómo funciona todo junto

El panel está hecho en Python (servidor web) con go2rtc para el video, y corre como servicio en Ubuntu. Los módulos hablan con cada equipo por su protocolo:

Desde fuera, Tailscale crea una red privada cifrada y da el candado HTTPS. Las alertas salen por Telegram.

AParte A — Arreglar el DVR Hikvision

El DVR (modelo un DVR Hikvision con firmware antiguo) no conectaba a la plataforma. El diagnóstico reveló varios problemas encadenados.

A.1 — El problema de fondo: sin puerta de enlace ni DNS

En Red → Ajustes básicos → TCP/IP el DVR mostraba la IP correcta, pero la Pasarela (gateway) estaba en 0.0.0.0 y los campos DNS vacíos. Sin gateway ni DNS, el DVR no tiene salida a internet y nunca llega a la plataforma. Por eso el estado era "Desconectado".

ErrorLa web "guardaba" pero no aplicaba el DNSAl escribir los DNS en la web del DVR salía "Guardado correcto", pero al recargar los campos volvían vacíos. Esta versión de firmware ignora ese cambio desde la web. Solución: se arregló más abajo, con el reset y DHCP.
ErrorNo dejaba activar DHCP desde la web ni desde el menúLa casilla DHCP aparecía en gris. Causa: el DVR estaba dentro del asistente de configuración inicial (el botón de abajo decía "Siguiente", no "Aplicar"), donde esos campos quedan bloqueados.

A.2 — La solución: restaurar valores de fábrica

Como la configuración de red estaba trabada, se restauró el DVR:

  1. En la web del DVR: Mantenimiento → Predeterminado → "Por defecto" (la opción "Restaurar" NO sirve porque deja intactos los parámetros de IP, que eran justo el problema).
  2. El DVR se reinició y pidió crear de nuevo la contraseña de administrador.
  3. En el asistente, paso de red, se activó DHCP y "Obtener DNS automáticamente".
ResueltoCon DHCP, el router entregó todo soloEl DVR tomó automáticamente IP, gateway 192.168.1.1 y los DNS del proveedor (8.8.8.8 / 1.1.1.1). Las grabaciones del disco no se borran con "Por defecto"; solo se pierde la configuración.

A.3 — Hik-Connect quedó vinculado a otra cuenta

Al intentar vincular el DVR a una cuenta Hik-Connect, salió que el equipo ya pertenecía a otra cuenta (la del instalador anterior). El reset de fábrica no libera ese vínculo porque vive en la nube de Hikvision, y este firmware antiguo no permite desvincularlo desde la app.

No hace falta Hik-ConnectEl panel lee las cámaras directo por la red local (RTSP), así que funciona aunque el DVR siga vinculado a otra cuenta. Para liberarlo del todo, hay que pedírselo al dueño de esa cuenta, actualizar el firmware, o escribir a soporte Hikvision con el número de serie del DVR (está en su etiqueta) y la factura.

A.4 — El video se veía verde y con bloques

Al agregar las cámaras al panel, se veían corruptas (verde, mosaicos). Se comprobó con VLC (rtsp://admin:CLAVE@192.168.1.20:554/Streaming/Channels/101) que también salía mal, así que el problema estaba en el DVR, no en el panel.

ErrorCausa: el "Cifrado de transmisión" de Hik-ConnectEn el asistente quedó marcada la casilla Stream Encryption, que cifra el video. Cualquier programa que no sea de Hikvision recibe datos que parecen video roto.
Solución: en el menú del DVR, Red → Acceso a plataforma, se desmarcó Cifrado de transmisión (o se desactivó Hik-Connect). Al instante VLC y el panel mostraron la imagen limpia.
Además: usar H.264El stream principal y el secundario de cada canal deben estar en H.264 (no H.265), porque los navegadores no reproducen bien H.265. Se configura en Vídeo y audio → Vídeo.

BParte B — Preparar la laptop (Hyper-V)

La laptop tenía Windows 10 Pro, que incluye Hyper-V (el virtualizador de Windows). Se usó una máquina virtual para que Windows siga funcionando mientras Ubuntu corre en segundo plano. (Si la laptop se puede dedicar por completo, es más simple instalar Ubuntu directo.)

B.1 — Activar Hyper-V

Error"Windows no puede encontrar el archivo Hyper-V"Salió al escribir Hyper-V en la ventana Ejecutar. Esa no es la forma. Solución: Ejecutar (Windows + R) → escribir optionalfeatures → marcar Hyper-V. O en PowerShell como administrador:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

B.2 — Crear la red de la máquina virtual

Para que la máquina virtual vea el DVR y los relojes, debe estar en la misma red. Se crea un "conmutador externo" sobre la tarjeta de red real:

Error"No se encontró el adaptador de red físico vEthernet"Se intentó usar vEthernet, que es una tarjeta virtual, no real. Solución: primero ver el nombre real con Get-NetAdapter (la que diga Up, normalmente Ethernet) y usar ese:
Get-NetAdapter
New-VMSwitch -Name LAN -NetAdapterName "Ethernet" -AllowManagementOS $true
AvisoAl crear el conmutador, la red de la laptop se corta unos segundos. Si estás conectado por AnyDesk o Escritorio remoto, reconéctate; vuelve sola.

B.3 — Crear la máquina virtual (por PowerShell)

$vm = "Ceelimp-Monitoreo"
New-Item -ItemType Directory -Force C:\HyperV | Out-Null
New-VM -Name $vm -Generation 2 -MemoryStartupBytes 4GB -NewVHDPath "C:\HyperV\$vm.vhdx" -NewVHDSizeBytes 40GB -SwitchName LAN
Set-VMProcessor $vm -Count 4
Add-VMDvdDrive -VMName $vm -Path "$env:USERPROFILE\Downloads\ubuntu-26.04.1-live-server-amd64.iso"
Set-VMFirmware $vm -SecureBootTemplate MicrosoftUEFICertificateAuthority -FirstBootDevice (Get-VMDvdDrive $vm)
Set-VM $vm -AutomaticStartAction Start -AutomaticStartDelay 30 -AutomaticStopAction ShutDown -CheckpointType Disabled
Start-VM $vm
vmconnect localhost $vm
ImportanteGeneración 2 y la plantilla de arranque seguro "Entidad de certificación UEFI de Microsoft"; sin eso, Ubuntu no arranca. Inicio automático para que la máquina virtual vuelva sola cuando Windows se reinicie.

B.4 — La caída de memoria

Error"KERNEL PANIC — System is deadlocked on memory"El instalador de Ubuntu se cayó. Causa: Hyper-V tenía memoria dinámica y le bajó la RAM a ~1,5 GB; el instalador no entra con tan poca. Solución: memoria fija de 6 GB para instalar.
Stop-VM Ceelimp-Monitoreo -TurnOff
Set-VMMemory Ceelimp-Monitoreo -DynamicMemoryEnabled $false -StartupBytes 6GB
Start-VM Ceelimp-Monitoreo

Después de instalar, se puede bajar a 4 GB (con la máquina apagada).

CParte C — Instalar Ubuntu Server

  1. Descargar Ubuntu Server 24.04 o 26.04 LTS desde ubuntu.com/download/server (archivo .iso, ~3 GB). No abrirlo; se elige en Hyper-V.
  2. Arrancar la máquina virtual → Try or Install Ubuntu Server.
  3. Idioma English, teclado Spanish (Latin American) (o dejar English, da igual porque luego se maneja por SSH).
  4. Red: en eth0 → Edit IPv4 → Manual, poner una IP fija.
  5. Proxy: vacío. Mirror: esperar la prueba y Done.
  6. Storage: "Use an entire disk" (es el disco virtual de 40 GB; Windows no se toca).
  7. Usuario y contraseña (¡anotarlos!). Marcar Install OpenSSH server.
  8. Reboot. Cuando aparezca panel login:, está listo.
ErrorConflicto de IPSe pensó usar 192.168.1.90, pero al hacerle ping desde Windows respondía: ya estaba en uso. Solución: elegir una IP libre (se usó 192.168.1.50). Siempre verificar con ping antes; "Host de destino inaccesible" o "Tiempo agotado" = libre.
Datos de red usadosEjemplo (usa el rango de tu red): servidor 192.168.1.50 · gateway 192.168.1.1 · DNS 8.8.8.8, 1.1.1.1 · DVR 192.168.1.20. Cambia estos números por los de tu oficina.

DParte D — Instalar el panel

Desde Windows, en PowerShell, se copia el paquete del panel a Ubuntu y se instala.

cd $HOME\Downloads
scp ceelimp-panel.tar.gz usuario@192.168.1.50:~
ssh usuario@192.168.1.50
Error"REMOTE HOST IDENTIFICATION HAS CHANGED"Aparece al conectar desde una PC que antes se conectó a esa misma IP (otro equipo). Es una protección de SSH, no un ataque. Solución: borrar la huella vieja y reconectar:
ssh-keygen -R 192.168.1.50
scp ceelimp-panel.tar.gz usuario@192.168.1.50:~

Ya dentro de Ubuntu (usuario@panel:~$):

tar xzf ceelimp-panel.tar.gz
cd ceelimp-panel
sudo bash install.sh

El instalador pide la contraseña de Ubuntu, crea el usuario y contraseña del panel, instala todo (go2rtc, IA, escritorio remoto, Tailscale) y deja la laptop sin suspenderse.

Mensajes amarillos/rojos de "pip"Durante la instalación aparecen avisos de pyopenssl / cryptography y un DEPRECATION. No son errores: la instalación continúa y el panel funciona. Son choques de versiones de librerías que el panel no usa.
Para actualizar en el futuroCopiar la nueva versión y volver a ejecutar sudo bash install.sh. Se conservan usuarios, cámaras, relojes y toda la configuración.

EParte E — Acceso desde fuera (Tailscale)

Tailscale crea una red privada cifrada entre tus dispositivos y da HTTPS automático, sin abrir puertos en el router (que además es del proveedor).

Error"Trial 14 days left"Al registrarse con el correo de empresa (@ceelimp.com.pe), Tailscale lo tomó como uso empresarial y activó una prueba de pago de 14 días. Solución: se volvió a vincular el servidor con una cuenta de Gmail, que usa el plan personal gratis:
sudo tailscale logout
sudo tailscale up --hostname=panel-monitoreo
# abrir el enlace que aparece e iniciar sesión con Gmail

Luego, para el candado HTTPS y el acceso:

sudo tailscale serve --bg 8080      # HTTPS privado (con la app Tailscale)
sudo tailscale funnel --bg 8080     # enlace público (solo protegido por el login del panel)
Alternativa gratis para empresaSi prefieres un enlace con tu propio dominio (camaras.ceelimp.com.pe) y sin app, se puede usar Cloudflare Tunnel en lugar de Tailscale. Ambos son gratis.

FParte F — Configurar cada módulo

Cámaras

Cámaras → Agregar DVR / NVR Hikvision: IP 192.168.1.20, usuario admin y clave. "Buscar canales", marcar del 1 al 6 (desmarcar 7 y 8, que son los vacíos) y agregar. Si alguna no se ve, revisar que esté en H.264 y que el cifrado esté desactivado (ver A.4).

Control de accesos (relojes ZKTeco)

Accesos → Relojes → Agregar: IP, puerto 4370 y clave de comunicación (normalmente 0). "Importar usuarios" trae a las personas que ya están en el reloj. Para una persona nueva: código, nombre, tarjeta → "Guardar y enviar". La huella se registra con el botón "Huella" (el reloj pide el dedo 3 veces) y el panel la copia sola a los otros relojes.

Lectores FR1200Cada MA300 tiene un lector FR1200 conectado por cable (sin IP propia). Las huellas y tarjetas que envías al MA300 sirven también en su FR1200. Cierra el software ZKTeco de Windows mientras usas el panel: el reloj acepta una sola conexión a la vez.

Equipos y escritorio remoto

Equipos → Agregar: nombre, tipo (PC Windows, TV LG…), IP y MAC. Para PCs, usuario y contraseña de Windows. Con la MAC puesta, el panel sigue al equipo aunque el router le cambie la IP. Para el escritorio remoto: en Windows Pro activar Configuración → Sistema → Escritorio remoto; en Windows Home instalar TightVNC y elegir "VNC". Para apagar por SSH, instalar el "Servidor OpenSSH" de Windows. Para encender, Wake-on-LAN en BIOS y tarjeta de red.

Red (WiFi, switch, impresoras)

Red → WiFi (Omada): conectar el controlador Omada (OC200 o el software en la misma laptop con sudo bash instalar-omada.sh) para ver quién está en el WiFi y bloquearlo. Switch: activar SNMP (snmp-server community LECTURA RO y ESCRITURA RW) para ver y apagar puertos. Impresoras: con SNMP muestran tóner y estado. Portales: accesos directos a la central de telefonía y al proveedor.

Ocupación y aforo (estudio)

Ocupación: dibujar un recuadro por escritorio con el nombre de la persona, y una línea en la puerta para contar entradas/salidas. Requiere la IA activada en esas cámaras. Reporte a Excel por día.

La temperatura del Dashboard sale "no disponible"Es normal: dentro de una máquina virtual no existe el sensor de temperatura del procesador. CPU, RAM y disco sí se miden. No es un error.

4Tabla de errores y soluciones

SíntomaCausaSolución
DVR "Desconectado (0xe0000105)"Sin gateway ni DNS (0.0.0.0)Reset "Por defecto" + activar DHCP
La web del DVR guarda el DNS pero no lo aplicaFirmware antiguo lo ignoraUsar DHCP tras el reset
No deja activar DHCP (casilla gris)Estás en el asistente inicialSalir del asistente / reset de fábrica
Cámaras en verde o con bloquesCifrado de transmisión de Hik-ConnectDesmarcar "Cifrado de transmisión" en el DVR
Cámara no carga en el navegadorVideo en H.265Pasar a H.264 en el DVR
No se puede vincular a Hik-ConnectDVR atado a otra cuentaNo se necesita; el panel lee local
"Windows no puede encontrar Hyper-V"Palabra mal escrita en Ejecutaroptionalfeatures
"No se encontró adaptador vEthernet"Nombre de tarjeta equivocadoGet-NetAdapter → usar "Ethernet"
KERNEL PANIC al instalar UbuntuMemoria dinámica muy bajaRAM fija 6 GB
Conflicto de IPIP ya en usoping antes; elegir una libre
"REMOTE HOST IDENTIFICATION CHANGED"Huella SSH vieja de otra PCssh-keygen -R IP
Avisos de pip al instalarChoque de versiones no usadasIgnorar; el panel funciona
Tailscale "Trial 14 days"Registro con correo de empresaRevincular con Gmail (plan personal)
Temperatura "no disponible"Está en máquina virtualNormal; no es error
La IP de una PC cambiaRouter con DHCP dinámicoPoner la MAC (seguimiento) o IP fija

5Costos y qué puedes reemplazar

FunciónLo usado (costo)Alternativa
Ver cámaras remotoPanel + Tailscale — gratisApp del fabricante (atado a su nube)
Escritorio remotoApache Guacamole — gratisAnyDesk / TeamViewer (de pago para empresa)
Acceso desde fueraTailscale personal — gratisCloudflare Tunnel (gratis) · VPN del router
AlertasTelegram — gratisCorreo / WhatsApp Business (API de pago)
IA de personasYOLOX local — gratisServicios de IA en la nube (mensualidad)
Controlador WiFiOmada software en la laptop — gratisOC200/OC300 (hardware, ~US$ 100)
Registrar huellasDesde el panel — gratisLector USB ZK9500 (~US$ 60) si el reloj no acepta registro remoto
ServidorLaptop existenteRaspberry Pi 4 (~US$ 60) para solo cámaras
Resumen de costoTodo el software es gratis y sin mensualidad. El único gasto posible es hardware opcional: un lector de huellas USB o un controlador Omada físico, solo si los necesitas.

6Mantenimiento

TareaComando (en la ventana SSH del servidor)
Ver si hay errores del panelsudo journalctl -u ceelimp-panel -f
Reiniciar el panelsudo systemctl restart ceelimp-panel
Reiniciar el videosudo systemctl restart ceelimp-go2rtc
Actualizar a una versión nuevacopiar el nuevo .tar.gz y sudo bash install.sh
Respaldo de la configuracióncopiar la carpeta /opt/ceelimp (usuarios, cámaras, relojes, huellas)
Alertas de Telegramsudo /opt/ceelimp/venv/bin/python /opt/ceelimp/app.py telegram
La laptop debe quedar encendidaEl panel vive en la laptop, así que debe estar encendida y con Windows iniciado. Ya quedó configurada para no suspenderse al cerrar la tapa. Cuando Windows Update la reinicie, la máquina virtual arranca sola.

Usar las cámaras y la ocupación para controlar el trabajo está permitido, pero con condiciones de la Ley N.° 29733 (Protección de Datos Personales) y la Directiva N.° 01-2020-JUS/DGTAIPD de videovigilancia:

NotaEsta es una orientación general, no asesoría legal. El panel procesa todo localmente y no usa reconocimiento facial; mide por puesto y por tarjeta.