Files
infrastructure/docs/GNAI-000-DOC_Index.md
T
spektr 2fe80bc015 M1-Sicherheitsabschluss 10.11.2026: Fail2Ban-Abnahme, hostunabhängige LXC-Backups, Keycloak-Stabi + NPM-Rückfalltest, CT 104 entfernt
- Fail2Ban CT 103 funktional abgenommen (Image/Digest, Jails, Filter-Dry-Run,
  kontrollierter Ban/Unban 203.0.113.66 mit nftables-Nachweis, Dienstneustart,
  pct-Reboot); Befund proxy-host-14 im Jail-Glob nach Restart + SOP; frischer
  Rollback-vzdump d4478c85...
- Hostunabhängige LXC-Backups: frische Stop-Mode-vzdumps CT 100/102/103/105,
  Archiv auf ghostnet-ki (gn-backup, quellbeschränkter PVE-Key) mit SHA-256-
  Verifikation, Restore-Test CT 100 -> CT 150 bestanden; deklarative Rollen
  gn_backup_receiver (KI) + pve_lxc_backup_sync (PVE, nächtlicher Timer,
  Prune 4/CT), beide konvergent changed=0
- Keycloak CT 102: 26 Tage stabil (NRestarts=0), Ansible-Drift changed=0,
  praktischer NPM-Rückfalltest auf CT 104 bestanden (Hosts 7/13 -> .16 -> .4);
  danach CT 104 nach Betreiberfreigabe archiviert + entfernt, historische
  CT-102-Altbackups gelöscht (SHA-256 dokumentiert), 10.0.0.16 aus WG-Set
  server_admin_targets entfernt
- WAN/IPv6-Exposure erfasst: WAN nur TCP 80/443 offen, keine AAAA-Records
- Doku: GNAI-000/001/013, GNAI-006/007/012/016, pve-host README, ct-104 README

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-11-10 19:42:06 +01:00

192 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Ghostnet.AI – Dokumentationsindex und Projektstand
**Stand:** 2026-11-10
**Status:** Plattformgrundlage vorhanden; KI-Stack intern bis M4 abgenommen (Testing und Production live auf `10.0.0.90`, Monitoring produktiv); Sicherheitsabschluss: Fail2Ban-Abnahme und hostunabhängige Backups/Restore am 10.11.2026 geschlossen, WAN/IPv6-Fremdnetz-Rescan, NPM-Rückfalltest CT 104 und FRITZ!Box-Rollback noch offen; externe KI-Freigabe (M6) offen
Dieses Dokument ist der zentrale Einstieg, nicht das technische Nachweisprotokoll.
Details, historische Laufdaten und Bedienverfahren stehen ausschließlich in den
jeweiligen Fachdokumenten. Die priorisierte weitere Umsetzung beschreibt der
[High-Level-Implementierungsplan](GNAI-001-PLAN_Project-Roadmap.md).
## 1. Dokumente
### Projektsteuerung
| Dokument | Verbindlicher Inhalt |
| --- | --- |
| [GNAI-001](GNAI-001-PLAN_Project-Roadmap.md) | priorisierte nächste Schritte, Entscheidungstore und Abnahmekriterien |
| [GNAI-013](GNAI-013-PLAN_Security-Closure-and-Repository-Restructure.md) | aktive Checkliste für Sicherheitsabschluss, Repository-Struktur und Übergang zum LLM-Stack |
### Plattform und Sicherheit
| Dokument | Verbindlicher Inhalt |
| --- | --- |
| [Bereichsindex](platform/README.md) | Einstieg in Host-, Zugriffs-, Reverse-Proxy- und VPN-Dokumentation |
| [LLM-Server](platform/llm-server/README.md) | Geräteindex für Host, AI-Serving und Encoding auf `10.0.0.90` |
| [Ghostnet.AI-Host](platform/llm-server/host/GNAI-002-INFRA_BaseSystem.md) | GNAI-002 Hardware und Debian-Basis des KI-Servers `10.0.0.90` |
| [Ghostnet.AI-Zugänge](platform/llm-server/host/GNAI-003-INFRA_Users.md) | GNAI-003 Benutzer, Hostnetz, Resolver und SSH des KI-Servers |
| [GNAI-005](platform/GNAI-005-SEC_Access-Control.md) | Rollen- und Zugriffsziel |
| [Proxmox-Server](platform/proxmox-server/README.md) | Geräteindex für den Hypervisor-Kontext und seine LXCs |
| [Proxmox-LXC-SSH](platform/proxmox-server/GNAI-011-SEC_LXC-SSH-Architecture.md) | GNAI-011 gemeinsame SSH-Sicherheitsarchitektur der LXCs; Hypervisor ausgenommen |
| [GNAI-012](platform/proxmox-server/lxc/ct-100-dns/GNAI-012-PLAN_Pi-hole-DNS-Handoff.md) | implementierter Pi-hole-LXC, FRITZ!Box-DNS, Split-DNS, Abnahme und Rückfallstand |
| [CT 102 / GNAI-014](platform/proxmox-server/lxc/ct-102-keycloak/GNAI-014-SEC_Keycloak.md) | Keycloak-LXC, sichere SSH-Zugänge und Trennung von öffentlichem OIDC und interner Administration |
| [GNAI-015](platform/proxmox-server/lxc/ct-102-keycloak/GNAI-015-PLAN_Keycloak-Podman-Migration.md) | Blue/Green-Migration von Keycloak/H2 auf Podman, PostgreSQL und aktuelle 26.x-Version |
| [GNAI-016](platform/proxmox-server/lxc/ct-102-keycloak/GNAI-016-PLAN_Keycloak-Ansible-Rebuild.md) | nachgelagerter reproduzierbarer Neuaufbau von CT 102 mit Ansible und zweiter Blue/Green-Cutover von CT 104 |
| [CT 103 / GNAI-006](platform/proxmox-server/lxc/ct-103-reverse-proxy/GNAI-006-SEC_Reverse-Proxy.md) | NPM, Fail2Ban und Keycloak-Adminpfad |
| [CT 105 / GNAI-007](platform/proxmox-server/lxc/ct-105-wireguard/GNAI-007-SEC_VPN.md) | WireGuard-Gateway und Rollen-Firewall |
| [VPN-Client-Verwaltung](platform/proxmox-server/lxc/ct-105-wireguard/GNAI-007-SEC_VPN_Client-Management.md) | Ausgabe, Änderung und Widerruf von Geräteprofilen |
| [Windows 11](platform/proxmox-server/lxc/ct-105-wireguard/GNAI-007-SEC_VPN_Clients_Windows11.md) / [Linux](platform/proxmox-server/lxc/ct-105-wireguard/GNAI-007-SEC_VPN_Clients_Linux.md) | Client-SOPs |
| [VPN-Implementation-Log](platform/proxmox-server/lxc/ct-105-wireguard/GNAI-007-SEC_VPN_Implementation-Log.md) | historische Umsetzung und datierte Evidenz |
| [CT 101 / GNAI-017](platform/proxmox-server/lxc/ct-101-samba/GNAI-017-PLAN_Samba-NFS-Export.md) | Samba-Dateiserver `10.0.0.9`: Aufnahme ins Repository, NFS-Export und Encoding-Shares |
| [CT 101 / GNAI-018](platform/proxmox-server/lxc/ct-101-samba/GNAI-018-REQ_Encoding-Pipeline-Integration.md) | Requirements der Encoding-Pipeline an CT 101 — Übergabe an den Ansible-Rebuild |
| [CT 101 / GNAI-019](platform/proxmox-server/lxc/ct-101-samba/GNAI-019-DEC_Ansible-Migration.md) | Entwurfsentscheidungen der CT-101-Ansible-Migration: natives Samba, NFS-Ganesha als Quadlet, Fresh-State-Rebuild |
### KI und Deployment
| Dokument | Verbindlicher Inhalt |
| --- | --- |
| [Bereichsindex](platform/llm-server/ai/README.md) | Einstieg in die KI-Dokumentation |
| [GNAI-004](platform/llm-server/ai/GNAI-004-INFRA_Architecture.md) | Zielarchitektur und Vertrauensgrenzen |
| [GNAI-008](platform/llm-server/ai/GNAI-008-PLAN_Ansible-Deployment.md) | detaillierter Ansible-/Gitea-Planungsstand und Implementierungshistorie |
| [GNAI-009](platform/llm-server/ai/GNAI-009-PLAN_Llama-Model-Evaluation.md) | reproduzierbarer Modellvergleich |
| [GNAI-010](platform/llm-server/ai/GNAI-010-TECH_Llama-Serving.md) | technische Sollkonfiguration des Testing-Servings |
| [LLM-Server-Host-Ansible](../llm-server/host/ansible/README.md) | ausführbare Host-/ROCm-Playbooks und Rollen für `10.0.0.90` |
| [LLM-Stack-Ansible](../llm-server/llm/ansible/README.md) | ausführbares Ansible-Projekt für den LLM-Stack auf `10.0.0.90` (Production/Testing, Umschaltung, Backup) |
| [Encoding-Ansible](../llm-server/encoding/ansible/README.md) | ausführbares Ansible-Projekt für den CPU-Encoding-Workload auf `10.0.0.90` |
| [Keycloak-Ansible](../proxmox/lxc/ct-102-keycloak/ansible/README.md) | ausführbare Provisionierungs-, Restore- und Prüfautomation für CT 102 |
| [Samba-Ansible](../proxmox/lxc/ct-101-samba/ansible/README.md) | ausführbare Provisionierungs-, Backup- und Prüfautomation für CT 101 |
| [Reverse-Proxy-Ansible](../proxmox/lxc/ct-103-reverse-proxy/ansible/README.md) | ausführbare NPM-/Fail2Ban-Automation für CT 103 (adoptiert 07.11.2026, verifiziert 09.11.2026) |
### Video-Encoding und Monitoring
| Dokument | Verbindlicher Inhalt |
| --- | --- |
| [GNENC-000](platform/llm-server/encoding/GNENC-000-DOC_Index.md) | Bereichsstatus und offene Festlegungen |
| [GNENC-001](platform/llm-server/encoding/GNENC-001-PLAN_Architecture.md) | finale Architektur des CPU-Encoding-Workloads |
| [GNENC-002](platform/llm-server/encoding/GNENC-002-PLAN_Pipeline.md) | operative Encoding-Pipeline: Komponenten, Verzeichnislayout, Validierung, Statusmodell |
| [GNMON-000](platform/llm-server/monitoring/GNMON-000-DOC_Index.md) | Monitoring-Bereichsstatus: M1–M5 produktiv auf dem KI-Server, M6 vorbereitet |
| [GNMON-001](platform/llm-server/monitoring/GNMON-001-PLAN_Architecture.md) | Host-Monitoring-Plan v2.0 (umgesetzt M1–M5, belegter Stand in GNMON-000) |
| [Monitoring-Projekt](../llm-server/monitoring/README.md) | ausführbares Monitoring-Projekt (Rollen, Dashboard-App) für `10.0.0.90` |
Die Dokumente wurden am 21.09.2026 neu geordnet: Die Roadmap belegt
`GNAI-001`; die zuvor bestehenden Dokumente `GNAI-001` bis `GNAI-009` wurden
unter Beibehaltung ihrer Reihenfolge zu `GNAI-002` bis `GNAI-010`.
Am 22.09.2026 wurden KI-Host und Proxmox-LXCs in getrennte Unterverzeichnisse
überführt; GNAI-011 beschreibt die gemeinsame SSH-Architektur der LXCs.
Am 05.10.2026 wurde die Dokumentation geräteorientiert neu geordnet:
`platform/proxmox-server/` bildet den Proxmox-Kontext und seine LXCs ab,
`platform/llm-server/` den physischen KI-Server mit AI und Encoding.
Am 19.10.2026 wurde das ausführbare LLM-Server-Projekt in die fachlichen
Hauptverzeichnisse `llm-server/host/` (Grundkonfiguration des Servers),
`llm-server/llm/` (LLM-Stack), `llm-server/encoding/` (Encoding) und
`llm-server/monitoring/` (Monitoring) aufgeteilt; die Dokumentation folgt derselben Aufteilung (`host/`, `ai/`, `encoding/`, `monitoring/`).
## 2. Belegter Stand
| Bereich | Nachgewiesen | Noch nicht nachgewiesen |
| --- | --- | --- |
| KI-Host | Debian 13.6, Deployment-Zugang, Podman 5.4.2, getrennte rootless Konten, Gerätezugriff für beide KI-Konten; IPv4-only (31.10., GNAI-002 6); Lüftersteuerungs-Dienst `gnai-gpu-fan-control` als Dauerlösung (05.11., GNAI-010 10.10); Backup/Restore praktisch belegt (06.11., GNAI-008 14.6) und Backup-Unit per `RequiresMountsFor` boot-sicher (Fix 09.11., GNAI-008 14.6/0.21); Host-Neustart mit automatischem Production-Recovery (06.11. und erneut 09.11.2026, GNAI-008 14.6) | Host-/Treiber-Upgradepfad |
| GPU/ROCm | beide RX 6900 XT als `gfx1030`, `ROCm0` und `ROCm1` im gepinnten Testing-Image erkannt; Modellladen, Layer-Verteilung und reale Inferenz auf beiden GPUs; 64k- und 128k-Stabilität in Testing (GNAI-010 10.5–10.9); GPU-Sensoren im Monitoring mit Alarmgrenzen (GNMON-000 M4/M5, verifiziert 09.11.2026) | Hardware-Ursache des thermischen Defekts an Slot `03:00.0` (GNAI-010 10.10) — Lüfterkurven-Service überbrückt als Dauerlösung |
| LLM-Serving | drei gepinnte Profile (Swift 1.0, Swift 1.5, Unsloth); Testing-Abnahme 64k/128k je Profil (GNAI-010 10.5–10.9); Production-Umgebung live mit Swift 1.5 Q6_K seit 06.11.2026 (Betreiberbeschluss 05.11., GNAI-009 10.4) inklusive Health, Alias und Inferenztest; exklusive Umschaltmechanik mit Recovery (GNAI-008 14.6, T1–T7; nach Neustart 09.11.2026 `gn_ai_active_env{env="production"}=1` verifiziert) | öffentlicher Nutzerpfad (M6), LLM-Metriken jenseits `gn_ai_active_env`, Nutzerakzeptanzprüfung (GNAI-009 5.3) |
| Deployment | lokales Ansible-Control-Projekt und idempotente Hostrollen; Production-Inventar mit Referenz- und Rollback-Profil, `ai_environment_switch` und Backup-Timer deployt und abgenommen (GNAI-008 14.6) | statische CI, Runner, geschützte Freigaben und automatisierter Rollback über die Delivery-Kette |
| VPN | wg-easy v15.4.0; einziger Peer `ghost-laptop` als Server Admin; native nftables-Zielpolicy und NAT, Legacy-Bereinigung, Fremdnetz-, Positiv-/Negativ-, Dienst- und LXC-Wiederanlauftests bestanden; CT 104 am 07.10.2026 als zwölftes Ziel praktisch abgenommen; WAN-Exposure-Erfassung 10.11.2026: nur TCP 80/443 offen, keine AAAA (GNAI-007 7); frischer Stop-Mode-vzdump + hostunabhängige Kopie auf `ghostnet-ki` am 10.11.2026 | Fremdnetz-WAN-Rescan vom Hotspot (UDP 51820, TCP-Portmatrix), FRITZ!Box-Forward-/IPv6-Abgleich, wg-easy-GUI-HTTPS und KI-Server-Test bei eingeschaltetem Host |
| DNS / Pi-hole | CT 100 unter `10.0.0.14` mit digest-gepinntem Pi-hole 2026.09.0 als Podman-Quadlet; SSH/nftables, UDP/TCP-DNS, Split-DNS, Blocking/Allowlist, FRITZ!Box-Cutover, LXC-Reboot und Stop-Mode-Backup am 01.10.2026 abgenommen; Ansible-Projekt am 09.11.2026 adoptiert (ansible-deploy via pct; `site.yml`/`verify-production` `changed=0`) und Split-DNS-Record `mon.ghostnet.selfhost.eu → 10.0.0.10` live (verifiziert per `dig @10.0.0.14`); frischer Stop-Mode-vzdump + hostunabhängige Kopie auf `ghostnet-ki` + praktischer Restore-Test (CT 150) am 10.11.2026 (GNAI-012 10.2) | vollständige App-/OIDC-Regression, praktischer FRITZ!Box-Rollback, mobile DuckDuckGo-/IPv6-Strategie, WireGuard-Profile |
| Reverse Proxy | CT-103-Zugänge, SSH-/Firewall-Baseline, Reboot und lokales Backup abgenommen; NPM 2.15.1 routet öffentlichen OIDC- und internen Admin-vHost getrennt; öffentliche Keycloak-Administration liefert 403; vollständiger Ansible-Sollzustand importiert und adoptiert (07.11.2026; preflight/verify-production/`site.yml --check` am 09.11.2026 ohne Befund, `changed=0`); Fail2Ban-Funktionsabnahme (Jails, kontrollierter Ban/Unban, nftables-Nachweis, Dienstneustart, LXC-Reboot) am 10.11.2026 bestanden, frischer Rollback-vzdump + hostunabhängige Kopie auf `ghostnet-ki` (GNAI-006 10/12) | Fremdnetz-WAN-Rescan (Hotspot) und FRITZ!Box-Abgleich; NPM-Proxyhost `mon.ghostnet.selfhost.eu` für das Monitoring-Dashboard (M6) |
| Keycloak | CT 102 unter `10.0.0.4` reproduzierbar per Ansible aufgebaut; gepinntes Keycloak 26.2.4 und PostgreSQL 16.15, Restore von CT 104, Container-/DB-Härtung, NPM-Cutover, interner Adminzugang, öffentliche Admin-Sperre, realer Vaultwarden-OIDC-Login und LXC-Neustart abgenommen; Stabilisierungsphase + praktischer NPM-Rückfalltest auf CT 104 am 10.11.2026 bestanden, CT 104 danach nach Betreiberfreigabe entfernt (GNAI-016 Phase F); Ansible-Drift CT 102 `changed=0`; frischer Stop-Mode-vzdump + hostunabhängige Kopie auf `ghostnet-ki` am 10.11.2026 | Betriebs-/Backup-/Restore-SOP |
| Encoding | Konto, Pfade, eigener rootless Store und CPU-Isolation per Ansible verwaltet und verifiziert; NFS-Mount `/var/lib/ghostnet-pipeline` aktiv (verifiziert 09.11.2026); Planungsabschluss 19.10.2026 (Pipeline GNENC-002, Speicher auf CT-101); Monitoring-Anbindung umgesetzt (GNMON-000 M1–M5) | Implementierung (Images, Quadlets, Skripte, Worker); Lasttest und Limit-Feintuning; SMB-Output-Pickup als geschlossener Ablauf |
| Monitoring | M1–M6 produktiv auf `10.0.0.90` (System-Scope, Konten `gn-monitor` 986 / `gn-dashboard` 984): node_exporter + AMD-Textfile-Collector, VictoriaMetrics, Loki + Alloy, vmalert + Alertmanager (inkl. `gnmon-ai`/`GnAiEnvironmentDown`), Dashboard **v0.3.2 öffentlich über `https://mon.ghostnet.selfhost.eu`** (NPM CT-103 ID 14, LE-TLS; Keycloak-OIDC Realm Ghost.net, Client `gnai-dashboard`, Rollen `gnai-dashboard-user`/`-admin`; 8080 per nftables nur von 10.0.0.10; E2E inkl. 403-Negativtest und WebSocket-Circuit bestanden 09.11.2026, GNMON-000 M6) | echter SMTP-Versand, LLM-Metriken jenseits `gn_ai_active_env`, Retention-Feintuning, externer WireGuard-Zugriff auf mon (DNS/TLS öffentlich, praktisch ungetestet) |
| Samba (CT 101) | Share-Bestand in GNAI-017 dokumentiert; Ansible-Projekt nach GNAI-019 gebaut und lokal verifiziert; Runbooks vorhanden; In-Place-Upgrade auf Debian 13 am 21.10.2026; smb.conf-Verlust beim Upgrade aus vzdump-Backup wiederhergestellt, Media-Shares und Workstation-Mounts verifiziert | produktive Adoption (Platzhalter, Schlüssel, Convergence, Verifikation), NFS-Export und Encoding-Shares produktiv, UID/GID-Abgleich produktiv, Backup-/Restore-Test |
Ein Zielbild, eine Betreiberangabe oder ein erfolgreicher Teiltest gilt nicht als
vollständige Abnahme. Datierte Details stehen im zuständigen Fachdokument.
## 3. Bestätigte Leitentscheidungen
- Ein Infrastructure-Repository verwaltet den Sollzustand des gemeinsamen Hosts.
- AI Production und AI Testing verwenden bereits getrennte Konten,
Datenpfade und Podman-Stores; ihre späteren Units und Netze bleiben ebenfalls
getrennt. Host, Kernel und GPUs teilen sie dennoch. Sie sind daher keine
getrennten Fehlerdomänen und laufen GPU-seitig nicht gleichzeitig.
- Video-Encoding bleibt CPU-basiert, besitzt keinen GPU-Zugriff und wird erst
nach einem gemeinsamen Lasttest parallel freigegeben.
- Container- und Modellartefakte werden unveränderlich über Version, Revision,
Digest beziehungsweise SHA-256 festgelegt; `latest` ist kein Deploymentziel.
- `llama.cpp` bleibt ein internes Backend ohne Host-Port. Eine öffentliche
Schnittstelle benötigt eine eigene Authentifizierungs-, Quota- und
Veröffentlichungsentscheidung.
- Production läuft als eigene Umgebung (`gnai-production`, Swift 1.5 Q6_K);
der Wechsel zwischen Production und Testing erfolgt exklusiv über
`ai_environment_switch` mit automatischem Rückfall auf Production
(GNAI-008 14.6). Der Sollzustand wird am 09.11.2026 nach einem Host-Neustart
automatisch wiederhergestellt (verifiziert: `gn_ai_active_env{env="production"}=1`).
- Monitoring-Dienste binden ausschließlich an 127.0.0.1; eine externe
Freigabe des Dashboards erfolgt erst über NPM + Keycloak-OIDC (GNMON-000 M6).
- Managementzugriff erfolgt über WireGuard plus Dienstauthentifizierung.
Client-Routing allein ist keine serverseitige Autorisierung.
- Der Schlüssel von `ansible-deploy` ist wegen `NOPASSWD: ALL` root-äquivalent
und darf nicht ungeprüft an Pull-Request-Workflows weitergegeben werden.
## 4. Offene Sicherheits- und Entscheidungsgrenzen
Vor einer neuen öffentlichen KI-Schnittstelle müssen mindestens diese Befunde
geschlossen sein:
1. Fail2Ban-Jails, kontrollierten Ban und Wiederanlauf nachweisen — **am
10.11.2026 geschlossen** (GNAI-006 Abschnitt 12: Image/Digest, Config-Test,
Jails, Filter-Dry-Run, kontrollierter Ban/Unban mit nftables-Nachweis,
Dienstneustart, LXC-Reboot; Befund: neuer Proxy-Host `proxy-host-14` war
bis zum f2b-Restart nicht im Jail-Glob — SOP ergänzt);
2. öffentliche IPv4-/IPv6-Exposure erneut erfassen — **teilweise 10.11.2026**
(WAN-TCP-Scan: nur 80/443 offen; keine AAAA-Records; GNAI-007 Abschnitt 7);
Fremdnetz-Rescan vom Hotspot, FRITZ!Box-Forward-Abgleich und
FRITZ!Box-IPv6-Status bleiben Betreiberschritt;
3. die Keycloak-Stabilisierungsphase sowie den praktischen NPM-Rückfall auf
CT 104 abschließen — **am 10.11.2026 geschlossen:** Stabilisierungsphase
nachgewiesen (26 Tage, `NRestarts=0`, keine Fehler) und praktischer
NPM-Rückfalltest bestanden (Hosts 7/13 auf `10.0.0.16:8080`, Discovery 200
+ kanonischer Issuer, `/admin/` öffentlich 403, auth-admin 302, Rückschaltung
auf `10.0.0.4` erneut positiv; CT 104 danach wieder gestoppt). Bekannte
Einschränkung des CT-104-Rückfallstands (Datenstand 13.10., neuere
OIDC-Clients fehlen) in GNAI-016 dokumentiert. **CT 104 am 10.11.2026 nach
ausdrücklicher Betreiberfreigabe entfernt** (Archiv + historische
Altbackups SHA-256-verifiziert auf `ghostnet-ki` archiviert, dann auf PVE
gelöscht; Details GNAI-016 Phase F);
4. für DNS, Reverse Proxy und Keycloak hostunabhängige Backups und mindestens
einen praktisch getesteten Restorepfad festlegen — **am 10.11.2026
geschlossen** (frische Stop-Mode-vzdumps CT 100/102/103/105,
hostunabhängige Kopie auf `ghostnet-ki` mit SHA-256-Verifikation, nächtlicher
Sync-Timer auf dem PVE-Host, praktischer Restore-Test CT 100 → CT 150
bestanden; GNAI-012 Abschnitt 10.2, GNAI-006 Abschnitt 10). Offen bleibt
nur der praktisch durchgespielte FRITZ!Box-DNS-Rollback auf einem Testclient.
Die öffentliche Keycloak-Administration, der Vaultwarden-OIDC-Pfad und die
serverseitigen WireGuard-Rollengrenzen sind zum Stand 14.10.2026 bereits
positiv und negativ abgenommen. Sie bleiben Regressionstest, sind aber keine
offenen Erstimplementierungen mehr.
Noch zu entscheiden sind insbesondere:
- API-only oder zusätzlich Weboberfläche als erstes Nutzerprodukt;
- ob LiteLLM in der ersten Veröffentlichung für individuelle Keys, Quoten oder
Routing tatsächlich benötigt wird;
- Freigabe- und Secret-Modell für einen späteren privilegierten Runner.
Bereits entschieden (nicht mehr offen): Das Backupziel ist die bestehende
NFS-Anbindung der Encoding-Pipeline (`pve:/media/datenhdd3/Encoding`), die
Aufbewahrung beträgt 8 Archive und der Restore ist praktisch belegt
(Betreiberentscheidungen 06.11.2026, GNAI-008 14.6). Die Kontextfrage ist
mit dem M3-Beschluss vom 05.11.2026 geklärt: 128k ist das Zielprofil und in
Testing technisch abgenommen (GNAI-010 10.6), Production-Profil ist
Swift 1.5 Q6_K (GNAI-009 10.4). Der interne LLM-Vertical-Slice (M2) ist
abgenommen und läuft produktiv; die Entscheidung „Sicherheitsabschluss vor
oder parallel zum LLM-Ausbau" betrifft daher nur noch die externe Freigabe (M6).
## 5. Pflegeprinzip
Neue technische Evidenz wird zuerst im ausführbaren Projekt beziehungsweise im
zuständigen Fachdokument aktualisiert. Dieser Index wird nur geändert, wenn
sich ein bereichsübergreifender Status, eine Leitentscheidung oder die
Priorisierung ändert. Dadurch werden lange Laufprotokolle und Sollparameter
nicht mehr an mehreren Stellen dupliziert.