System-Dokumentation & Referenz

Offizielle Übersicht aller installierten Komponenten, Zugangsdaten & Konfigurationen auf needfuldings.de

Zurück zum Dashboard PDF herunterladen (4 Seiten)
Domain / FQDN needfuldings.de
Öffentliche IP-Adresse 82.165.188.200
Virtualisierung / OS Debian 13 Host & KVM Debian 12 Gast
Standard-Credentials mayk / mksms
1. Vollständige Zugangsdaten- & Dienst-Matrix
Dienst Öffentliche URL / Port Interner Port Benutzer Passwort Aktion
Service Dashboard https://needfuldings.de/ 127.0.0.1:5000 Kein Login Kein Login Öffnen
Rancher Manager v2.15 https://needfuldings.de:8443 NodePort 30443 root mksms Öffnen
Cockpit KVM Host UI https://needfuldings.de:9090 Host:9090 mayk / root mksms Öffnen
Webmin Admin Panel https://needfuldings.de:10000 Host:10000 mayk / root mksms Öffnen
Obsidian Web https://needfuldings.de/obsidian/ NodePort 30300 mayk mksms Öffnen
n8n Automation https://needfuldings.de/n8n/ NodePort 30568 mayk mksms Öffnen
Llama.cpp WebUI (Text LLM) https://needfuldings.de/llamacpp/ NodePort 30800 Kein Login Kein Login Chatten
OpenAI-kompatible API https://needfuldings.de/v1 NodePort 30800 Bearer Token beliebiger String Modelle
VLM Vision WebUI (Multimodal) https://needfuldings.de/vlm/ NodePort 30801 Kein Login Kein Login Vision UI
Ollama Vision (Moondream2 / n8n) https://needfuldings.de/ollama/ NodePort 31434 Kein Login Kein Login API Tags
ASP.NET Sample App https://needfuldings.de/sample/ NodePort 30080 Kein Login Kein Login Öffnen
PostgreSQL 16 (Timescale + Vector) needfuldings.de:5432 5432 / 30542 mayk (DB: needfuldings) mksms
Qdrant Vector Database https://needfuldings.de/qdrant/ NodePort 30633 API-Key mksms Dashboard
phpMyAdmin (MySQL WebUI) https://needfuldings.de/phpmyadmin/ NodePort 30088 mayk / root mksms Öffnen
MySQL / MariaDB Server needfuldings.de (Intern / Cluster) 3306 / 30306 mayk (DB: needfuldings) mksms
Google Drive Cloud Drive /mnt/gdrive (Host & KVM) claimName: gdrive-pvc rclone / GDrive OAuth / SA Key
NeedfulShop (C# Blazor Webshop) https://needfuldings.de/ Port 5005 mayk (Shop & Admin) mksms Shop
Odoo 17 ERP, CRM & Webshop https://needfuldings.de/odoo/ NodePort 30069 / 30072 admin / mayk (DB: odoo) mksms Odoo Web
C# HFT Trading Core (ZeroMQ) needfuldings.de:30555 NodePort 30555 / 30556 ZeroMQ RPC & Stream K3s Pod (hft)
SSH KVM VM (Debian) needfuldings.de:18 192.168.122.100:18 mayk mksms
SSH Host (Debian 13) 82.165.188.200:22 Host:22 root / mayk mksms
2. Obsidian Konfigurations-Anleitung (OpenAI Endpoint)

Um die lokale KI in Obsidian (z.B. mit den Plugins Copilot, Smart Connections oder Text Generator) zu nutzen, tragen Sie in den Plugin-Einstellungen folgende Werte ein:

Text LLM (Qwen 2.5 1.5B Instruct)
  • Base URL / API Endpoint:
    https://needfuldings.de/v1
    (oder https://needfuldings.de/llamacpp/v1)
  • Chat Completions Endpoint:
    https://needfuldings.de/v1/chat/completions
  • API Key:
    sk-local-needfuldings (beliebiger String)
  • Model Name:
    qwen2.5-1.5b-instruct
Vision VLM (Qwen2-VL 2B Multimodal)
  • Base URL / API Endpoint:
    https://needfuldings.de/vlm/v1
  • Chat Completions Endpoint:
    https://needfuldings.de/vlm/v1/chat/completions
  • API Key:
    sk-local-needfuldings (beliebiger String)
  • Model Name:
    Qwen2-VL-2B-Instruct
Ollama Vision Model (Moondream2 1.8B für n8n)
  • Ollama Chat Model Node Base URL (n8n intern):
    http://ollama-service.ai.svc.cluster.local:11434
  • Ollama Chat Model Node Base URL (Web / Extern):
    https://needfuldings.de/ollama
  • OpenAI Chat Model Node Base URL:
    https://needfuldings.de/ollama/v1 (oder https://needfuldings.de/ai/v1)
  • Model Name:
    moondream (oder moondream:latest)
  • Credentials / API Key:
    Keine nötig für Ollama Node; Beliebiger Dummy-Key (z.B. "ollama") für OpenAI Node
Hinweis für Obsidian Web im Cluster: Wenn Sie Obsidian über den internen Browser nutzen, können Sie als Base URL auch direkt die interne Cluster-Adresse http://127.0.0.1:30800/v1 oder http://llamacpp-service.ai.svc.cluster.local:8080/v1 eintragen.
3. System-Architektur

Die gesamte Umgebung ist als isolierte Schichten-Architektur aufgebaut:

  1. Bare-Metal Host: Debian 13 (Trixie) mit KVM/Libvirt, Cockpit (Port 9090) und Webmin (Port 10000).
  2. KVM-Gast (debian-vm): Debian 12 Bookworm mit 8 GB RAM, 4 vCPUs und 4 GB Swap. IP: 192.168.122.100.
  3. Port-Forwarding: Host leitet Ports 18 (SSH), 80 (HTTP), 443 (HTTPS) und 8443 (Rancher) via IPTables DNAT an die VM weiter.
  4. Nginx Reverse Proxy: Handhabt TLS-Terminierung (Let's Encrypt), WebSocket-Upgrades und Path-basiertes Routing.
  5. K3s Kubernetes Cluster: Verwaltet Rancher, n8n, Obsidian, ASP.NET und die AI-Deployments im Namespace ai.
4. Wichtige Administrations-Befehle
Status aller K3s Pods einsehen: kubectl get pods -A -o wide
KI-Pods im Namespace ai prüfen: kubectl -n ai get pods
Nginx Konfiguration testen & neu laden: sudo nginx -t && sudo systemctl reload nginx
Dashboard-Dienst neustarten: sudo systemctl restart servicedashboard
VM vom Host aus steuern (KVM): virsh list --all / virsh reboot debian-vm
5. C# ASP.NET Core Blazor E-Commerce & Odoo 17 ERP Backend

Die E-Commerce-Plattform kombiniert ein performantes, modulares C# Blazor Frontend mit dem vollintegrierten Enterprise-Backend von Odoo 17 und einem echtzeitfähigen ZeroMQ Event-Dispatcher:

C# Blazor Frontend (NeedfulShop)
  • Framework: .NET 8 / ASP.NET Core Blazor Interactive Server
  • Features: Landingpage, Produktkatalog mit Live-Suche & Filtern, Warenkorb, Kasse
  • Administration: Eigenes Admin-Portal unter /admin für Produkte, Aufträge & CRM
  • Headless API: /api/shop/products, /api/shop/leads, /api/shop/health
Odoo 17 ERP & CRM Backend
  • Namespace: erp im K3s Cluster
  • Module: CRM, Verkauf (Sales), Website Sale & Lager (Stock)
  • Datenbank: PostgreSQL 16 (DB: odoo, User: odoo)
  • Schnittstelle: JSON-RPC 2.0 Protokoll (Port 30069)
ZeroMQ / NetMQ Dispatcher
  • Protokoll: NetMQ High-Speed PUB/SUB Event Bus
  • Latenz: Sub-Millisekunden-Übertragung (< 0.5 ms)
  • Topics: order.created, crm.lead.created, product.created
  • Modularität: Erweiterbar für externe Worker, Dispatcher & Realtime Services

Vollständige Dokumentation als PDF verfügbar

Laden Sie das 4-seitige PDF-Dokument mit allen technischen Details, Diagrammen, Konfigurationen und Credentials herunter:

PDF Dokumentation herunterladen