RustNet

Monitoreo de red por proceso para tu terminal: conexiones TCP, UDP y QUIC en vivo con inspección profunda de paquetes, aislado por defecto.

English | 简体中文 | 日本語

Visibilidad en tiempo real de cada conexión que realiza tu máquina, quién la posee y qué protocolo utiliza. Sin tcpdump, reenvío de X11 ni tuberías con root.

Características

• Atribución por proceso: Cada conexión TCP, UDP y QUIC se asigna a su proceso propietario, mediante eBPF en Linux, PKTAP en macOS, ETW con respaldo automático de IP Helper en Windows y APIs nativas en FreeBSD. Los detalles incluyen PID, ejecutable, nombres de usuario/grupo, confianza de coincidencia y una cadena de procesos padre limitada en cada plataforma. Wireshark y tcpdump no pueden hacer esto; netstat / ss no pueden mostrar el estado en vivo.
• Inspección profunda de paquetes: Identifica HTTP, HTTPS/TLS con SNI, DNS, SSH, FTP, QUIC, MQTT, BitTorrent, STUN, NTP, mDNS, LLMNR, DHCP, SNMP, SSDP y NetBIOS, sin disectores externos.
• Exportación PCAPNG anotada: --pcapng-export escribe una captura lista para Wireshark con proceso, PID, dirección, DPI/SNI y GeoIP incrustados como comentarios por paquete. Ábrela en Wireshark y cada paquete ya nombra su proceso propietario, sin post-procesamiento. También está disponible la exportación clásica --pcap-export con un archivo lateral JSONL para correlación fuera de línea.
• Aislamiento de seguridad: Landlock (Linux 5.13+), Seatbelt (macOS), reducción de privilegios de token + bloqueo de procesos hijos con job-object (Windows). Reduce privilegios inmediatamente después de que libpcap se inicializa. Consulta SECURITY.md.
• Analítica de red: Tiempos de ida y vuelta en tiempo real para TCP, handshakes QUIC, respuestas DNS y eco ICMP, además de detección de retransmisiones TCP, paquetes fuera de orden y retransmisiones rápidas.
• Ciclo de vida inteligente de conexiones: Tiempos de espera conscientes del protocolo con indicadores de obsolescencia blanco → amarillo → rojo. Alterna con t para mantener visibles las conexiones históricas (cerradas) para análisis forense.
• Filtrado estilo Vim/fzf: port:, src:, dst:, sni:, process:, state:, proto:, además de regex mediante /(?i)patrón/.
• Enriquecimiento GeoIP: Consultas de país mediante MaxMind GeoLite2 local. Sin llamadas de red.
• Identificación de dispositivos LAN: Dirección MAC y fabricante (de la base de datos IEEE OUI integrada) para pares en el enlace y la puerta de enlace, aprendido pasivamente del tráfico ARP y mostrado en el panel de detalles.
• Atribución Kubernetes (característica opcional kubernetes): conexiones asignadas a su pod, namespace y contenedor, mostradas en el panel de detalles, exportaciones JSON/PCAPNG y los filtros pod:, ns:, container:. Habilitada en la imagen oficial de Docker; en un clúster, usa el plugin kubectl-rustnet para ejecutarlo como un pod de depuración efímero. Consulta USAGE.md.
• Multiplataforma: Linux, macOS, Windows, FreeBSD.

¿Por qué RustNet?

RustNet llena el vacío entre las herramientas simples de conexión (netstat, ss) y los analizadores de paquetes (Wireshark, tcpdump):

• Atribución de procesos: Ve qué aplicación posee cada conexión. Wireshark no puede proporcionar esto porque solo ve paquetes, no sockets.
• Vista centrada en conexiones: Rastrea estados, ancho de banda y protocolos por conexión en tiempo real
• Amigable con SSH: La TUI funciona a través de SSH para que puedas ver rápidamente qué está sucediendo en un servidor remoto sin reenviar X11 ni capturar tráfico

RustNet complementa las herramientas de captura de paquetes. Usa RustNet para ver qué está haciendo conexiones. Para inspección directa con Wireshark, --pcapng-export escribe comentarios de paquetes en vivo con contexto de PID/proceso. Para correlación en tiempo de limpieza, usa --pcap-export junto con el archivo lateral JSONL y el opcional scripts/pcap_enrich.py. Consulta Exportación PCAP y Comparación con herramientas similares para más detalles.

Construido sobre ratatui, libpcap, eBPF (libbpf-rs), DashMap, crossbeam, ring, MaxMind GeoLite2 y Landlock. Consulta ARCHITECTURE.md para el desglose completo de dependencias.

cargo build --release --no-default-features

Capturas de pantalla

Resumen Tabla de conexiones con estadísticas en vivo y sparklines	Detalles SNI por conexión, cifrado, GeoIP, DPI
Gráfico Gráfico de tráfico, distribución de aplicaciones, procesos principales	Actividad Egreso/ingreso de procesos, cobertura de 60 segundos, atribución y pares remotos

Inicio rápido

Instalación

Homebrew (macOS / Linux):

brew install rustnet

Ubuntu (22.04 LTS+) / Linux Mint 21+ / Pop!_OS 22.04+:

sudo add-apt-repository ppa:domcyrus/rustnet
# en Pop!_OS: sudo apt-manage add ppa:domcyrus/rustnet
sudo apt update && sudo apt install rustnet

Fedora (42+):

sudo dnf copr enable domcyrus/rustnet
sudo dnf install rustnet

openSUSE Tumbleweed:

sudo zypper addrepo https://download.opensuse.org/repositories/home:/domcyrus:/rustnet/openSUSE_Tumbleweed/home:domcyrus:rustnet.repo
sudo zypper refresh
sudo zypper install rustnet

Arch Linux:

sudo pacman -S rustnet

Nix / NixOS:

nix-shell -p rustnet
# Luego dentro del shell: sudo rustnet

Desde crates.io:

cargo install rustnet-monitor

Windows (Chocolatey):

# Ejecutar en PowerShell como Administrador
# Requiere Npcap (https://npcap.com) instalado con "Modo compatible con API WinPcap" habilitado
choco install rustnet

Otras plataformas:

• FreeBSD: Descarga desde lanzamientos de rustnet-bsd
• Docker, compilaciones desde fuente, otras distribuciones de Linux: Consulta INSTALL.md para instrucciones detalladas

Ejecutar RustNet

La captura de paquetes requiere privilegios elevados:

# Inicio rápido (todas las plataformas)
sudo rustnet

# Linux: Otorga capacidades para ejecutar sin sudo (recomendado)
sudo setcap 'cap_net_raw,cap_bpf,cap_perfmon+eip' $(which rustnet)
rustnet

Opciones comunes:

rustnet -i eth0              # Especificar interfaz de red
rustnet --show-localhost     # Mostrar conexiones de localhost
rustnet --no-resolve-dns     # Deshabilitar resoluciones DNS inversas (habilitadas por defecto)
rustnet -r 500               # Establecer intervalo de actualización (ms)
rustnet --theme tokyo-night  # Tema: muted (predeterminado), vivid, catppuccin-mocha, tokyo-night, gruvbox, nord
rustnet --pcapng-export capture.pcapng  # PCAPNG anotado para Wireshark

El tema y las anulaciones por color también se pueden configurar en ~/.config/rustnet/config.toml; --theme tiene prioridad. Consulta USAGE.md para el esquema.

Consulta INSTALL.md para la configuración detallada de permisos y USAGE.md para todas las opciones.

Si configuras las capacidades pero la TUI aún muestra eBPF unavailable, consulta eBPF no disponible a pesar de que las capacidades estén configuradas en la sección de solución de problemas.

Controles de teclado

Consulta USAGE.md para controles de teclado detallados y consejos de navegación.

Filtrado y ordenación

Ejemplos rápidos de filtrado:

/google                        # Buscar "google" en cualquier lugar
/port:443                      # Filtrar por puerto
/process:firefox               # Filtrar por proceso
/state:established             # Filtrar por estado de conexión
/dport:443 sni:github.com      # Combinar filtros

Ordenación:

• Presiona s para ciclar entre columnas ordenables (Proceso, Direcciones, Servicio, Aplicación, Estado, Ancho de banda)
• Presiona S (Shift+s) para alternar la dirección de ordenación
• Encuentra consumidores de ancho de banda: Presiona s hasta que aparezca "Ancho de banda Total ↓" (ordena por velocidad combinada de subida+bajada)

Consulta USAGE.md para la sintaxis completa de filtrado y la guía de ordenación.

Documentación

• INSTALL.md - Instrucciones detalladas de instalación para todas las plataformas, configuración de permisos y solución de problemas
• USAGE.md - Guía de uso completa que incluye opciones de línea de comandos, filtrado, ordenación y registro
• SECURITY.md - Características de seguridad que incluyen aislamiento Landlock y gestión de privilegios
• ARCHITECTURE.md - Arquitectura técnica, implementaciones por plataforma y detalles de rendimiento
• CONTRIBUTING.md - Flujo de trabajo de contribución, requisitos de calidad y pautas del proyecto
• PROFILING.md - Guía de perfilado de rendimiento con configuración de flamegraph y consejos de optimización
• ROADMAP.md - Características planificadas y mejoras futuras
• RELEASE.md - Proceso de lanzamiento para mantenedores

Contribuciones

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para las pautas sobre cómo contribuir.

Consulta CONTRIBUTORS.md para la lista de personas que han contribuido a este proyecto.

Licencia

Este proyecto está licenciado bajo la Licencia Apache, Versión 2.0 - consulta el archivo LICENSE para más detalles.

Agradecimientos

• Construido con ratatui para la interfaz de terminal
• Captura de paquetes impulsada por libpcap
• Inspirado por herramientas como tshark/wireshark/tcpdump, sniffnet, netstat, ss, iftop y bandwhich
• Parte del código está generado por vibración (OMG) / que los dioses de la LLM estén contigo

Documentación trasladada

Algunas secciones se han movido a archivos dedicados para una mejor organización:

• Configuración de permisos: Ahora en INSTALL.md - Configuración de permisos
• Instrucciones de instalación: Ahora en INSTALL.md
• Uso detallado: Ahora en USAGE.md
• Detalles de arquitectura: Ahora en ARCHITECTURE.md