RustNet

Monitoramento de rede por processo para o seu terminal: conexões TCP, UDP e QUIC ao vivo com inspeção profunda de pacotes, com sandbox por padrão.

Português | 简体中文 | 日本語

Visibilidade em tempo real de cada conexão que sua máquina faz, quem a possui e qual protocolo está falando. Sem tcpdump, encaminhamento X11 ou piping como root.

Recursos

• Atribuição por processo: Cada conexão TCP, UDP e QUIC mapeada para o processo proprietário, via eBPF no Linux, PKTAP no macOS, ETW com fallback automático para IP Helper no Windows e APIs nativas no FreeBSD. Os detalhes incluem PID, executável, nomes de usuário/grupo, confiança de correspondência e uma cadeia limitada de processos pai em todas as plataformas. Wireshark e tcpdump não conseguem fazer isso; netstat / ss não conseguem mostrar o estado ao vivo.
• Inspeção profunda de pacotes: Identifica HTTP, HTTPS/TLS com SNI, DNS, SSH, FTP, QUIC, MQTT, BitTorrent, STUN, NTP, mDNS, LLMNR, DHCP, SNMP, SSDP e NetBIOS, sem dissectores externos.
• Exportação PCAPNG anotada: --pcapng-export grava uma captura pronta para o Wireshark com processo, PID, direção, DPI/SNI e GeoIP embutidos como comentários por pacote. Abra no Wireshark e cada pacote já nomeia seu processo proprietário, sem pós-processamento. O clássico --pcap-export com um sidecar JSONL para correlação offline também está disponível.
• Sandbox de segurança: Landlock (Linux 5.13+), Seatbelt (macOS), redução de privilégios por token + bloqueio de processos filhos por job object (Windows). Reduz privilégios imediatamente após a inicialização do libpcap. Consulte SECURITY.md.
• Análises de rede: Tempos de ida e volta em tempo real para TCP, handshakes QUIC, respostas DNS e echo ICMP, além de detecção de retransmissão TCP, fora de ordem e retransmissão rápida.
• Ciclo de vida inteligente de conexões: Timeouts cientes do protocolo com indicadores de obsolescência branco → amarelo → vermelho. Alterne com t para manter conexões históricas (fechadas) visíveis para perícia.
• Filtragem estilo Vim/fzf: port:, , , , , , , além de regex via .

Por que RustNet?

O RustNet preenche a lacuna entre ferramentas simples de conexão (netstat, ss) e analisadores de pacotes (Wireshark, tcpdump):

• Atribuição de processos: Veja a qual aplicativo pertence cada conexão. O Wireshark não consegue fornecer isso porque ele só vê pacotes, não sockets.
• Visão centrada na conexão: Acompanhe estados, largura de banda e protocolos por conexão em tempo real
• Compatível com SSH: A TUI funciona via SSH para que você veja rapidamente o que está acontecendo em um servidor remoto sem encaminhar X11 ou capturar tráfego

O RustNet complementa as ferramentas de captura de pacotes. Use o RustNet para ver o que está fazendo conexões. Para inspeção direta no Wireshark, --pcapng-export grava, ao vivo e com melhor esforço, comentários de pacotes com contexto de PID/processo. Para correlação na fase de limpeza, use --pcap-export com o sidecar JSONL e o opcional scripts/pcap_enrich.py. Consulte Exportação PCAP e Comparação com Ferramentas Similares para detalhes.

Construído sobre ratatui, libpcap, eBPF (libbpf-rs), DashMap, crossbeam, ring, MaxMind GeoLite2 e Landlock. Consulte ARCHITECTURE.md para o detalhamento completo das dependências.

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

Capturas de Tela

Início Rápido

Instalação

Homebrew (macOS / Linux):

brew install rustnet

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

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

Do 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

Outras plataformas:

• FreeBSD: Baixe dos lançamentos rustnet-bsd
• Docker, compilações a partir do código-fonte, outras distros Linux: Consulte INSTALL.md para instruções detalhadas

Executando o RustNet

A captura de pacotes requer privilégios 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

Opções comuns:

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 tokyo-night  # Theme: muted (default), vivid, catppuccin-mocha, tokyo-night, gruvbox, nord
rustnet --pcapng-export capture.pcapng  # Annotated PCAPNG for Wireshark

O tema e as substituições por cor também podem ser definidos em ~/.config/rustnet/config.toml; --theme tem precedência. Consulte USAGE.md para o esquema.

Consulte INSTALL.md para configuração detalhada de permissões e USAGE.md para todas as opções.

Se você definir as capabilities mas a TUI ainda mostrar eBPF unavailable, consulte eBPF indisponível apesar das capabilities definidas na seção de solução de problemas.

Controles de Teclado

Consulte USAGE.md para controles de teclado detalhados e dicas de navegação.

Filtragem & Ordenação

Exemplos rápidos de filtragem:

/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

Ordenação:

• Pressione s para percorrer as colunas ordenáveis (Processo, Endereços, Serviço, Aplicativo, Estado, Largura de Banda)
• Pressione S (Shift+s) para alternar a direção da ordenação
• Encontre quem consome mais largura de banda: Pressione s até aparecer "Bandwidth Total ↓" (ordena pela velocidade combinada de upload+download)

Consulte USAGE.md para a sintaxe completa de filtragem e o guia de ordenação.

Documentação

• INSTALL.md - Instruções detalhadas de instalação para todas as plataformas, configuração de permissões e solução de problemas
• USAGE.md - Guia de uso completo incluindo opções de linha de comando, filtragem, ordenação e registro
• SECURITY.md - Recursos de segurança incluindo sandbox Landlock e gerenciamento de privilégios
• ARCHITECTURE.md - Arquitetura técnica, implementações por plataforma e detalhes de desempenho
• CONTRIBUTING.md - Fluxo de trabalho de contribuição, requisitos de qualidade e diretrizes do projeto
• PROFILING.md - Guia de criação de perfil de desempenho com configuração de flamegraph e dicas de otimização
• ROADMAP.md - Recursos planejados e melhorias futuras
• RELEASE.md - Processo de lançamento para mantenedores

Contribuindo

Contribuições são bem-vindas! Consulte CONTRIBUTING.md para as diretrizes sobre como contribuir.

Consulte CONTRIBUTORS.md para uma lista de pessoas que contribuíram com este projeto.

Licença

Este projeto é licenciado sob a Apache License, Versão 2.0 - consulte o arquivo LICENSE para obter detalhes.

Agradecimentos

• Construído com ratatui para a interface de terminal
• Captura de pacotes alimentada por libpcap
• Inspirado por ferramentas como tshark/wireshark/tcpdump, sniffnet, netstat, ss, iftop e bandwhich
• Parte do código foi escrita no estilo vibe coding (OMG) / que os deuses dos LLMs estejam com você

Documentação Movida

Algumas seções foram movidas para arquivos dedicados para melhor organização:

• Configuração de Permissões: Agora em INSTALL.md - Configuração de Permissões
• Instruções de Instalação: Agora em INSTALL.md
• Uso Detalhado: Agora em USAGE.md
• Detalhes da Arquitetura: Agora em ARCHITECTURE.md