DokumentationEINEN FÖDERATIONSKNOTEN BETREIBEN

EINEN FÖDERATIONSKNOTEN BETREIBEN

Betreibe einen souveränen Knoten.

Ein Föderationsknoten nimmt am geräteübergreifenden Immunitäts-Gossip teil, ohne je rohe Nutzerdaten zu sehen. Optional — aber je mehr Knoten, desto dezentralisierter das Netzwerk.

01

Was ein Knoten tut

Ein Knoten empfängt Gehashtes-Muster-Broadcasts von Geräten in seiner Region, führt das Quorum-Protokoll mit Peer-Knoten aus und sendet bestätigte Muster an seine verbundenen Geräte erneut aus. Er empfängt oder speichert niemals etwas, das einen Nutzer identifiziert.

Datenschutz durch Konstruktion
Die Protokollschicht trägt nur SHA-256-Hashes und grobe Regions-Buckets. Es gibt keinen Codepfad, über den ein Knoten eine IP, eine E-Mail oder eine GPS-Koordinate empfangen könnte. Das wird durch einen automatisierten Test erzwungen, der den Build fehlschlagen lässt, wenn die Grenze verletzt wird.
02

Hardware-Anforderungen

Ein Knoten ist ein Rust-Daemon plus eine PostgreSQL-16-Instanz. Minimum:

  • 4 vCPU, 16 GB RAM, 200 GB SSD
  • Zuverlässige Konnektivität, öffentlich erreichbarer Port (standardmäßig 8443)
  • YubiHSM 2 oder Äquivalent für den Peer-Identitätsschlüssel (empfohlen)
  • Zeitsynchronisiert (NTP) — das Quorum-Protokoll ist empfindlich gegenüber Uhren-Drift
03

Installation

shell# 1. PostgreSQL 16 (skipped if you already have one)
sudo apt-get install -y postgresql-16

# 2. The federation daemon
curl -L -o lydos-fed-2026.06.r1.tar.gz \
  https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/lydos-fed.tar.gz
curl -L -o release.manifest.json \
  https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/release.manifest.json

# 3. Verify the bundle (the same protocol as the phone image)
./verify-bundle.sh --bundle lydos-fed-2026.06.r1.tar.gz --manifest release.manifest.json
# expects: signatures 3 / 3, hash match

# 4. Install
sudo tar -xzf lydos-fed-2026.06.r1.tar.gz -C /opt/lydos-fed
sudo /opt/lydos-fed/install.sh
04

Schlüsselzeremonie für die Peer-Identität

Der Peer-Identitätsschlüssel des Knotens signiert jeden Broadcast, den er aussendet. Erzeuge ihn im YubiHSM unter einer M-aus-N-Officer-Zeremonie. Drei Officer, zwei von drei zum Signieren neuer Schlüssel. Dokumentiere die Zeremonie in deinem internen Log.

shell/opt/lydos-fed/bin/lydos-fed key generate --hsm yubihsm \
  --slot 1 --label fed-peer-2026.06 \
  --officers 2-of-3
Warnung: Hot Key
Erzeuge diesen Schlüssel nicht auf einer Workstation. Die private Hälfte darf niemals in einem Prozessspeicher erscheinen, den du nicht kontrollierst. Das HSM erzwingt dies.
05

Der Peer-Registry beitreten

shell# Submit your node's public identity to the registry
/opt/lydos-fed/bin/lydos-fed join \
  --registry https://registry.lydos.ailydian.com \
  --pubkey-path /opt/lydos-fed/keys/fed-peer-2026.06.pub

Die Registry signiert deinen Eintrag und sendet ihn erneut aus. Andere Knoten melden sich und schließen den Handshake ab. Das übliche Onboarding dauert 10–30 Minuten.

06

Monitoring

Der Daemon legt Prometheus-Metriken offen auf /metrics und einen JSON-Health-Snapshot auf /health. Binde ihn in dein bestehendes Dashboard ein oder frage ihn direkt ab.

shellcurl https://your-node.example/health
# {
#   "version": "2026.06.r1",
#   "peers_online": "11/11",
#   "quorum": "ok",
#   "audit_chain_head": "3571a6c8…",
#   "uptime_seconds": 123456
# }
07

Backup und Restore

Das PostgreSQL-Volume ist die einzige zustandsbehaftete Komponente, die du sichern musst. Die Schlüssel leben im HSM und sind nur durch eine Zeremonie rekonstruierbar. Die Daemon-Konfiguration ist reproduzierbar aus /etc/lydos-fed.

Wiederherstellen ist schnell
Ein frischer Knoten tritt der Föderation bei, fragt Peers nach dem aktuellen Ketten-Head und holt auf. Das längste Aufholen, das wir in der Produktion beobachtet haben, betrug 18 Minuten vom Kaltstart bis in-quorum.