bandwhich

Dies ist ein CLI-Tool zur Anzeige der aktuellen Netzwerkauslastung nach Prozess, Verbindung und Remote-IP/-Hostname

Inhaltsverzeichnis

• bandwhich
  • Inhaltsverzeichnis
  • Projektstatus
  • Wie funktioniert es?
  • Installation
    • Downstream-Paketierungsstatus
    • Vorgefertigte Binärdatei herunterladen
  • Build aus dem Quellcode
    • Cross-Kompilierung
      • Android
  • Nach der Installation (Linux)
    • 1. setcap
      • Erklärung der Capabilities
    • 2. sudo (oder Alternative)
  • Nach der Installation (Windows)
  • Verwendung
  • Mitwirken
  • Lizenz

Projektstatus

Dieses Projekt befindet sich in passiver Wartung. Kritische Probleme werden behoben, aber es werden keine neuen Funktionen entwickelt. Dies liegt jedoch eher an fehlenden Mitteln und/oder Arbeitskräften, daher sind Pull Requests mehr als willkommen. Wenn Sie in der Lage und bereit sind, langfristig zu diesem Projekt beizutragen, möchten wir Sie einladen, sich als Co-Maintainer zu bewerben.

Weitere Details finden Sie unter The Future of Bandwhich #275.

Wie funktioniert es?

bandwhich überwacht eine bestimmte Netzwerkschnittstelle und zeichnet die IP-Paketgröße auf, wobei es dies mit dem /proc-Dateisystem unter Linux, lsof unter macOS oder mit der WinApi unter Windows abgleicht. Es reagiert auf die Größe des Terminalfensters, zeigt weniger Informationen an, wenn kein Platz vorhanden ist. Es wird auch versuchen, IPs im Hintergrund per Reverse-DNS nach bestem Wissen und Gewissen in Hostnamen aufzulösen.

Installation

Downstream-Paketierungsstatus

Detaillierte Anweisungen für jede Plattform finden Sie in der INSTALL.md.

Vorgefertigte Binärdatei herunterladen

Wir bieten mehrere generische Binärdateien in den Releases für verschiedene Betriebssysteme an.

Build aus dem Quellcode

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

Für die aktuelle minimal unterstützte Rust-Version siehe das Feld rust-version in der Cargo.toml.

Cross-Kompilierung

Cross-Kompilierung für alternative Ziele wird über cross unterstützt. Hier ist der grobe Ablauf:

1. Überprüfen Sie die Zielarchitektur. Unter Linux können Sie uname -m verwenden.
2. Schlagen Sie die Rustc-Plattformunterstützung für das entsprechende Ziel-Triple nach.
3. Installieren Sie cross.
4. Führen Sie cross build --release --target <TARGET_TRIPLE> aus.

Android

Bis cross-rs/cross#1222 gelöst ist, verwenden Sie den neuesten HEAD:

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

Nach der Installation (Linux)

Da bandwhich Netzwerkpakete überwacht, benötigt es erhöhte Rechte. Unter Linux gibt es zwei Hauptmethoden, dies zu erreichen:

1. setcap

• Erlauben Sie der bandwhich-Binärdatei dauerhaft die erforderlichen Berechtigungen (sogenannte „Capabilities“ in Linux).
• Tun Sie dies, wenn Sie allen nicht privilegierten Benutzern vollen Zugriff auf die Überwachungsfunktionen von bandwhich geben möchten.
  • Dies ist die empfohlene Einrichtung für Einzelbenutzermaschinen oder wenn alle Benutzer vertrauenswürdig sind.
  • Dies wird nicht empfohlen, wenn Sie sicherstellen möchten, dass Benutzer den Datenverkehr anderer nicht sehen können.

# Capabilities zuweisen
sudo setcap cap_sys_ptrace,cap_dac_read_search,cap_net_raw,cap_net_admin+ep $(command -v bandwhich)
# als unprivilegierter Benutzer ausführen
bandwhich

Erklärung der Capabilities

• cap_sys_ptrace,cap_dac_read_search: erlauben den Zugriff auf /proc/<pid>/fd/, damit bandwhich bestimmen kann, welcher offene Port zu welchem Prozess gehört.
• cap_net_raw,cap_net_admin: erlauben das Erfassen von Paketen auf Ihrem System.

2. sudo (oder Alternative)

• Erfordert jedes Mal eine Rechteerweiterung.
• Tun Sie dies, wenn Sie Administrator einer Mehrbenutzerumgebung sind.

sudo bandwhich

Beachten Sie, dass Sie eine command not found-Fehlermeldung erhalten können, wenn Ihre Installationsmethode bandwhich irgendwo in Ihrem Home-Verzeichnis installiert hat (Sie können dies mit command -v bandwhich überprüfen). Dies liegt daran, dass sudo in vielen Distributionen aus Sicherheitsgründen standardmäßig nicht das $PATH des Benutzers übernimmt.

Um dies zu umgehen, können Sie eine der folgenden Möglichkeiten nutzen:

1. lassen Sie sudo Ihre $PATH-Umgebungsvariable beibehalten;
2. setzen Sie $PATH explizit beim Ausführen von bandwhich: sudo env "PATH=$PATH" bandwhich;
3. übergeben Sie den vollständigen Pfad an sudo: sudo $(command -v bandwhich).

Nach der Installation (Windows)

Möglicherweise müssen Sie zuerst npcap installieren, um Pakete unter Windows zu erfassen.

Verwendung

Usage: bandwhich [OPTIONS]

Options:
  -i, --interface <INTERFACE>      The network interface to listen on, eg. eth0
  -r, --raw                        Machine friendlier output
  -n, --no-resolve                 Do not attempt to resolve IPs to their hostnames
  -s, --show-dns                   Show DNS queries
  -d, --dns-server <DNS_SERVER>    A dns server ip to use instead of the system default
      --log-to <LOG_TO>            Enable debug logging to a file
  -v, --verbose...                 Increase logging verbosity
  -q, --quiet...                   Decrease logging verbosity
  -p, --processes                  Show processes table only
  -c, --connections                Show connections table only
  -a, --addresses                  Show remote addresses table only
  -u, --unit-family <UNIT_FAMILY>  Choose a specific family of units [default: bin-bytes] [possible values: bin-bytes, bin-bits, si-bytes, si-bits]
  -t, --total-utilization          Show total (cumulative) usages
  -h, --help                       Print help (see more with '--help')
  -V, --version                    Print version

Mitwirken

Siehe CONTRIBUTING.md.

Lizenz

MIT