- GNAI-000: Stand 09.11., Belegter-Stand-Tabelle um Monitoring-Zeile und aktualisierte KI-Host/GPU/LLM-Serving/Deployment-Zeilen ergaenzt, Ansible-Projekt-Tabelle um LLM-Stack, Monitoring und CT-103 ergaenzt, Reverse-Proxy-/DNS-Zeilen um Ansible-Import bzw. mon-Record ergaenzt, Leitentscheidungen (Production via ai_environment_switch, Monitoring host-lokal) aufgenommen, bereits erledigte Entscheidungstore (Backupziel, 64k/128k, M2/M3) aus der Offenen-Liste genommen - GNAI-001: Ausführungsstand 09.11.2026 (M2 abgenommen, M3 beschlossen 05.11., M4 abgenommen 06.11. und nach Neustart 09.11. erneut verifiziert); M1-Hinweis: CT-100/CT-103 besitzen inzwischen Ansible-Sollzustand - GNAI-008: Stand 09.11., Abgrenzung Planung vs. belegter Stand (Abschnitt 14), Changelog 0.19/0.20, Abschnitt 15 an M4-Realitaet angepasst, Frage 6 als umgesetzt markiert, Re-Verifikation nach Host-Neustart 09.11. inkl. Befund gnai-ai-backup Exit 21 nach Boot (fehlende Mount-Reihenfolge; offen: RequiresMountsFor in ai_backup), gnai-experimental UID 983 -> 985 - GNAI-009/010: Statuszeilen an Betreiberbeschluss 05.11. bzw. umgesetzte Sollkonfiguration angepasst, Changelog 0.11 - GNENC-000/001/002: state/system.json als entfallen markiert (GNMON-001 v2.0), Flask -> Blazor, Monitoring-Status aktualisiert - GNMON-001 v2.1 und planning-Snapshot: Umsetzungsabweichungen nachgefuehrt - GNAI-002/003: gpu_fan_control bzw. Konten gn-download/gn-dashboard/ gn-monitor/gn-media ergaenzt (live per getent verifiziert 09.11.) - GNAI-006 v3.0: Ansible-Sollzustand importiert/adoptiert, Verifikation 09.11. - GNAI-013, proxmox-server/README.md: CT-103-Automation-Referenz - AGENTS.md: CT-103 nicht mehr "root-only" (ghost-agent/ghost seit 22.09.2026, ansible-deploy seit 07.11.2026; live geprueft 09.11.2026) - llm-server/README.md: Doku-Spiegel um monitoring/ ergaenzt Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Ghostnet.AI Infrastruktur
Dokumentation für die Infrastruktur eines privaten Homelabs mit öffentlich erreichbaren Webdiensten, einem WireGuard-Zugang und einem dedizierten KI-Server. Dieses Repository hält Architekturentscheidungen, den belegten Betriebsstand und Verfahren für Einrichtung, Betrieb und Sicherheitsabnahme fest.
Projektstand: 14.10.2026. Pi-hole/Split-DNS, WireGuard-Rollenpolicy und der per Ansible reproduzierbare Keycloak-/PostgreSQL-Stack sind produktiv abgenommen. Der öffentliche Keycloak-Adminpfad ist gesperrt, der interne HTTPS-Adminpfad funktioniert und der reale Vaultwarden-OIDC-Login wurde bestätigt. Dauerhaftes LLM-Serving und Encoding sind noch nicht installiert.
Überblick
flowchart LR
Internet --> Router[Fritzbox]
Router -->|HTTP/HTTPS| NPM[Nginx Proxy Manager]
Router -->|WireGuard| VPN[wg-easy]
NPM --> Apps[Webdienste in eigenen LXCs]
VPN --> LAN[Heimnetz]
LAN --> PVE[Proxmox und Service-LXCs]
LAN --> AI[KI-Server]
NPM -.-> AI
Der Reverse Proxy und das VPN-Gateway laufen in getrennten Proxmox-LXCs. Weitere Webdienste befinden sich in eigenen LXCs. Der physische KI-Server ist für lokale Inferenz und darauf aufbauende Anwendungen vorgesehen. Die gestrichelte Verbindung zum KI-Server beschreibt einen geplanten Veröffentlichungsweg für LLM-Anwendungen; die Dienste sind dort noch nicht installiert.
Die drei vorgesehenen VPN-Netzwerkrollen sind Familie (gesamtes Heimnetz), Server Admin (bestätigte Server und Service-LXCs) und LLM Admin (nur KI-Server). Der derzeit einzige Peer ghost-laptop ist als Server Admin durch native nftables-Regeln abgenommen. Anwendungsanmeldung, SSH-Schlüssel und API-Schlüssel bleiben zusätzliche, eigenständige Zugangskontrollen.
Aktueller Stand
| Bereich | Belegter Stand | Nächster Nachweis oder Schritt |
|---|---|---|
| KI-Server | Debian-Basissystem, Deployment-Zugang, Podman 5.4.2, drei getrennte rootless Workload-Konten sowie zwei als gfx1030 und als llama.cpp-ROCm-Geräte geprüfte RX 6900 XT |
nach der Prioritätsentscheidung internes llama.cpp-Testing ohne öffentliche Route bereitstellen |
| VPN | wg-easy v15.4.0, native Rollenpolicy/NAT und externer Positiv-/Negativtest abgenommen | WAN-/IPv6-Exposure, Restore und GUI-HTTPS prüfen |
| Reverse Proxy | NPM auf CT 103 dokumentiert; Fail2Ban laut Betreiber fest gepinnt und wieder in Betrieb | Effektive Jails, Sperren und Wiederanlauf prüfen |
| Identität | CT 102 per Ansible mit Podman/PostgreSQL reproduziert; interner Adminpfad, öffentliche Sperre, Reboot und realer Vaultwarden-OIDC-Login abgenommen | Stabilisierungsphase und praktischen CT-104-Rückfalltest abschließen |
Der Dokumentationsindex enthält die datierten Quellen, offenen Angaben und Abnahmegrenzen. Er ist die maßgebliche Übersicht für den aktuellen Projektstand. Eine Zielbeschreibung in diesem README oder den Architekturdokumenten ist kein Nachweis für eine bereits wirksame Konfiguration.
Dokumentation lesen
| Einstieg | Inhalt |
|---|---|
| Dokumentationsindex und Projektstand | Dokumentenübersicht, bestätigte Entscheidungen und offene Befunde |
| High-Level-Implementierungsplan | priorisierte nächste Schritte, Entscheidungstore und messbare Abschlusskriterien |
| Plattform-Dokumentation | Hostbasis, Zugriffsmodell, Reverse Proxy und VPN |
| KI-Dokumentation | KI-Zielarchitektur, Ansible-Planung, Modellbewertung und technische llama.cpp-Sollkonfiguration |
| Video-Encoding | getrennter Planungs- und späterer SOP-Bereich für den CPU-Encoding-Workload |
| LLM-Server-Host-Automation | Host-Baseline, Podman, Workload-Konten, AMD-GPU-Zugriff und rootless ROCm-Probe |
| Encoding-Automation | CPU-Encoding-Grundzustand für gn-encoding auf dem KI-Server |
| Keycloak-CT-102-Automation | Inventare, Rollen, Restore- und Produktionsverifikation für CT 102 |
Arbeiten mit dem Repository
Dieses Repository enthält Dokumentation und hostbezogene Ansible-Projekte.
Der physische KI-Server liegt unter llm-server/, Proxmox-Gäste unter
proxmox/lxc/<ct-id>-<dienst>/; nur tatsächlich wiederverwendbare Rollen und
Control-Node-Pins liegen unter shared/ansible/. Vor einer
Infrastrukturänderung den Ist-Stand am betroffenen Host prüfen, die passende
Fachanleitung lesen und die dort genannten Abnahmeschritte dokumentieren.
WireGuard-Profile enthalten private Schlüssel. Sie gehören nicht in Git, Ausgaben oder freigegebene Dokumente. Die geschützte lokale Ablage liegt außerhalb des Repositorys; eine Ignore-Regel ist kein Ersatz für sichere Aufbewahrung.
Änderungen am Projektstand sollten zuerst im zuständigen Fachdokument mit Datum und Beleg erfasst werden. Anschließend den Index und diese README aktualisieren, wenn sich eine übergreifende Aussage geändert hat.