RustNet

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

Inglés | 简体中文

Visibilidad en tiempo real de cada conexión que realiza tu máquina, de quién es y qué protocolo está usando. Sin tcpdump, ni reenvío de X11, ni pipes con root.

Características

• Atribución por proceso: Cada conexión TCP, UDP y QUIC asignada a su proceso propietario, mediante eBPF en Linux, PKTAP en macOS, API nativas en Windows y FreeBSD. 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 indica su proceso propietario, sin posprocesamiento. También está disponible el clásico --pcap-export con un sidecar JSONL para correlación sin conexión.
• Sandboxing de seguridad: Landlock (Linux 5.13+), Seatbelt (macOS), eliminación de privilegios de token + bloqueo de procesos hijo mediante job object (Windows). Elimina privilegios inmediatamente después de que libpcap se inicializa. Ver SECURITY.md.
• Analíticas de red TCP: Retransmisiones en tiempo real, paquetes fuera de orden y detección de retransmisión rápida, por conexión y agregadas.
• Ciclo de vida inteligente de conexiones: Tiempos de espera según protocolo con indicadores de obsolescencia blanco → amarillo → rojo. Pulsa t para mantener visibles las conexiones históricas (cerradas) para análisis forense.
• Filtrado estilo Vim/fzf: port:, src:, , , , , , además de expresiones regulares mediante .

¿Por qué RustNet?

RustNet cubre el vacío entre las herramientas simples de conexiones (netstat, ss) y los analizadores de paquetes (Wireshark, tcpdump):

• Atribución de procesos: Ve qué aplicación es dueña de cada conexión. Wireshark no puede ofrecer esto porque solo ve paquetes, no sockets.
• Vista centrada en conexiones: Sigue estados, ancho de banda y protocolos por conexión en tiempo real.
• Compatibilidad 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á realizando las conexiones. Para inspección directa con Wireshark, --pcapng-export escribe comentarios de paquete en vivo y de mejor esfuerzo con contexto de PID/proceso. Para correlación posterior, usa --pcap-export junto con el sidecar 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

Inicio rápido

Instalación

Homebrew (macOS / Linux):

brew install rustnet

Ubuntu (25.10+):

sudo add-apt-repository 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
# Then inside the shell: sudo rustnet

Desde crates.io:

cargo install rustnet-monitor

Windows (Chocolatey):

# Run in Administrator PowerShell
# Requires Npcap (https://npcap.com) installed with "WinPcap API-compatible Mode" enabled
choco install rustnet

Otras plataformas:

• FreeBSD: Descarga desde los lanzamientos de rustnet-bsd
• Docker, compilaciones desde el código fuente, otras distros de Linux: Consulta INSTALL.md para instrucciones detalladas

Ejecutar RustNet

La captura de paquetes requiere privilegios elevados:

# Quick start (all platforms)
sudo rustnet

# Linux: Grant capabilities to run without sudo (recommended)
sudo setcap 'cap_net_raw,cap_bpf,cap_perfmon+eip' $(which rustnet)
rustnet

Opciones comunes:

rustnet -i eth0              # Specify network interface
rustnet --show-localhost     # Show localhost connections
rustnet --no-resolve-dns     # Disable reverse DNS lookups (enabled by default)
rustnet -r 500               # Set refresh interval (ms)
rustnet --theme classic      # Original full-color palette (default: muted)
rustnet --pcapng-export capture.pcapng  # Annotated PCAPNG for Wireshark

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

Si configuras capabilities pero la TUI sigue mostrando eBPF unavailable, consulta eBPF no disponible a pesar de tener capabilities 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                        # Search for "google" anywhere
/port:443                      # Filter by port
/process:firefox               # Filter by process
/state:established             # Filter by connection state
/dport:443 sni:github.com      # Combine filters

Ordenación:

• Pulsa s para alternar entre columnas ordenables (Proceso, Direcciones, Servicio, Aplicación, Estado, Ancho de banda)
• Pulsa S (Shift+s) para cambiar la dirección de ordenación
• Encuentra los consumidores de ancho de banda: pulsa s hasta que aparezca "Bandwidth 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, incluido el sandboxing con Landlock y la gestión de privilegios
• ARCHITECTURE.md - Arquitectura técnica, implementaciones por plataforma y detalles de rendimiento
• PROFILING.md - Guía de perfilado de rendimiento con configuración de flamegraph y consejos de optimización
• ROADMAP.md - Funciones planificadas y mejoras futuras
• RELEASE.md - Proceso de publicación para mantenedores

Contribuciones

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

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

Licencia

Este proyecto está licenciado bajo la Apache License, 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 en herramientas como tshark/wireshark/tcpdump, sniffnet, netstat, ss, iftop y bandwhich
• Parte del código es vibe coding (OMG) / que los dioses de las LLM te acompañen

Documentación trasladada

Algunas secciones se han trasladado 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