CLI/Guía de operaciones sin cabeza

1. Componentes

Se ejecuta una implementación sin cabeza en el demonio + roamswitch CLI (más roamswitch-mcp si se desea). Todos los mecanismos de defensa autónomos funcionan sin ninguna GUI.

2. Daemon (servicios systemd)

Edición de cliente

sudo systemctl status  roamswitch.service      # Estado de funcionamiento
sudo systemctl enable  roamswitch.service      # Inicio automático al arrancar (habilitado en la instalación)
sudo systemctl restart roamswitch.service      # Reiniciar
journalctl -u roamswitch.service -f            # Seguir registros
journalctl -u roamswitch.service --since "1h ago"

Lo que hace el demonio cliente de forma autónoma al inicio y en cada ciclo (3 s):

• Identifica la MAC de la puerta de enlace conectada y aplica perfiles de nftables (open / balanced / lockdown) contra trusted_networks
• Detección de ransomware por comportamiento (fanotify + entropía de Shannon + canarios)
• Escaneo de malware en acceso (fanotify, opcionalmente ClamAV)
• Monitoreo de suplantación de ARP y fijación preventiva de ARP/NDP de puerta de enlace en redes no confiables
• Endurecimiento del kernel (sysctl / Yama / core dumps / /tmp noexec) por perfil
• Aplicación de DNS de protección contra amenazas (dns_enabled + dns_scope)
• Guardia de enlace (NFQUEUE) para interceptación de phishing
• Salida del estado de tiempo de ejecución a /run/roamswitch/state.json

Edición de servidor

sudo systemctl status  roamswitch-server.service      # Estado de funcionamiento
sudo systemctl restart roamswitch-server.service      # Reiniciar
sudo systemctl reload  roamswitch-server.service      # Recargar archivo de configuración
journalctl -u roamswitch-server.service -f            # Seguir registros

3. Referencia de comandos CLI

Sintaxis básica: roamswitch <command> [options]. La ejecución sin argumentos tiene como valor predeterminado status. El idioma de salida sigue automáticamente la configuración regional del sistema operativo (LC_ALL / LC_MESSAGES / LANG).

Ejemplos

sudo roamswitch status                 # Diagnóstico integral del cliente (24 elementos)
sudo roamswitch status --server        # Diagnóstico integral de Server Edition (30 elementos)
sudo roamswitch ports -a               # Todos los puertos en escucha
roamswitch guards                      # Estado de las protecciones
roamswitch audit-url https://examp1e-login.com
roamswitch audit-secrets ./deploy.env
roamswitch audit-secrets .                          # Escanear recursivamente el directorio actual
roamswitch audit-logs 72               # Analizar los registros de las últimas 72 horas
sudo roamswitch sharing on             # Detener automáticamente SSH/Samba/RDP en redes no confiables
sudo roamswitch fim verify             # Verificación de integridad de archivos FIM
sudo roamswitch fim update             # Actualizar línea base de FIM
sudo roamswitch emergency-restore      # Levantar por completo el bloqueo de emergencia y restaurar
sudo roamswitch airgap enable          # Bloqueo de emergencia
sudo roamswitch airgap disable         # Levantar
sudo roamswitch server ack             # Confirmar el temporizador de seguridad (detener la recuperación automática)
roamswitch canary                      # Historial de incidentes del canario
roamswitch port-anomaly                # Historial de incidentes del Port Anomaly Guard
roamswitch server ebpf                 # Estado de aislamiento e historial de incidentes del guardián eBPF
roamswitch notifications               # Historial de notificaciones de los últimos 7 días
roamswitch frozen                      # Listar procesos congelados
sudo roamswitch frozen resume 12345    # Liberar un falso positivo
sudo roamswitch sensor pair --addr 192.168.1.50 --code AB3DFGH2  # Se empareja con Sensor mediante un código de emparejamiento
sudo roamswitch sensor key             # Muestra la clave pública/dirección propias de este endpoint
roamswitch port-scan                   # Historial de detección de escaneo de puertos

El daemon de la edición servidor se ejecuta como root, por lo que los comandos que necesitan leer el conjunto de reglas de nftables o identificar al propietario de un proceso (status / status --server / ports -a) devuelven resultados inexactos sin sudo (un falso veredicto de “inactivo”, o información de proceso faltante). Los comandos que modifican la configuración (sharing / fim update / airgap / emergency-restore, etc.) también requieren sudo. El resto de comandos, de solo lectura, funcionan correctamente sin él.

4. Archivos de configuración

Edición del cliente (~/.config/roamswitch/config.json)

El demonio se ejecuta como root y escanea /home/*/.config/roamswitch/config.json, utilizando el primer archivo válido que encuentra (o /root/.config/roamswitch/config.json en entornos solo root).

Edición de servidor (/etc/roamswitch/server.conf)

Server Edition utiliza un archivo de configuración en formato INI con permisos estrictos (0600, solo raíz). Consulte Manual de operaciones de Server Edition

No utiliza comunicación de red externa, se conecta localmente al socket del demonio o llama a roamswitch-core. Consulte Guía de configuración de MCP

• Página del producto RoamSwitch para Linux
• Documento técnico sobre seguridad del cliente
• Documento técnico sobre seguridad del servidor
• Manual de operaciones del servidor
• Guía de integración de MCP y asistente AI
• Preguntas frecuentes