← Volver al catálogo · Portafolio

NetDiag

Ficha del proyecto. Para ver el resto, vuelve al catálogo de proyectos.

🛠️ Self-hosted · AGPL-3.0

NetDiag

Inventario y diagnóstico de red en un binario. Sin telemetría, sin nube y sin servicios externos.

Qué es NetDiag

Escáner de red y monitor de inventario self-hosted. Un único binario Go con interfaz web en español e inglés. No necesita agentes, servicios en la nube ni dependencias en tiempo de ejecución. Guarda todo en SQLite, en tu máquina. Funciona offline.

La idea es simple: descubrir, identificar, almacenar, vigilar, alertar e informar. Está pensado para redes propias, laboratorios y entornos autorizados.

Es beta y se entrega «tal cual», sin garantías. Úsalo solo en redes propias o con autorización explícita del propietario. Tú eliges qué se escanea y respondes por ello.

Qué hace

  • Descubrimiento en tres fases: vecinos ARP e ICMP, barrido TCP y enriquecimiento con DNS inverso, banners, TLS, SNMP y LLDP/CDP.
  • Identidad estable: los hosts se identifican por MAC, no solo por IP. Las notas y etiquetas sobreviven a cambios de dirección. La identidad se separa por sede.
  • Multi-sede: oficinas, plantas o datacenters conviven en una sola base. El mismo CIDR puede repetirse en sedes distintas. Cada sede se puede exportar e importar.
  • Inventario y topología: fabricante por OUI, tipo de dispositivo, sistema operativo probable, puertos, servicios, certificados y modelo SNMP. El mapa L2/L3 se dibuja en SVG con zoom y agrupación por subred.
  • Diagnósticos: lazos STP, fugas de VLAN, desajustes de dúplex, problemas de MTU, tormentas de broadcast, AP no autorizados, cambios de gateway y certificados por caducar. Cada hallazgo incluye evidencia, confianza y limitaciones.
  • Vigilancia: escaneos programados, hosts nuevos o caídos, histórico de latencia y reglas de alerta con deduplicación y cooldown.
  • Informes y auditoría: PDF, CSV, JSON y HTML. Líneas base manuales por sede y comparación entre dos ventanas de tiempo.
  • Operación: tres roles (admin, operator, viewer), API OpenAPI 3.1, métricas Prometheus, copias ZIP y exportación de eventos a syslog, webhooks firmados y otras plataformas.

Los diagnósticos infieren de tablas e históricos. Son pistas para investigar, no una confirmación protocolaria de un ataque. La captura pasiva es opcional y solo guarda metadatos.

Capturas

Panel principal de NetDiag con métricas de la red
Panel principal
Inventario de dispositivos de NetDiag
Inventario de dispositivos
Mapa de topología L2 y L3 de NetDiag
Topología L2/L3
Hallazgos de diagnósticos con evidencia y confianza
Diagnósticos
Listado de alertas de NetDiag
Alertas
Generación de informes de NetDiag
Informes
Vista de detalle de NetDiag
Vista de detalle

Capturas con datos de ejemplo.

Cómo empezar

Necesitas Go 1.27 o superior. Para ARP activo, también libpcap-dev y gcc.

git clone https://github.com/kr3s4l4/netdiag.git
cd netdiag
make build
./bin/netdiag serve      # http://127.0.0.1:8080

En el primer acceso se crea la cuenta de administrador. Después se elige la sede, se añade la subred a monitorizar y se lanza el primer escaneo. El asistente de arranque puede omitirse.

La configuración vive en ~/.config/netdiag/config.yaml y los datos en ~/.local/share/netdiag.

Privacidad y seguridad

No hay telemetría. El binario no informa de nada a ningún servidor. Tú decides qué se guarda y qué se comparte.

  • Contraseñas con Argon2id, sesiones en servidor, CSRF y límite de intentos.
  • Cabeceras CSP y HSTS, auditoría de acciones y secretos cifrados con AES-256-GCM.
  • Copias de seguridad ZIP con la base, la configuración y la clave local.
  • Informes, diffs y snapshots se pueden empaquetar en contenedores .ndc: un ZIP con manifiesto, ficheros originales y firma minisign. La firma se verifica en local y usa una clave distinta de la de release.

Licencia y modelo

NetDiag es software libre bajo AGPL-3.0 y gratuito. No hay cuenta online, licencia online ni DRM. No hay soporte formal. La única cuenta es la de administrador local que se crea al arrancar.

Puedes usar, estudiar, modificar y redistribuir el programa. Si lo distribuyes, conserva los avisos de copyright y entrega la AGPL. Si ejecutas una versión modificada y la ofreces a otros usuarios a través de una red, la sección 13 de la AGPL exige ofrecerles el código fuente correspondiente. No hay cláusula de telemetría ni restricción de uso competitivo.

El binario sabe leer un fichero de licencia firmado con Ed25519. La comprobación es local: no contacta con ningún servidor. Es una capacidad técnica, sin servicios externos ni bloqueo. No activa funciones premium, no bloquea escaneos ni informes y nunca borra datos.

Las contribuciones se aceptan bajo DCO, sin CLA. Los avisos de dependencias de terceros están en NOTICE y THIRD_PARTY_LICENSES.md.

Release y soporte

La última release publicada es v1.5.2. Incluye binarios para amd64 y arm64, SHA256SUMS, SBOM CycloneDX, atestación de procedencia y firma minisign con la clave pública c98b13d8c8f73259. Los hashes se pueden comprobar antes de ejecutar nada.

No hay SLA ni soporte formal. Los errores y las preguntas técnicas van a GitHub Issues. Las preguntas generales, a GitHub Discussions. Las vulnerabilidades se reportan por el canal privado descrito en SECURITY.md.

Enlaces