spektr d40712e9ab
ci-static / secret-scan (push) Successful in 21s
ci-static / yamllint (push) Successful in 1m13s
ci-static / ansible-syntax (push) Successful in 29s
ci-static / markdown-links (push) Successful in 20s
ci-static / secret-scan (pull_request) Successful in 21s
ci-static / yamllint (pull_request) Successful in 33s
ci-static / ansible-syntax (pull_request) Successful in 27s
ci-static / markdown-links (pull_request) Successful in 21s
M6: Websuche in OpenWebUI produktiv — SearXNG kuratiert + Native/Agentic Mode (GNAI-020)
Root causes des bisherigen Haengers: ENABLE_WEB_SEARCH fehlte (Default False
in v0.13.3), persistierte config-Tabelle schlug die Env-Werte
(web.search.enable=false, engine=""), ENABLE_RAG_WEB_SEARCH ist in v0.13.3
tot, SearXNG lief mit 123 Default-Engines, und meta.defaultFeatureIds des
Modells war leer (neue UI-Chats starten ohne Web-Search-Toggle).

- web_search-Rolle: settings.yml mit keep_only (43 kuratierte Engines, Namen
  aus der Default-settings.yml des gepinnten Images 626105eec), alle Engines
  auf categories:[general] + disabled:false (OpenWebUI sendet keinen
  categories-Parameter), outgoing.request_timeout 2.5s/max 8s,
  suspended_times auf Minuten verkuerzt; Probe assertet echte JSON-results.
- open_webui-Rolle: ENABLE_WEB_SEARCH=True, RESULT_COUNT=8,
  WEB_SEARCH_CONCURRENT_REQUESTS=4, WEB_FETCH_MAX_CONTENT_LENGTH=100000,
  USER_AGENT (Browser-String); ENABLE_RAG_WEB_SEARCH entfernt;
  Quadlet-Template quotet Environment="KEY=value" (systemd-Split bei Spaces,
  betraf u.a. OAUTH_SCOPES).
- DB-Sync idempotent: config-rows web.search.*/web.fetch.* an Env angleichen
  (DB gewinnt ueber Env), Model-Meta capabilities.web_search +
  builtinTools.web_search=true + defaultFeatureIds=["web_search"],
  Workspace-Tool gnai-web-search (web_search/fetch_url gegen
  http://searxng:8080) mit public read grant fuer API-Agenten via tool_ids.
- Doku GNAI-020 (Umsetzung, Verifikation, UI-/API-Pfade Path A/B,
  NPM-Timeout-Betreiber-Schritt); Index + Roadmap M6 aktualisiert.

Verifiziert 12.11.2026 auf 10.0.0.90: SearXNG 168 Ergebnisse/1,4 s, aus
OpenWebUI-Container via Alias HTTP 200/1,9 s; /api/models zeigt
defaultFeatureIds=['web_search']; E2E Path A ohne tool_ids (nur session_id
+ features.web_search): server-seitiger Loop search_web x2 + fetch_url x2,
Zitation in sources, korrekte Antwort mit Quellen (v0.13.3, 2026-11-08);
Playbook danach changed=0; secret-scan/yamllint/ansible-syntax/links OK.

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-11-12 03:41:17 +01:00

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.

S
Description
No description provided
Readme
2.1 MiB
Languages
Jinja 28.5%
Shell 23.7%
HTML 18.6%
CSS 10.9%
C# 10%
Other 8.3%