ipmideck, der den Server startet, das Admin-Passwort
zurücksetzt oder ein selbstsigniertes Zertifikat erzeugt.
Das CLI gilt nur, wenn Sie ipmideck direkt ausführen (pip-Installation oder ein Source-Checkout). Das
Docker-Image startet
uvicorn backend.main:app direkt und ruft das CLI nie auf, sodass keines
dieser Flags, die Bind-Priorität oder der Single-Instance-Schutz für den Container gelten. Der Bind des Containers wird durch seinen eigenen Startbefehl gesetzt. Siehe Installation.Den Server starten
start ist der primäre Serve-Befehl. Ein bloßer Aufruf ohne Unterbefehl verhält sich identisch,
diese sind also gleichwertig:
0.0.0.0:3000, erreichbar auf jeder Schnittstelle,
auf Port 3000. Öffnen Sie http://<your-ip>:3000, sobald er läuft.
Überschreiben Sie den Bind mit --host und --port:
Unterbefehle
serve ist ein veralteter Alias von start, bevorzugen Sie start (oder ein bloßes ipmideck) in
neuen Skripten.Flags
Diese Top-Level-Flags gelten für den Serve-Pfad.--demo und --config werden vor jeder
Unterbefehl-Verzweigung gelesen, sodass sie auch reset-password und --gen-cert betreffen.
Bind-Priorität
Der Host und Port, an den ipmideck tatsächlich bindet, werden in dieser Reihenfolge aufgelöst, höchste Priorität zuerst:- Ein explizites
--host- /--port-Flag auf der Kommandozeile. - Die Konfiguration, die selbst die Umgebungsvariable (
IPMIDECK_SERVER_HOST/IPMIDECK_SERVER_PORT) überconfig.yamlüber die eingebaute Voreinstellung auflöst. - Die fest codierte Rückfallebene
0.0.0.0:3000, verwendet, falls das frühe Laden der Konfiguration fehlschlägt.
config.yaml persistieren, wird von einer IPMIDECK_-
Umgebungsvariablen oder einem --host- / --port-Flag beim nächsten Start überschrieben, Umgebung und
CLI gewinnen immer. Wenn config.yaml fehlerhaft ist, gibt ipmideck eine Warnung an stderr aus und fällt
auf 0.0.0.0:3000 zurück.
Die Umgebungsvariablen
IPMIDECK_SERVER_HOST und IPMIDECK_SERVER_PORT verwenden das
Präfix IPMIDECK_. Siehe Konfiguration für die vollständige Liste der Überschreibungen.HTTPS mit —gen-cert
--gen-cert erzeugt ein selbstsigniertes Zertifikat und einen Schlüssel und beendet sich dann. Es
startet den Server nicht und schaltet HTTPS nicht von selbst ein:
data/certs/, trägt deren Pfade in den server-Block von
config.yaml ein und gibt drei Zeilen aus:
server.https: true in config.yaml und starten ipmideck neu. HTTPS wird nie automatisch aktiviert.
Demo-Modus
--demo führt ipmideck gegen simulierte Hardware statt echter BMCs aus, nützlich, um das Dashboard
ohne verbundene Server zu testen:
Das Admin-Passwort zurücksetzen
reset-password erstellt oder aktualisiert interaktiv die Admin-Anmeldung und beendet sich dann, ohne
jemals den Server zu starten:
Username: und dann New password: (verdeckte Eingabe). Wenn ein Konto bereits
existiert, aktualisiert es das Passwort dieses Benutzers und gibt Password updated for <username> aus; andernfalls
erstellt es den Benutzer und gibt User <username> created aus.
Auto-Reload für die Entwicklung
--reload ist ein schneller Pfad nur für die Entwicklung: Es übergibt an uvicorns eigenen
auto-neuladenden Supervisor und kehrt zurück. Es überspringt absichtlich den Single-Instance-Port-Schutz, der unten
beschrieben ist, weil der Reloader seinen eigenen Supervisor-Prozess ausführt.
Exit-Codes
Auf dem Serve-Pfad (nicht
--reload) führt ipmideck vor dem Binden einen Single-Instance-Schutz aus. Wenn der
Port bereits in Verwendung ist, gibt es einen Fehler an stderr aus und beendet sich mit 1. Wenn der Bind fehlschlägt, weil die
Adresse nicht verfügbar oder nicht erlaubt ist, gibt es einen eigenen Fehler aus und beendet sich ebenfalls mit 1.
Nächste Schritte
- Konfiguration:
config.yaml-Schlüssel und dieIPMIDECK_-Umgebungs-Überschreibungen. - Installation: ipmideck mit Docker oder pip installieren.
- Fehlerbehebung: Verbindungs-, Port- und IPMI-Fehler.