
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.
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.
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.
| Elemento | Lo que usamos | Alternativa más barata |
|---|---|---|
| Servidor | Laptop Intel Core i5 (10.ª gen), 16 GB RAM | Para 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ámaras | DVR Hikvision + 6 cámaras analógicas | Las que ya tengas. Cámaras IP ONVIF nuevas también sirven. |
| Control de acceso | 2 relojes ZKTeco MA300 + lectores FR1200 | Cualquier reloj ZKTeco con red (puerto 4370). |
| Red | Switch 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 remoto | Tailscale (plan personal gratis) | Cloudflare Tunnel (gratis) si prefieres un enlace con tu dominio. |
| Sistema | Windows 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). |
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.
El DVR (modelo un DVR Hikvision con firmware antiguo) no conectaba a la plataforma. El diagnóstico reveló varios problemas encadenados.
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".
Como la configuración de red estaba trabada, se restauró el DVR:
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.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.
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.
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.)
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
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:
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
$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
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).
ubuntu.com/download/server (archivo .iso, ~3 GB). No abrirlo; se elige en Hyper-V.eth0 → Edit IPv4 → Manual, poner una IP fija.panel login:, está listo.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.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.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
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.
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.sudo bash install.sh. Se conservan usuarios, cámaras, relojes y toda la configuración.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).
@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)
https://panel-monitoreo.tu-red.ts.net.camaras.ceelimp.com.pe) y sin app, se puede usar Cloudflare Tunnel en lugar de Tailscale. Ambos son gratis.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).
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.
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 (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: 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.
| Síntoma | Causa | Solució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 aplica | Firmware antiguo lo ignora | Usar DHCP tras el reset |
| No deja activar DHCP (casilla gris) | Estás en el asistente inicial | Salir del asistente / reset de fábrica |
| Cámaras en verde o con bloques | Cifrado de transmisión de Hik-Connect | Desmarcar "Cifrado de transmisión" en el DVR |
| Cámara no carga en el navegador | Video en H.265 | Pasar a H.264 en el DVR |
| No se puede vincular a Hik-Connect | DVR atado a otra cuenta | No se necesita; el panel lee local |
| "Windows no puede encontrar Hyper-V" | Palabra mal escrita en Ejecutar | optionalfeatures |
| "No se encontró adaptador vEthernet" | Nombre de tarjeta equivocado | Get-NetAdapter → usar "Ethernet" |
| KERNEL PANIC al instalar Ubuntu | Memoria dinámica muy baja | RAM fija 6 GB |
| Conflicto de IP | IP ya en uso | ping antes; elegir una libre |
| "REMOTE HOST IDENTIFICATION CHANGED" | Huella SSH vieja de otra PC | ssh-keygen -R IP |
| Avisos de pip al instalar | Choque de versiones no usadas | Ignorar; el panel funciona |
| Tailscale "Trial 14 days" | Registro con correo de empresa | Revincular con Gmail (plan personal) |
| Temperatura "no disponible" | Está en máquina virtual | Normal; no es error |
| La IP de una PC cambia | Router con DHCP dinámico | Poner la MAC (seguimiento) o IP fija |
| Función | Lo usado (costo) | Alternativa |
|---|---|---|
| Ver cámaras remoto | Panel + Tailscale — gratis | App del fabricante (atado a su nube) |
| Escritorio remoto | Apache Guacamole — gratis | AnyDesk / TeamViewer (de pago para empresa) |
| Acceso desde fuera | Tailscale personal — gratis | Cloudflare Tunnel (gratis) · VPN del router |
| Alertas | Telegram — gratis | Correo / WhatsApp Business (API de pago) |
| IA de personas | YOLOX local — gratis | Servicios de IA en la nube (mensualidad) |
| Controlador WiFi | Omada software en la laptop — gratis | OC200/OC300 (hardware, ~US$ 100) |
| Registrar huellas | Desde el panel — gratis | Lector USB ZK9500 (~US$ 60) si el reloj no acepta registro remoto |
| Servidor | Laptop existente | Raspberry Pi 4 (~US$ 60) para solo cámaras |
| Tarea | Comando (en la ventana SSH del servidor) |
|---|---|
| Ver si hay errores del panel | sudo journalctl -u ceelimp-panel -f |
| Reiniciar el panel | sudo systemctl restart ceelimp-panel |
| Reiniciar el video | sudo systemctl restart ceelimp-go2rtc |
| Actualizar a una versión nueva | copiar el nuevo .tar.gz y sudo bash install.sh |
| Respaldo de la configuración | copiar la carpeta /opt/ceelimp (usuarios, cámaras, relojes, huellas) |
| Alertas de Telegram | sudo /opt/ceelimp/venv/bin/python /opt/ceelimp/app.py telegram |
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: