dockernet-inspector/README.md

Dockernet Inspector

Ein Bash-Script zur Analyse und Anzeige von Details zu Docker-Netzwerken.

📋 Beschreibung

Dockernet Inspector ist ein praktisches Bash-Script, das detaillierte Informationen über Docker-Netzwerke anzeigt. Es ermöglicht Administratoren und Entwicklern einen schnellen Überblick über die Konfiguration und den Status eines Docker-Netzwerks zu erhalten.

Das Script zeigt folgende Informationen an:

• Netzwerk-Driver (bridge, overlay, host, etc.)
• Bridge-Interface-Name auf dem Host-System
• Subnet und Gateway des Netzwerks
• Interface-Status (operstate: up, down, unknown)
• Netzwerk-Statistiken (RX/TX Bytes und Pakete)

🚀 Installation

1. Repository klonen:

git clone https://git.techniverse.net/scriptos/dockernet-inspector.git
cd dockernet-inspector

2. Script ausführbar machen:

chmod +x dockernet-inspector.v1.sh

💡 Verwendung

Grundlegende Syntax

bash ./dockernet-inspector.v1.sh <docker-network-name>

Beispiele

Beispiel 1: Standard Bridge-Netzwerk analysieren

bash ./dockernet-inspector.v1.sh bridge

Beispiel 2: Benutzerdefiniertes Netzwerk analysieren

bash ./dockernet-inspector.v1.sh my-custom-network

Beispiel-Ausgabe

Docker-Netzwerk   : my-network
Driver            : bridge
Bridge-Interface  : br-1234567890ab
Subnet/Gateway    : 172.18.0.0/16 / 172.18.0.1
OperState         : up
RX bytes/packets  : 123456 / 789
TX bytes/packets  : 654321 / 456

📊 Ausgabe-Details

Feld	Beschreibung
Docker-Netzwerk	Name des analysierten Docker-Netzwerks
Driver	Verwendeter Netzwerk-Treiber (bridge, overlay, host, etc.)
Bridge-Interface	Name des Bridge-Interfaces auf dem Host (z.B. br-xxxxxxxxxxxx)
Subnet/Gateway	IP-Bereich und Gateway-Adresse des Netzwerks
OperState	Betriebszustand des Interfaces (up, down, unknown)
RX bytes/packets	Empfangene Bytes/Pakete
TX bytes/packets	Gesendete Bytes/Pakete

⚠️ Voraussetzungen

• Docker muss installiert und laufend sein
• Bash (Version 4.0 oder höher empfohlen)
• Root/Sudo-Rechte können für den Zugriff auf System-Interfaces erforderlich sein
• Linux-Betriebssystem (das Script nutzt /sys/class/net/ für Interface-Statistiken)

🔧 Fehlerbehandlung

Das Script gibt folgende Fehlermeldungen aus:

• Keine Netzwerk-Angabe: Usage: ./dockernet-inspector.v1.sh <docker-network-name>
• Netzwerk nicht gefunden: Fehler: Netzwerk '<name>' nicht gefunden.
• Interface existiert nicht: WARN: Interface <name> existiert (noch) nicht auf dem Host.

🛠️ Technische Details

Das Script nutzt:

• docker network inspect zur Abfrage von Netzwerk-Informationen
• /sys/class/net/ Interface für Netzwerk-Statistiken
• set -euo pipefail für sichere Script-Ausführung

📝 Lizenz

Siehe LICENSE Datei für Details.

👤 Autor

Patrick Asmus

• Website: https://www.cleveradmin.de
• Git: https://git.techniverse.net/scriptos/dockernet-inspector.git

🤝 Beitragen

Beiträge, Issues und Feature-Anfragen sind willkommen!

📅 Version

• Version: 1.0.0
• Datum: 17.02.2026
• Modifikation: Initial Release

License | Matrix | Mastodon