RustNet

ターミナル向けのプロセス単位ネットワーク監視: ライブ TCP・UDP・QUIC 接続をディープパケットインスペクションで可視化し、デフォルトでサンドボックス化。

英語 | 简体中文 | 日本語

お使いのマシンが行うすべての接続、その接続を所有するプロセス、話しているプロトコルをリアルタイムに可視化します。tcpdump や X11 フォワーディング、root でのパイプ処理は不要です。

機能

• プロセス単位の関連付け: すべての TCP・UDP・QUIC 接続を、所有プロセスにマッピングします。Linux では eBPF、macOS では PKTAP、Windows では自動 IP Helper フォールバック付きの ETW、FreeBSD ではネイティブ API を使用します。詳細には PID、実行ファイル、ユーザー/グループ名、一致信頼度、そして全プラットフォームで上限付きの親プロセスチェーンが含まれます。Wireshark や tcpdump ではこれはできず、netstat / ss ではライブ状態を表示できません。
• ディープパケットインスペクション: 外部のディセクタなしで、HTTP、SNI 付き HTTPS/TLS、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)、トークン特権の破棄 + ジョブオブジェクトによる子プロセスブロック (Windows)。libpcap の初期化後すぐに権限を破棄します。SECURITY.md を参照してください。
• ネットワーク分析: TCP・QUIC ハンドシェイク・DNS レスポンス・ICMP エコーのリアルタイム往復時間に加え、TCP 再送信、順序外れ、高速再送信の検出。
• スマートな接続ライフサイクル: プロトコル対応のタイムアウトと、白 → 黄 → 赤の鮮度インジケータ。t で過去の (クローズ済み) 接続をフォレンジック用に表示し続けることができます。
• Vim/fzf スタイルのフィルタリング: port:、src:、dst:、sni:、process:、state:、proto: に加え、/(?i)pattern/ による正規表現。
• GeoIP エンリッチメント: ローカルの MaxMind GeoLite2 による国別ルックアップ。ネットワーク呼び出しはありません。
• LAN デバイス識別: リンク上のピアとゲートウェイについて、MAC アドレスとベンダー (内蔵 IEEE OUI データベース由来) を ARP トラフィックからパッシブに学習し、詳細ペインに表示します。
• Kubernetes 属性付与 (オプションの kubernetes 機能): 接続をポッド・ネームスペース・コンテナにマッピングし、詳細ペイン、JSON/PCAPNG エクスポート、pod:・ns:・container: フィルタで表示します。公式 Docker イメージでは有効です。クラスタ上では kubectl-rustnet プラグインを使用して、一時的なデバッグポッドとして実行できます。USAGE.md を参照してください。
• クロスプラットフォーム: Linux、macOS、Windows、FreeBSD。

RustNet を選ぶ理由

RustNet は、シンプルな接続ツール (netstat、ss) とパケットアナライザー (Wireshark、tcpdump) の間のギャップを埋めます:

• プロセス関連付け: 各接続を所有するアプリケーションを確認できます。Wireshark はパケットしか見ずソケットを見ないため、これは提供できません。
• 接続中心のビュー: 接続ごとに状態・帯域幅・プロトコルをリアルタイムで追跡
• SSH フレンドリー: TUI は SSH 経由で動作するため、X11 フォワーディングやトラフィックキャプチャなしでリモートサーバーの状況をすばやく確認できます。

RustNet はパケットキャプチャツールを補完します。何が接続を行っているのか を確認するには RustNet を使用してください。Wireshark で直接検査する場合、--pcapng-export は PID/プロセスコンテキスト付きのベストエフォートなパケットコメントをライブで書き出します。後処理時の相関には、--pcap-export と JSONL サイドカー、およびオプションの scripts/pcap_enrich.py を使用してください。詳細は PCAP エクスポート と 類似ツールとの比較 を参照してください。

ratatui、libpcap、eBPF (libbpf-rs)、DashMap、crossbeam、ring、MaxMind GeoLite2、Landlock 上に構築されています。依存関係の完全な内訳は ARCHITECTURE.md を参照してください。

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

スクリーンショット

概要 ライブ統計とスパークラインを備えた接続テーブル	詳細 接続ごとの SNI、暗号、GeoIP、DPI
グラフ トラフィックチャート、アプリ分布、トッププロセス	アクティビティ プロセスの Egress/Ingress、60 秒カバレッジ、属性、リモートピア

クイックスタート

インストール

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

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 releases からダウンロード
• 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 tokyo-night  # Theme: muted (default), vivid, catppuccin-mocha, tokyo-night, gruvbox, nord
rustnet --pcapng-export capture.pcapng  # Annotated PCAPNG for Wireshark

テーマと色ごとのオーバーライドは ~/.config/rustnet/config.toml でも設定できます。--theme が優先されます。スキーマについては USAGE.md を参照してください。

詳細な権限設定は INSTALL.md、完全なオプションは USAGE.md を参照してください。

ケイパビリティを設定しても TUI に eBPF unavailable と表示される場合は、 トラブルシューティングセクションの ケイパビリティ設定後も eBPF が利用できない場合 を参照してください。

キーボード操作

詳細なキーボード操作とナビゲーションのヒントは 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 - 技術アーキテクチャ、プラットフォーム実装、パフォーマンスの詳細
• CONTRIBUTING.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 coded (OMG) です / LLM の神々のご加護がありますように

ドキュメントの移設

一部のセクションは、整理のため専用ファイルに移動されました:

• 権限設定: INSTALL.md - Permissions Setup に移動
• インストール手順: INSTALL.md に移動
• 詳細な使用方法: USAGE.md に移動
• アーキテクチャの詳細: ARCHITECTURE.md に移動