Primer inicio
Al lanzar TraceWall Desktop por primera vez, la aplicación realiza una serie de pasos de inicialización y te guía a través de la configuración esencial.
Secuencia de arranque
- Comprobación de integridad — Verifica firma del binario (si existe) y consistencia de archivos internos.
- Inicialización de base de datos — Crea/abre
tracewall.db en el directorio de datos local; ejecuta migraciones de esquema si es versión nueva.
- Carga de configuración — Lee
config.json (ajustes de usuario, sensor, ARGUS, integraciones, retención, UI).
- Inicio de sensor local — Lanza el colector de telemetría en background; primera muestra en < 5 s.
- Comprobación ARGUS — Si está habilitado en Settings:
- Verifica existencia de modelo GGUF en
models/
- Si falta: descarga desde Hugging Face (requiere internet) o muestra aviso para colocación manual
- Inicia motor
llama.cpp en loopback (127.0.0.1:puerto-aleatorio)
- Health check:
/health responde 200 OK
- Carga de integraciones — Para cada integración configurada: valida credenciales (descifrado DPAPI/libsecret), prueba conectividad, programa polling.
- Render de UI — Ventana principal muestra Command Center con tarjetas de estado.
Pantalla de bienvenida (si es primera ejecución absoluta)
| Paso | Acción | Opcional |
|---|
| 1 | Seleccionar idioma (ES/EN) | No |
| 2 | Aceptar términos de uso y política de privacidad local | No |
| 3 | Elegir modo de telemetría: Solo local / Local + integraciones | Sí (cambiable luego en Settings) |
| 4 | Configurar ARGUS: Habilitar ahora / Después | Sí |
| 5 | Revisar resumen de conexiones salientes (ver Privacidad) | No |
Qué verás tras el primer arranque
Command Center (vista principal)
- Tarjeta Sensor Local: estado verde/amarillo/rojo, última muestra, uptime host
- Tarjeta Inventario: conteo de activos, interfaces, subredes, servicios
- Tarjeta Topología: miniatura de grafo (gateway + segmentos)
- Tarjeta Exposición: último perfil ejecutado, hallazgos críticos/altos
- Tarjeta Eventos: últimos 10 eventos, severidad, fuente
- Tarjeta ARGUS: estado motor (detenido/iniciando/listo/error), último brief generado
- Tarjeta Integraciones: chips por conector (verde=conectado, amarillo=degradado, rojo=error)
Barra lateral izquierda (navegación)
- Command Center — Dashboard operativo
- Assets & Inventory — Tabla filtrable de activos
- Network Topology — Grafo interactivo
- Exposure Intelligence — Perfiles, hallazgos, evidencia
- Events / SIEM — Buffer de eventos con búsqueda
- Incidents — Gestión de incidentes (si habilitado)
- SOC Workbench — Herramientas de investigación
- Local Sensor — Panel detallado de telemetría del host
- ARGUS Workspace — Chat operativo, briefs, historial
- Settings — Configuración global
Primeras comprobaciones recomendadas
| Verificación | Dónde | Qué buscar |
|---|
| Sensor activo | Local Sensor / Command Center | Interfaces con IP/MAC, gateway detectado, procesos/servicios listados |
| Inventario poblado | Assets & Inventory | > 0 activos, confidence > 0.5, reachable = true para host local |
| Topología renderizada | Network Topology | Nodo gateway + al menos una subred |
| ARGUS listo | ARGUS Workspace / Command Center | Estado “Listo” (motor iniciado, modelo cargado) o “Detenido” (si no habilitado) |
| Integraciones | Settings → Integraciones | Cada una con estado “Conectado” o error explicado |
| Logs limpios | Settings → Logs / %LOCALAPPDATA%\TraceWall\logs\ | Sin errores ERROR o FATAL en arranque |
Problemas comunes en primer inicio
| Síntoma | Causa probable | Acción |
|---|
| Ventana en blanco / no carga UI | Fallo renderer (GPU/driver) | Lanzar con --disable-gpu o actualizar drivers GPU |
| Sensor muestra “Sin datos” | Permisos / Npcap (Windows) | Verificar Npcap instalado (modo WinPcap API-compatible); ejecutar como admin una vez para registrar driver |
| ARGUS “Modelo no encontrado” | Modelo no descargado | Settings → ARGUS → Descargar modelo, o colocar .gguf manualmente en models/ |
| Integración “Error TLS” | Certificado autofirmado en target | Settings → Integración → “Aceptar certificados no válidos” (solo lab) o importar CA |
| Ventana SmartScreen (Windows) | Instalador sin certificado EV | Verificar checksum → “Más info” → “Ejecutar de todos modos” |
Próximos pasos
- Recorrido de la interfaz — Entender cada módulo y navegación
- Estado del sensor local — Validar telemetría completa
- Configuración inicial — Ajustar retención, logs, polling, ARGUS
- Diagnóstico inicial — Verificar salud completa del sistema
Páginas relacionadas