Dieses Dokument beschreibt die Einrichtung und Nutzung des zentralen Verwaltungsskripts orbis zur Vereinfachung täglicher Admin-Aufgaben auf dem Server.

1. Zweck

Anstatt lange Befehlsketten für Docker-Befehle, Pfadwechsel oder Backup-Routinen manuell einzugeben, stellt das Skript /usr/local/bin/orbis eine zentrale Schnittstelle für das gesamte System bereit.

2. Installation & Berechtigungen

Erstelle die Datei /usr/local/bin/orbis, füge den Skriptinhalt ein und mache die Datei ausführbar:

sudo nano /usr/local/bin/orbis
sudo chmod +x /usr/local/bin/orbis

3. Befehlsübersicht & Syntax

Befehl Alias Parameter Beschreibung
orbis status st <name> (optional) Zeigt Systemauslastung (RAM, Disk, UFW) und Container-Listen. Mit Name: Live-Stats und Container-Details.
orbis logs l <name> Öffnet die letzten 100 Log-Zeilen live via Follow-Mode (-f).
orbis exec sh, shell <name> Öffnet direkt eine interaktive Shell (sh / bash) im Zielcontainer.
orbis restart r <name> | all Startet einen spezifischen Container oder alle laufenden Container neu.
orbis edit e <name> Öffnet die docker-compose.yml im Editor und fragt anschließend nach direktem Reload (up -d).
orbis create c, new <name> Interaktiver Wizard zum Erstellen neuer Services oder Webspaces (Nginx, PHP 8.2, WordPress, Joomla).
orbis delete rm, remove <name> Stoppt und entfernt den Stack; fragt nach optionalem vollständigen Löschen der Daten. `
orbis update up keine Zieht neue Docker-Images für alle Stacks (pull), räumt Caches auf und führt apt update && apt upgrade durch.
orbis prune clean keine Entfernt gestoppte Container, ungenutzte Netzwerke, Volumes und Build-Caches (docker system prune -a --volumes).
orbis backup b keine Erstellt ein komprimiertes .tar.gz-Archiv aller Configs (/opt/containers, /etc/pterodactyl, /etc/ufw).

4. Unterstützte Container-Shortcuts

Für häufig genutzte Dienste können in status, logs, exec und restart kurze Aliasse genutzt werden:

  • wings ➔ pterodactyl-wings
  • panel ➔ pterodactyl-panel
  • db / database ➔ pterodactyl-db
  • npm / proxy ➔ nginx-proxy-manager-app-1
  • git / forgejo ➔ forgejo

5. Anwendungsbeispiele

# Gesamtsystem und alle Webspaces prüfen
orbis status

# Live-Logs des Pterodactyl Wings Daemons verfolgen
orbis logs wings

# Shell im Panel-Container öffnen
orbis exec panel

# Neuen Webspace mit PHP 8.2 oder WordPress anlegen
orbis create projekt-xyz

# Vollständiges System- & Docker-Update ausführen
orbis update

# Manuelles Konfigurations-Backup anstoßen
orbis backup

6. Status-Checklist

  • [ ] Skript unter /usr/local/bin/orbis angelegt.
  • [ ] Ausführbar gemacht (chmod +x).
  • [ ] orbis status erfolgreich aufgerufen.
  • [ ] orbis logs wings und orbis exec panel getestet.
  • [ ] Erstes automatisches Backup via orbis backup erstellt.