Files
infrastructure/docs/GNAI-000-DOC_Index.md
T
2026-09-19 15:55:58 +02:00

7.1 KiB
Raw Blame History

Ghostnet.AI – Dokumentationsindex und Projektstand

Stand: 2026-09-19
Status: Revisionen zusammengeführt; Sicherheitsumsetzung und technische Endabnahme offen

1. Dokumente und Zielgruppen

Dokument Zweck / Zielgruppe
GNAI-001-INFRA_BaseSystem.md Hardware und Debian-Installation; Intermediate IT
GNAI-002-INFRA_Users.md Benutzer, statisches Hostnetz, Resolver und SSH; Intermediate IT
GNAI-003-INFRA_Architecture.md Gesamtzielarchitektur und Inventar; Intermediate IT
GNAI-004-SEC_Access-Control.md verbindliches Rollen- und Zugriffsziel; Intermediate IT
GNAI-005-SEC_Reverse-Proxy.md NPM/Fail2Ban und Keycloak-Korrekturverfahren; Intermediate IT
GNAI-006-SEC_VPN.md wg-easy-Installation/Konfiguration in Proxmox LXC; Intermediate IT
GNAI-006-SEC_VPN_Client-Management.md neue eigenständige GUI-SOP für Ausgabe, Änderungen und Widerruf; Intermediate IT
GNAI-006-SEC_VPN_Clients_Windows11.md offizieller Windows-Client, Import und Verwendung; Junior IT
GNAI-006-SEC_VPN_Clients_Linux.md Debian, Arch/CachyOS, Fedora/Kinoite; Junior IT
GNAI-006-SEC_VPN_Implementation-Log.md historische v14/v15-Umsetzung und Evidenzkorrekturen; Intermediate IT

2. Verbindliche, bestätigte Entscheidungen

NPM ist .10, WireGuard .15, Proxmox .2, KI-Server .90, Fritzbox .1, jeweils im Heimnetz 10.0.0.0/24. Server/LXCs verwenden statische Adressen bis .99, Client-DHCP .100–.200. Der aktuelle Bereich ist keine VLAN-Isolation und keine automatische Server-Admin-ACL.

Familie darf das gesamte Heimnetz erreichen; Server Admins Proxmox, Service-LXCs und KI-Server; LLM Admins ausschließlich KI-Server. Profile werden durch Administratoren pro Gerät erstellt und geschützt verteilt. Serverseitige Firewall Allowed IPs sollen die Rechte erzwingen. Per-Client Firewall ist aber derzeit deaktiviert. wg-easy-GUI-Zugriff ist für Familie und Server Admin vorgesehen; HTTPS ist ein offener Umsetzungsvorschlag.

wg-easy läuft rootful in CT 105 als Podman-Quadlet mit v15.4.0 und host-Netz im LXC. Ein lesender SSH-Abgleich am 18.09.2026 bestätigte aktives wg-easy/nftables, IPv4-Forwarding, eine breite VPN→LAN-Regel und MASQUERADE in iptables-legacy; Details und Grenzen stehen im Implementation-Log. MASQUERADE wird mangels Rückroute gebraucht. Ein nftables-Reload mit flush ruleset kann dynamische Regeln entfernen; Wiederanlauf muss abgenommen werden.

Der KI-Server heißt laut lesendem SSH-Abgleich vom 18.09.2026 ghostnet-ki; die Konten sind ghost, debugofen und das neu angelegte ghost-agent. admin existiert auf diesem Host nicht; der WireGuard-LXC verwendet separat admin. ghostnet.ki mit Punkt ist höchstens ein lokal angelegter SSH-Alias. OIDC ist laut Betreiber produktiv nur für Vaultwarden; weitere Dienste sind geplant.

Die getrennten Schlüsselzugänge für ghost und ghost-agent wurden am 19.09.2026 erfolgreich getestet. Der persönliche Login wurde vom Betreiber interaktiv bestätigt; der Agentenlogin wurde technisch gegen Benutzername und Hostname geprüft.

Der KI-Server ist laut Betreiber frisch eingerichtet. Die LLM-Anwendungen sollen erst in einem späteren Sprint mit Ansible installiert werden. Bis dahin beschreiben GNAI-003 und GNAI-004 für diesen Host ein Zielbild; der lesende SSH-Abgleich betraf nur Basisbetrieb und Zugänge.

3. Sicherheitsbefunde mit Priorität

Befund dokumentiertes Verfahren / Status
Keycloak-Administration öffentlich erreichbar, externe Anmeldung möglich GNAI-005: Adminpfad-Schutz, interner Adminzugang, externe Sperrtests und Vaultwarden-OIDC-Prüfung; noch nicht angewendet
VPN-Zielrechte nur im lokalen Profil GNAI-006 und GUI-SOP: Per-Client Firewall, Gateway-INPUT-Regeln und negative Tests; noch nicht angewendet
Fail2Ban-Image auf 1.1.0-r2-ls43 fest gepinnt; Container läuft wieder GNAI-005: Pin umgesetzt; effektives Image, Jails, kontrollierte Bans sowie Dienst-/LXC-Wiederanlauf noch abzunehmen
HTTP-Client-User-Agents werden bewusst gebannt GNAI-005: mögliche legitime Treffer und rollen-/routingabhängiger VPN-Ausweichweg dokumentiert

4. Noch erforderliche Angaben

Frage / fehlender Nachweis Grund
Aktualisiert selfHOST den VPN-Eintrag nach einem WAN-IP-Wechsel zuverlässig? Am 18.09.2026 stimmte vpn.ghostnet.selfhost.eu mit der ausgehenden IPv4 des Gateways überein; vpn.ghostnet.dyndns.eu zeigte auf eine andere IPv4. Profile verwenden selfhost.eu. Ein einzelner Abgleich belegt keinen dauerhaften DynDNS-Betrieb.
Gehört Altpeer Laptop-FullAdmin künftig Familie oder Server Admin? neue Zielrechte und Gateway-INPUT-Freigaben hängen davon ab.
Welche Verwaltungsgeräte dürfen lokal auf die GUI und welcher interne Adminhostname soll verwendet werden? VPN-Rollen ordnen lokale LAN-Quellen nicht automatisch zu.
Welchen OIDC-Issuer/Realm nutzt Vaultwarden und wo terminiert auth-HTTPS tatsächlich? NPM-SSL-Optionen aus, externer HTTPS-Login möglich; Realm-Sperren dürfen den produktiven Login nicht unbeabsichtigt stören.
Welcher Dienst erzeugt /etc/resolv.conf auf dem KI-Server tatsächlich? networking verwaltet die statische Schnittstelle; die Datei trägt einen dhcpcd-Kommentar, obwohl dhcpcd beim Abgleich nicht aktiv war. Vor einer DNS-Änderung den Erzeugungsweg prüfen.

Es werden keine Werte für diese offenen Angaben angenommen. Die betreffenden Verfahren sind entsprechend eingeschränkt oder als Vorschlag markiert.

5. Validierung und Abschluss

Bei der Dokumentationskonsolidierung wurden keine Serverkonfigurationen geändert, keine VPN-Praxisprüfungen nachgeholt und keine Keycloak-Sperre live bestätigt. Aussagen zum Ist-Stand beruhen auf den protokollierten Betreiberangaben und Tests; sie sind keine neue Live-Inventur.

Am 18.09.2026 wurden WireGuard-LXC und KI-Server ergänzend lesend per SSH geprüft. Der KI-Server-Teilabgleich bestätigt Hostname, Konten, Netzkonfiguration, Debian-Version, CPU, RAM, zwei Navi-21-GPUs und SSD-Partitionierung; BIOS, ROCm und die Anwendungsdienste wurden dabei nicht abgenommen. Details stehen in GNAI-001 und GNAI-002.

Die WireGuard-Evidenz bleibt der Teiltest vom 12.09.2026: CachyOS-Laptop von WAN, Handshake, Ping auf Gateway/Proxmox und direkter IPv4-Internetpfad bestanden; KI-Server war ausgeschaltet. Neue Rollen, weitere Clientvarianten, Gateway-GUI-Zugriff, WAN-/IPv6-Isolation, Neustart und Restore sind noch nicht abgenommen. GNAI-006 ist erst nach Klärung der offenen Werte, Umsetzung und dokumentierter Abnahme technisch abgeschlossen.