bandwhich

هذه أداة سطر أوامر لعرض استخدام الشبكة الحالي حسب العملية والاتصال وعنوان IP/اسم المضيف البعيد

جدول المحتويات

• bandwhich
  • جدول المحتويات
  • حالة المشروع
  • كيف يعمل؟
  • التثبيت
    • حالة التعبئة في المستودعات النهائية
    • تحميل ملف ثنائي مُجهز مسبقًا
  • البناء من المصدر
    • الترجمة المتقاطعة
      • أندرويد
  • ما بعد التثبيت (لنظام لينكس)
    • 1. setcap
      • شرح الصلاحيات
    • 2. sudo (أو بديل)
  • ما بعد التثبيت (لنظام ويندوز)
  • الاستخدام
  • المساهمة
  • الترخيص

حالة المشروع

هذا المشروع في حالة صيانة سلبية. سيتم معالجة المشكلات الحرجة، ولكن لا يتم العمل على ميزات جديدة. ومع ذلك، يرجع ذلك إلى نقص التمويل و/أو القوى العاملة أكثر من أي شيء آخر، لذا فإن طلبات السحب مرحب بها أكثر من أي وقت مضى. بالإضافة إلى ذلك، إذا كنت قادرًا وراغبًا في المساهمة في هذا المشروع على المدى الطويل، فإننا ندعوك للتقدم بطلب للحصول على مشاركة في الصيانة.

لمزيد من التفاصيل، راجع مستقبل Bandwhich #275.

كيف يعمل؟

يقوم bandwhich باعتراض حركة المرور على واجهة شبكة معينة وتسجيل حجم حزم IP، ومقارنتها بنظام الملفات /proc في لينكس، أو lsof في ماك، أو باستخدام WinApi في ويندوز. يستجيب لحجم نافذة الطرفية، ويعرض معلومات أقل إذا لم تكن هناك مساحة كافية. كما يحاول حل عناوين IP إلى أسماء المضيفين في الخلفية باستخدام DNS العكسي بأفضل جهد ممكن.

التثبيت

حالة التعبئة في المستودعات النهائية

للحصول على تعليمات مفصلة لكل منصة، راجع INSTALL.md.

تحميل ملف ثنائي مُجهز مسبقًا

نوفر عدة ملفات ثنائية عامة في الإصدارات لأنظمة تشغيل مختلفة.

البناء من المصدر

git clone https://github.com/imsnif/bandwhich.git
cd bandwhich
cargo build --release

للحصول على أحدث إصدار أدنى مدعوم من Rust، يرجى الرجوع إلى حقل rust-version في Cargo.toml.

الترجمة المتقاطعة

الترجمة المتقاطعة للأهداف البديلة مدعومة عبر cross. إليك الإجراء التقريبي:

1. تحقق من معمارية الهدف. إذا كنت على لينكس، يمكنك استخدام uname -m.
2. ابحث عن دعم منصة rustc للثلاثية المستهدفة المقابلة.
3. تثبيت cross.
4. قم بتشغيل cross build --release --target <TARGET_TRIPLE>.

أندرويد

حتى يتم حل cross-rs/cross#1222، استخدم أحدث HEAD:

cargo install --git https://github.com/cross-rs/cross.git cross
cross build --release --target aarch64-linux-android

ما بعد التثبيت (لنظام لينكس)

بما أن bandwhich يعترض حزم الشبكة، فإنه يتطلب صلاحيات مرتفعة. على لينكس، هناك طريقتان رئيسيتان لتحقيق ذلك:

1. setcap

• السماح بشكل دائم للملف الثنائي bandwhich بالصلاحيات المطلوبة (تسمى "capabilities" في لينكس).
• قم بذلك إذا كنت ترغب في منح جميع المستخدمين غير المميزين وصولاً كاملاً إلى قدرات المراقبة الخاصة بـ bandwhich.
  • هذا هو الإعداد الموصى به للأجهزة أحادية المستخدم، أو إذا كان جميع المستخدمين موثوقين.
  • هذا غير موصى به إذا كنت ترغب في ضمان عدم قدرة المستخدمين على رؤية حركة مرور الآخرين.

# تعيين الصلاحيات
sudo setcap cap_sys_ptrace,cap_dac_read_search,cap_net_raw,cap_net_admin+ep $(command -v bandwhich)
# التشغيل كمستخدم غير مميز
bandwhich

شرح الصلاحيات

• cap_sys_ptrace,cap_dac_read_search: السماح بالوصول إلى /proc/<pid>/fd/، حتى يتمكن bandwhich من تحديد أي منفذ مفتوح ينتمي إلى أي عملية.
• cap_net_raw,cap_net_admin: السماح باعتراض الحزم على نظامك.

2. sudo (أو بديل)

• طلب رفع الصلاحيات في كل مرة.
• قم بذلك إذا كنت مسؤولاً عن بيئة متعددة المستخدمين.

sudo bandwhich

لاحظ أنه إذا كانت طريقة التثبيت الخاصة بك قد وضعت bandwhich في مكان ما داخل دليلك المنزلي (يمكنك التحقق باستخدام command -v bandwhich)، فقد تحصل على خطأ command not found. يرجع ذلك إلى أن sudo في العديد من التوزيعات لا يحتفظ افتراضيًا بـ $PATH الخاص بالمستخدم لأسباب تتعلق بالأمان.

لتجاوز ذلك، يمكنك القيام بأحد الأمور التالية:

1. جعل sudo يحتفظ بمتغير البيئة $PATH الخاص بك؛
2. تعيين $PATH بشكل صريح أثناء تشغيل bandwhich: sudo env "PATH=$PATH" bandwhich؛
3. تمرير المسار الكامل إلى sudo: sudo $(command -v bandwhich).

ما بعد التثبيت (لنظام ويندوز)

قد تحتاج أولاً إلى تثبيت npcap لاعتراض الحزم على ويندوز.

الاستخدام

Usage: bandwhich [OPTIONS]

Options:
  -i, --interface <INTERFACE>      واجهة الشبكة للاستماع إليها، مثل eth0
  -r, --raw                        إخراج مناسب للآلات
  -n, --no-resolve                 عدم محاولة حل عناوين IP إلى أسماء مضيفين
  -s, --show-dns                   عرض استعلامات DNS
  -d, --dns-server <DNS_SERVER>    عنوان IP لخادم DNS لاستخدامه بدلاً من الافتراضي للنظام
      --log-to <LOG_TO>            تفعيل تسجيل التصحيح إلى ملف
  -v, --verbose...                 زيادة مستوى تفصيل التسجيل
  -q, --quiet...                   تقليل مستوى تفصيل التسجيل
  -p, --processes                  عرض جدول العمليات فقط
  -c, --connections                عرض جدول الاتصالات فقط
  -a, --addresses                  عرض جدول العناوين البعيدة فقط
  -u, --unit-family <UNIT_FAMILY>  اختيار عائلة محددة من الوحدات [الافتراضي: bin-bytes] [القيم الممكنة: bin-bytes, bin-bits, si-bytes, si-bits]
  -t, --total-utilization          عرض الاستخدام الإجمالي (التراكمي)
  -h, --help                       طباعة المساعدة (رؤية المزيد باستخدام '--help')
  -V, --version                    طباعة الإصدار

المساهمة

راجع CONTRIBUTING.md.

الترخيص

MIT