RustNet

터미널용 프로세스별 네트워크 모니터링: 딥 패킷 인스펙션을 지원하는 실시간 TCP, UDP, QUIC 연결, 기본적으로 샌드박스 처리됩니다.

English | 简体中文

머신이 만드는 모든 연결, 해당 연결의 소유 프로세스, 사용 중인 프로토콜을 실시간으로 확인할 수 있습니다. tcpdump, X11 포워딩, root 파이핑이 필요 없습니다.

기능

• 프로세스별 귀속: Linux의 eBPF, macOS의 PKTAP, Windows 및 FreeBSD의 네이티브 API를 통해 모든 TCP, UDP, QUIC 연결을 소유 프로세스에 매핑합니다. Wireshark와 tcpdump는 이 작업을 할 수 없으며, netstat/ss는 실시간 상태를 보여줄 수 없습니다.
• 딥 패킷 인스펙션: 외부 디섹터 없이 HTTP, HTTPS/TLS(SNI 포함), DNS, SSH, FTP, QUIC, MQTT, BitTorrent, STUN, NTP, mDNS, LLMNR, DHCP, SNMP, SSDP, NetBIOS를 식별합니다.
• 주석이 포함된 PCAPNG 내보내기: --pcapng-export는 프로세스, PID, 방향, DPI/SNI, GeoIP를 패킷별 주석으로 포함하는 Wireshark 호환 캡처를 작성합니다. Wireshark에서 열면 추가 처리 없이 모든 패킷에 소유 프로세스 이름이 이미 표시됩니다. 오프라인 상관 분석을 위한 JSONL 사이드카가 포함된 기존 --pcap-export도 제공됩니다.
• 보안 샌드박싱: Landlock(Linux 5.13+), Seatbelt(macOS), 토큰 권한 강등 + job-object 자식 프로세스 차단(Windows). libpcap 초기화 직후 권한을 즉시 낮춥니다. SECURITY.md 참조.
• TCP 네트워크 분석: 연결별 및 전체에 대한 실시간 재전송, 순서가 잘못된 패킷, 빠른 재전송 감지.
• 스마트 연결 수명주기: 프로토콜 인식 타임아웃과 흰색 → 노란색 → 빨간색 부실(staleness) 표시기. t를 눌러 포렌식을 위해 기록(닫힌) 연결을 계속 표시할 수 있습니다.
• Vim/fzf 스타일 필터링: port:, src:, dst:, sni:, process:, , 및 정규식 지원.

왜 RustNet인가?

RustNet은 단순 연결 도구(netstat, ss)와 패킷 분석기(Wireshark, tcpdump) 사이의 간극을 메웁니다:

• 프로세스 귀속: 각 연결을 소유한 애플리케이션을 확인할 수 있습니다. Wireshark는 패킷만 볼 수 있고 소켓은 볼 수 없으므로 이 기능을 제공할 수 없습니다.
• 연결 중심 보기: 연결별 상태, 대역폭, 프로토콜을 실시간으로 추적합니다.
• SSH 친화적: TUI가 SSH를 통해 작동하므로 X11을 포워딩하거나 트래픽을 캡처하지 않고도 원격 서버에서 무슨 일이 일어나고 있는지 빠르게 확인할 수 있습니다.

RustNet은 패킷 캡처 도구를 보완합니다. RustNet을 사용하여 무엇이 연결을 만드는지 확인하세요. 직접 Wireshark 검사가 필요하면 --pcapng-export가 PID/프로세스 컨텍스트가 포함된 실시간 best-effort 패킷 주석을 작성합니다. 정리 시점 상관 분석에는 --pcap-export와 JSONL 사이드카, 선택적 scripts/pcap_enrich.py를 사용하세요. 자세한 내용은 PCAP Export 및 Comparison with Similar Tools를 참조하세요.

ratatui, libpcap, eBPF(libbpf-rs), DashMap, crossbeam, ring, MaxMind GeoLite2, Landlock 기반으로 구축되었습니다. 전체 의존성 분석은 ARCHITECTURE.md를 참조하세요.

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

스크린샷

빠른 시작

설치

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

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

기타 플랫폼:

• FreeBSD: rustnet-bsd 릴리스에서 다운로드
• Docker, 소스 빌드, 기타 Linux 배포판: 자세한 지침은 INSTALL.md 참조

RustNet 실행

패킷 캡처에는 상승된 권한이 필요합니다:

# 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

공통 옵션:

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

자세한 권한 설정은 INSTALL.md, 전체 옵션은 USAGE.md를 참조하세요.

capabilities를 설정했는데도 TUI에 eBPF unavailable이 계속 표시되면 문제 해결 섹션의 eBPF Unavailable Despite Capabilities Being Set 을 참조하세요.

키보드 컨트롤

자세한 키보드 컨트롤과 탐색 팁은 USAGE.md를 참조하세요.

필터링 및 정렬

빠른 필터링 예시:

/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

정렬:

• s를 눌러 정렬 가능한 열(Process, Addresses, Service, Application, State, Bandwidth)을 순환합니다.
• S(Shift+s)를 눌러 정렬 방향을 전환합니다.
• 대역폭 과다 사용 프로세스 찾기: "Bandwidth Total ↓"이 나타날 때까지 s를 누릅니다(업로드+다운로드 합산 속도 기준 정렬).

전체 필터링 구문과 정렬 가이드는 USAGE.md를 참조하세요.

문서

• INSTALL.md - 모든 플랫폼의 상세 설치 지침, 권한 설정, 문제 해결
• USAGE.md - 명령줄 옵션, 필터링, 정렬, 로깅을 포함한 전체 사용 가이드
• SECURITY.md - Landlock 샌드박싱 및 권한 관리를 포함한 보안 기능
• ARCHITECTURE.md - 기술 아키텍처, 플랫폼 구현, 성능 세부 정보
• PROFILING.md - flamegraph 설정 및 최적화 팁이 포함된 성능 프로파일링 가이드
• ROADMAP.md - 계획된 기능 및 향후 개선 사항
• RELEASE.md - 유지 관리자를 위한 릴리스 프로세스

기여

기여를 환영합니다! 기여 방법에 대한 지침은 CONTRIBUTING.md를 참조하세요.

이 프로젝트에 기여한 사람들의 목록은 CONTRIBUTORS.md를 참조하세요.

라이선스

이 프로젝트는 Apache License, Version 2.0에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 말

• 터미널 UI는 ratatui로 구축되었습니다.
• 패킷 캡처는 libpcap 기반입니다.
• tshark/wireshark/tcpdump, sniffnet, netstat, ss, iftop, bandwhich 같은 도구에서 영감을 받았습니다.
• 일부 코드는 vibe 코딩되었습니다(OMG) / LLM 신들이 당신과 함께하시길

문서 이동 안내

일부 섹션은 더 나은 구성을 위해 전용 파일로 이동되었습니다:

• 권한 설정: 지금은 INSTALL.md - Permissions Setup에 있습니다.
• 설치 지침: 지금은 INSTALL.md에 있습니다.
• 상세 사용법: 지금은 USAGE.md에 있습니다.
• 아키텍처 세부 정보: 지금은 ARCHITECTURE.md에 있습니다.