# 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:
```bash
git clone https://git.techniverse.net/scriptos/dockernet-inspector.git
cd dockernet-inspector
```

2. Script ausführbar machen:
```bash
chmod +x dockernet-inspector.v1.sh
```

## 💡 Verwendung

### Grundlegende Syntax

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

### Beispiele

**Beispiel 1: Standard Bridge-Netzwerk analysieren**
```bash
bash ./dockernet-inspector.v1.sh bridge
```

**Beispiel 2: Benutzerdefiniertes Netzwerk analysieren**
```bash
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](./LICENSE) Datei für Details.

## 👤 Autor

**Patrick Asmus**
- Website: [https://www.cleveradmin.de](https://www.cleveradmin.de)
- Git: [https://git.techniverse.net/scriptos/dockernet-inspector.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

<p align="center">
  <img src="https://assets.techniverse.net/f1/git/graphics/gray0-catonline.svg" alt="">
</p>

<p align="center">
<img src="https://assets.techniverse.net/f1/logos/small/license.png" alt="License" width="15" height="15"> <a href="./LICENSE">License</a> | <img src="https://assets.techniverse.net/f1/logos/small/matrix2.svg" alt="Matrix" width="15" height="15"> <a href="https://matrix.to/#/#community:techniverse.net">Matrix</a> | <img src="https://assets.techniverse.net/f1/logos/small/mastodon2.svg" alt="Matrix" width="15" height="15"> <a href="https://social.techniverse.net/@donnerwolke">Mastodon</a>
</p>