Zum Hauptinhalt springen
Wenn Sie ipmideck in einem Terminal starten, rendert es eine interaktive Operator-Konsole: einen angepinnten Header mit dem Banner und einer Hilfeleiste über einem live scrollenden Log. Jede Aktion ist ein einzelner Tastendruck, keine Menüs, keine Maus. Die Konsole läuft prozessintern neben dem Server, sodass das, was Sie sehen, der Live-Zustand des Rechners ist, auf dem Sie sich befinden.
Die Konsole erscheint nur auf einem echten interaktiven Terminal, sowohl stdin als auch stdout müssen TTYs sein. Unter Docker, systemd oder wenn stdout weitergeleitet/umgeleitet wird, überspringt ipmideck die Konsole vollständig und schreibt nur einfache scrollende Logs. Siehe Wo die Konsole erscheint.

​
Wie es aussieht

Die Konsole ist eine einzige Vollbildansicht: ein angepinnter Header, den Sie immer sehen, über einem live scrollenden Log, das darunter läuft.
ipmideck interactive console showing the banner, help bar, status line, and the scrolling log panel
Der Header scrollt nie. Neue Log-Zeilen erscheinen im Panel darunter, und die neueste Zeile wird immer auf dem Bildschirm gehalten. Sie drücken eine einzelne Taste, um zu handeln; alles geschieht prozessintern gegen den Server, den Sie gerade gestartet haben.

​
Der Header

Der obere Teil des Bildschirms ist ein fester Header, der nie scrollt. Er stapelt sich von oben nach unten:
  • Das ipmideck-Banner.
  • Die Hilfeleiste: jede Aktionstaste und was sie tut.
  • Die Statuszeile: der Live-Zustand der Sitzung.
  • Eine kompakte Credits-Zeile (Autor, Version, Lizenz).
Der Körper unter dem Header ist der scrollende Log-Tail. Die neueste Zeile wird immer auf dem Bildschirm gehalten, sodass eine frisch erscheinende URL oder Bestätigung nie unten abgeschnitten wird.

​
Statuszeile

Die Statuszeile zeigt drei Live-Felder, getrennt durch |:
  • Verbosity: die aktuelle Log-Stufe (INFO, DEBUG oder WARNING).
  • Clients: die Anzahl der gerade verbundenen Dashboard-Clients.
  • last: die letzte Aktionstaste, die Sie gedrückt haben, als unmittelbares visuelles Feedback.

​
Aktionstasten

Jede Aktion ist ein Tastendruck. Die Hilfeleiste listet sie alle auf:
TasteAktion
vLog-Ausführlichkeit durchschalten
cDie Unteransicht der verbundenen Sitzungen öffnen
sDie Unteransicht der konfigurierten Server öffnen
uDie Dashboard-URL im Log einblenden
gUpdate-Prüfung (gibt die lokale Version aus)
bDen Bind-ändern-Editor öffnen
rDen Server neu starten
qBeenden oder aus einer Unteransicht zur Log-Ansicht zurückkehren
ESCZurück, aus einer Unteransicht zur Log-Ansicht zurückkehren
Pfeil-, Funktions- und Navigationstasten werden verbraucht und ignoriert, sie kollidieren nie mit einer Aktion und zählen nicht als Tastendruck.

​
v: Ausführlichkeit

v schaltet die Laufzeit-Log-Stufe durch eine feste dreistufige Schleife: 
INFO → DEBUG → WARNING → INFO
INFO ist die Voreinstellung. DEBUG zeigt mehr; WARNING zeigt weniger. Die Änderung wirkt sofort für den Rest der Sitzung und die Statuszeile aktualisiert sich entsprechend.
Der Ausführlichkeits-Umschalter ändert nur die laufende Stufe. Beim nächsten Start gewinnt die Stufe aus Ihrer Konfiguration (oder die Umgebungsvariable IPMIDECK_LOGGING_LEVEL) wieder. Siehe Konfiguration.

​
c: Sitzungen

c öffnet die Unteransicht Connected sessions, eine schreibgeschützte Tabelle der gerade angehängten Dashboard-Clients, mit Spalten:
  • IP
  • Connected since
  • User-Agent
Drücken Sie q oder ESC, um zur Log-Ansicht zurückzukehren.
Connected sessions table showing IP, Connected since, and User-Agent columns

​
s: Server

s öffnet die Unteransicht Configured servers, eine schreibgeschützte Tabelle der BMCs, mit denen ipmideck zu sprechen konfiguriert ist, mit Spalten:
  • Name
  • Host
  • Status
Drücken Sie q oder ESC, um zur Log-Ansicht zurückzukehren.
Configured servers table showing Name, Host, and Status columns with online and offline servers

​
u: URL

u blendet die Dashboard-URL (scheme://host:port) im Log-Körper ein. Wenn der Server an eine Wildcard-Adresse gebunden ist (0.0.0.0, :: oder leer), wird die URL in 127.0.0.1 umgeschrieben, sodass sie tatsächlich in einem Browser geöffnet werden kann, http://0.0.0.0:3000 ist eine Listen- Adresse, keine navigierbare.
The console log with the dashboard URL printed at the bottom after pressing u

​
g: Update

g gibt die lokale Version aus und einen Hinweis, dass die Online-Update-Prüfung mit der pip-Version ausgeliefert wird. Es macht keinen Netzwerkaufruf, ipmideck bleibt offline.

​
r: Neustart

r führt einen sauberen prozessinternen Neustart aus: ipmideck baut die Konsole ab, liest config.yaml neu ein und startet frisch. Verwenden Sie es nach einer Bind-ändern-Bearbeitung, um die neue Adresse anzuwenden.

​
q / ESC: Beenden und Zurück

  • Aus einer Unteransicht (sessions oder servers) bringen q und ESC Sie beide zur Log-Ansicht zurück.
  • Aus der Log-Ansicht löst q einen sauberen Exit aus, der Server fährt geordnet herunter.

​
b: Bind ändern

b öffnet den Bind-ändern-Editor, eine Inline-host:port-Eingabe, die die Hilfeleiste ersetzt, während Sie tippen. Der Header zeigt den aktuellen Bind als schreibgeschütztes current: host:port-Label und ein leeres new:-Feld, sodass der Wert, den Sie tippen, sofort erscheint und nie mit dem bestehenden verwechselt wird.
The change-bind editor showing the current bind address and an empty new field with apply, cancel, and delete key hints
Tasten innerhalb des Editors:
  • Enter: das getippte host:port anwenden.
  • ESC: abbrechen, ohne etwas zu ändern.
  • Backspace: das letzte Zeichen löschen.
  • Jedes druckbare Zeichen, an den Puffer anhängen.
Die Eingabe muss host:port sein, mit einem nicht-leeren Host und einem Port, der eine Ganzzahl im Bereich 1–65535 ist. Bei einer gültigen Eingabe bestätigt ipmideck den neuen Bind und erinnert Sie, dass ein Neustart erforderlich ist (drücken Sie r). Bei einer ungültigen Eingabe meldet es Invalid host/port und nichts ändert sich.
Eine Bind-ändern-Bearbeitung ist nicht live, sie wird in die Konfiguration geschrieben und wirkt erst nach einem Neustart. Drücken Sie r, um sie anzuwenden. Und denken Sie an die Priorität: eine IPMIDECK_SERVER_HOST- / IPMIDECK_SERVER_PORT-Umgebungsvariable oder ein explizites --host- / --port-Flag beim nächsten Start überschreibt, was die Konsole persistiert hat. Siehe Konfiguration.

​
Wo die Konsole erscheint

Die interaktive Konsole ist an ein echtes TTY gebunden: ipmideck rendert sie nur, wenn sowohl stdin als auch stdout interaktive Terminals sind. Wenn sie es nicht sind, degradiert es zu einem Banner plus einfachen scrollenden Logs und installiert keinen Tasten-Listener, sodass nichts auf einem Non-TTY busy-spinnt. Das bedeutet, die Konsole erscheint, wenn Sie ipmideck direkt in einem Terminal ausführen: 
ipmideck
Sie erscheint nicht, wenn:
  • Unter Docker läuft: der Container startet uvicorn direkt und erreicht nie den Konsolenpfad; Sie erhalten einfache Container-Logs (docker logs).
  • Unter systemd oder einem anderen Service-Manager läuft, bei dem stdout kein Terminal ist.
  • Weiterleiten oder Umleiten von stdout (z. B. ipmideck > server.log): stdout ist kein TTY mehr.
In jedem Non-TTY-Fall läuft der Server weiterhin normal und bindet an dieselbe Voreinstellung 0.0.0.0:3000; Sie erhalten nur einfache Logs statt der Live-Konsole.
ipmilink ist ein rückwärtskompatibler Alias für ipmideck, beide starten dieselbe Konsole.

​
Nächste Schritte