121 lines
3.9 KiB
Markdown
121 lines
3.9 KiB
Markdown
# 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> |