ConduitDoku
ende

Ein Minecraft-Netzwerk wie Infrastruktur betreiben

Conduit ist eine selbst gehostete Steuerebene für Proxmox. Server ausrollen, Spieler ohne Ladebildschirm zwischen ihnen bewegen, die gesamte Flotte sichern — und alles aus einem Panel beobachten, das den Ausfall eines Knotens übersteht. Einen zweiten Cluster bei einem anderen Anbieter verbinden, und beide von jedem der beiden Panels aus betreiben.

Conduit installieren Quellcode

Hier anfangen

InstallationZwei Formen: ein Einzelprozess-Setup für die Entwicklung und die produktive 3-Knoten-HA-Topologie, in der dieses Projekt wirklich läuft.
ArchitekturWie Conduit aus einem Proxmox-VE-Cluster ein Spielnetzwerk macht, das sich selbst betreibt.
FunktionenJede Funktion, die Conduit mitbringt, wozu sie da ist — und was sie bewusst nicht tut. Das längste Dokument hier, in zwölf Abschnitte geteilt.

Ein Cluster über verbundene Cluster

Zwei Proxmox-Cluster bei zwei Anbietern lassen sich verbinden. Jeder behält seinen eigenen Store; die Panels erreichen die Knoten des anderen über ein verschlüsseltes Mesh, Konten und Rollen werden repliziert, jede Änderung geht an den Cluster, dem der Datensatz gehört, und einen Panel-Hostnamen übernimmt der andere Cluster, wenn sein Besitzer schweigt, und gibt ihn zurück, sobald er wieder antwortet.

FöderationZwei Proxmox-Cluster bei zwei Anbietern, vom jeweils anderen Panel aus bedient: ein Mesh, replizierte Identität, jede Änderung beim Besitzer, und eine geteilte Eingangstür.
Domains & TLSJeder öffentliche Hostname des Clusters, sein DNS-Eintrag bei Cloudflare, das Zertifikat davor (Origin CA oder Let's Encrypt per DNS-01), und die Eingangstür, die ein verbundener Cluster übernimmt, wenn der Besitzer schweigt.
DatenbankenApp-Datenbanken auf Abruf anlegen, und die Systemspeicher des Panels (PostgreSQL, MariaDB, Redis) aus dem Panel heraus einsehen.

Wo willst du hin

BetreibenIm Alltag: Server, Spieler, Rechte, Backups, Updates.und 8 weitere
EntwickelnDie API, das CLI, und wie die schwierigen Teile arbeiten.und 7 weitere
BewertenWas es ist, was gemessen wurde, und wie es sich vergleicht.und 2 weitere

Das Panel

Die Übersicht — Flottenpuls, Knoten- und Container-Zahlen, Live-Metriken und alle Dienste in einer Tabelle, die Zeilen eines verbundenen Clusters als solche markiert

Die Übersicht — Flottenpuls, Knoten- und Container-Zahlen, Live-Metriken und alle Dienste in einer Tabelle, die Zeilen eines verbundenen Clusters als solche markiert

Am laufenden Cluster gemessen

9 ms

Agent-Umlauf

gegenüber 393 ms für `pct exec`

1.2 s

Proxy-Failover

vom Socket-Tod bis zur Wiederherstellung

32 KB

Upload-Speicher

Spitzenwert für eine 64 MB-Datei — vorher 256 MB

207 ms

Flotten-Logsuche

351 Treffer über 12 Server

Jede Zahl ist reproduzierbar — die Methode steht in Benchmarks.

Hier anfangen

Was Conduit ist — und wie es läuft.

InstallationZwei Formen: ein Einzelprozess-Setup für die Entwicklung und die produktive 3-Knoten-HA-Topologie, in der dieses Projekt wirklich läuft.
ArchitekturWie Conduit aus einem Proxmox-VE-Cluster ein Spielnetzwerk macht, das sich selbst betreibt.
FunktionenJede Funktion, die Conduit mitbringt, wozu sie da ist — und was sie bewusst nicht tut. Das längste Dokument hier, in zwölf Abschnitte geteilt.

Betrieb

Aufsetzen, und am Laufen halten.

MigrationEin bestehendes Netzwerk übernehmen, ohne die Welten zu verlieren und ohne den Spielern eine lange Ausfallzeit zuzumuten.
UpdatesWie das Panel sich selbst aktualisiert: gestaffelt über die Replikate, VIP zuletzt, mit Rollback.
Domains & TLSJeder öffentliche Hostname des Clusters, sein DNS-Eintrag bei Cloudflare, das Zertifikat davor (Origin CA oder Let's Encrypt per DNS-01), und die Eingangstür, die ein verbundener Cluster übernimmt, wenn der Besitzer schweigt.
SicherheitSitzungen, Passkeys, RBAC, Maschinenvertrauen, Ableitung von Zugangsdaten und Audit.
BerechtigungenFähigkeiten, Rollen und welche Route welche davon verlangt.
DatenbankenApp-Datenbanken auf Abruf anlegen, und die Systemspeicher des Panels (PostgreSQL, MariaDB, Redis) aus dem Panel heraus einsehen.

Referenz

Jede Funktion, API und jeder Befehl.

APIJeder HTTP-Endpunkt, den das Panel bereitstellt, mit der Berechtigung, die er voraussetzt.
CLIDie Kommandozeile: Flotte steuern, ohne den Browser zu öffnen.
EntwicklungDas Repository lokal aufsetzen, bauen, testen und ausrollen.
MitwirkenWie Änderungen hier landen — und woran sie gemessen werden.

Unter der Haube

Wie die schwierigen Teile wirklich arbeiten.

Proxy-HAZwei Velocity-Proxys hinter einer VIP, gemessener Failover in 1,2 Sekunden.
Nahtloser WechselDen Ladebildschirm beim Serverwechsel entfernen — was das Protokoll erlaubt und was nicht.
FöderationZwei Proxmox-Cluster bei zwei Anbietern, vom jeweils anderen Panel aus bedient: ein Mesh, replizierte Identität, jede Änderung beim Besitzer, und eine geteilte Eingangstür.

Belege

Messungen — und Vergleiche daran gemessen.

BenchmarksZahlen von echter Hardware: 9 ms statt 393 ms, 1,2 s Failover, 4,0-facher Upload.
vs CloudNetSpeicherverbrauch und Geschwindigkeit gegen CloudNet, an derselben Aufgabe gemessen.

Reviews

Prüfungen zu einem Stichtag, unverändert.

Architektur-ReviewEine Bestandsaufnahme zu einem Stichtag, absichtlich unverändert gelassen.
Sicherheits-ReviewEin Pentest-Bericht zu einem Stichtag, absichtlich unverändert gelassen.