zeek-peek
Zeek-peek es un agente log viewer sin agent que extrae logs de Zeek a DuckDB y sirve una interfaz web rápida, ideal para pfSense/OPNsense o hardware pequeño.
Ficha actualizada 22 sept 2026, 22:55 · upstream 22 sept 2026, 22:28 · release v0.1.0
Qué es zeek-peek
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Zeek ya monitoriza tu red; zeek-peek simplemente facilita la lectura de sus logs. Conecta al sensor mediante SSH, almacena los registros en un archivo DuckDB inmemorable y sirve una interfaz web rápida sin instalar agentes ni SIEMs adicionales. Funciona con pfSense/OPNsense, Netgate, Protectli, Raspberry Pi, mini-PCs y contenedores LXC.
- Visualización de logs de Zeek en un firewall pequeño (Netgate 1100, NUC, VM) sin necesidad de graficar los datos
- Consolidación de logs de múltiples sensores de Zeek en una sola interfaz web
- Análisis rápido de patrones de tráfico sin depender de herramientas externas como Grafana o SIEMs
- Despliegue ligero y autocontenido para entornos con hardware limitado (Raspberry Pi, LXC)
- Monitoreo de logs de Zeek en infraestructuras pequeñas donde el uso de graficos es ineficiente
- No requiere agente ni instalación adicional: solo se conecta vía SSH a los logs existentes
- Utiliza DuckDB para persistencia de datos, permitiendo consultas rápidas y persistencia en memoria
- Sistema ligero con un único proceso que no consume recursos adicionales del sensor
- Soporta múltiples plataformas (pfSense, OPNsense, Netgate, Protectli, Raspberry Pi)
- Configuración mínima mediante archivo .env: solo se requieren SSH_HOST y SSH_USER
- No soporta logs en formato JSON por defecto; requiere configuración manual de archivos log
- La persistencia de datos depende del tamaño del disco local (DuckDB no tiene backup automático)
- El rendimiento puede verse afectado por el uso simultáneo de múltiples conexiones SSH
- No incluye autenticación integrada: debe configurarse un usuario SSH con permisos adecuados
- La persistencia en DuckDB puede ser ineficiente en entornos con mucho tráfico de logs
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instala el proyecto en tu máquina local, configura los parámetros de conexión (SSH_HOST, SSH_USER) y ejecuta uvicorn main:app. Para producción, despliega en un contenedor Docker con persistencia de datos en volumen o disco. Configura el firewall para permitir la conexión SSH al puerto 22 del sensor Zeek. No se recomienda usar múltiples workers en el servidor web; el único proceso debe manejar tanto el frontend como el backend DuckDB.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.