RustNet

مراقبة شبكة لكل عملية على حدة في طرفيتك: اتصالات TCP وUDP وQUIC حية مع فحص عميق للحزم، معزولة افتراضيًا.

English | 简体中文 | 日本語

رؤية لحظية لكل اتصال يصدره جهازك، ومن يملكه، وبأي بروتوكول يتحدث. لا حاجة لـ tcpdump أو تمرير X11 أو أنابيب بصلاحيات الجذر (root piping).

الميزات

• إسناد لكل عملية على حدة: كل اتصال TCP وUDP وQUIC يُربط بالعملية المالكة له، عبر eBPF على Linux، وPKTAP على macOS، وETW مع تراجع تلقائي إلى IP Helper على Windows، وواجهات برمجة أصلية على FreeBSD. تتضمن التفاصيل PID والملف التنفيذي وأسماء المستخدم/المجموعة ودرجة الثقة في المطابقة وسلسلة عمليات أصل محدودة السقف على كل منصة. لا يمكن لـ 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 ملف التقاط جاهزًا لـ Wireshark مع تضمين العملية وPID والاتجاه وDPI/SNI وGeoIP كتعليقات لكل حزمة. افتحه في Wireshark وستجد كل حزمة تسمّي عمليتها المالكة بالفعل، دون أي معالجة لاحقة. يتوفر أيضًا التصدير الكلاسيكي --pcap-export مع ملف JSONL جانبي للربط دون اتصال.
• عزل أمني: Landlock (Linux 5.13+)، وSeatbelt (macOS)، وإسقاط امتيازات الرمز المميز + حظر العمليات الفرعية عبر كائن الوظيفة (Windows). تُسقَط الامتيازات فورًا بعد تهيئة libpcap. انظر SECURITY.md.
• تحليلات الشبكة: أزمنة ذهاب وإياب لحظية لاتصالات TCP ومصافحات QUIC واستجابات DNS وصدى ICMP، بالإضافة إلى كشف إعادة إرسال TCP والحزم خارج الترتيب وإعادة الإرسال السريع.
• دورة حياة اتصال ذكية: مهلات مدركة للبروتوكول مع مؤشرات تقادم بالأبيض ← الأصفر ← الأحمر. بدّل بـ t لإبقاء الاتصالات التاريخية (المغلقة) مرئية للتحليل الجنائي.
• تصفية بأسلوب Vim/fzf: port: وsrc: و و و و و، بالإضافة إلى التعبيرات النمطية عبر .

لماذا RustNet؟

يسد RustNet الفجوة بين أدوات الاتصال البسيطة (netstat، ss) ومحللات الحزم (Wireshark، tcpdump):

• إسناد العملية: اعرف أي تطبيق يملك كل اتصال. لا يمكن لـ Wireshark توفير ذلك لأنه يرى الحزم فقط، لا المقابس (sockets).
• عرض متمركز حول الاتصال: تتبّع الحالات وعرض النطاق والبروتوكولات لكل اتصال في الوقت الفعلي
• متوافق مع 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

لقطات الشاشة

بدء سريع

التثبيت

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
• 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 للخيارات الكاملة.

إذا ضبطت الصلاحيات (capabilities) لكن واجهة 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 للتنقل بين الأعمدة القابلة للفرز (العملية، العناوين، الخدمة، التطبيق، الحالة، عرض النطاق)
• اضغط S (Shift+s) لتبديل اتجاه الفرز
• اعثر على مستهلكي عرض النطاق: اضغط 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، الإصدار 2.0 - انظر ملف LICENSE للتفاصيل.

شكر وتقدير

• مبني بـ ratatui لواجهة الطرفية
• التقاط الحزم مدعوم بـ libpcap
• مستوحى من أدوات مثل tshark/wireshark/tcpdump وsniffnet وnetstat وss وiftop وbandwhich
• بعض الكود كُتب بأسلوب vibe coding (يا إلهي) / ولتكن آلهة نماذج اللغة الكبيرة معكم

توثيق منقول

نُقلت بعض الأقسام إلى ملفات مخصصة لتنظيم أفضل:

• إعداد الصلاحيات: أصبح الآن في INSTALL.md - إعداد الصلاحيات
• تعليمات التثبيت: أصبحت الآن في INSTALL.md
• الاستخدام المفصل: أصبح الآن في USAGE.md
• تفاصيل البنية: أصبحت الآن في ARCHITECTURE.md