CS-Tools & Scripts

Die napp-it 4ai Client-Server Tool-Familie

Eigenständige Go-Programme und Begleit-Skripte rund um napp-it 4ai — jedes mit eigenem öffentlichen GitHub-Repository unter github.com/guenther-alka. Alphabetisch aufgelistet.

cs-aihelp

github.com/guenther-alka/cs-aihelp

Go-Daemon für den AI Helpdesk im napp-it Web-GUI. Beantwortet Fragen per RAG über die eingebaute Dokumentation, ergänzt um Web-Recherche und Anbindung an Ollama oder OpenAI-kompatible Provider. Nach Bestätigung und manueller Passworteingabe kann der AI Helpdesk eine interaktive Root-Console für Fehlersuche und Setups steuern.

cs-console

github.com/guenther-alka/cs-console

Interaktives PTY-/Konsolen-Backend für System > Console und den AI-Helpdesk-Konsolenmodus. Wird bei Bedarf von server.pl gestartet, erfordert stets einen root-/Administrator-Elternprozess und im Interactive-Shell-Modus zusätzlich eine Passwort-Eingabe über die Konsole selbst.

cs-freeze4snap

github.com/guenther-alka/cs-freeze4snap

Stellt vor ZFS-Snapshots konsistente Dateisysteme sicher — per QEMU-Guest-Agent fsfreeze, QMP stop-cont oder FIFREEZE/cgroup-v2 für LXC-Container. Seit v1.1.0 auch Hotsnaps von ESXi-VMs auf NFS-Datastores (per ssh oder soap; das Tool läuft auf jedem Rechner, der den ESXi-Host erreicht, z. B. dem Frontend): VM-Snapshots, ZFS-Snapshot, VM-Snapshots wieder entfernen. Builds für Linux, macOS, Windows, FreeBSD, illumos und Solaris. In Snapshot- und Replikationsjobs direkt über die GUI auswählbar.

cs-imageindex

github.com/guenther-alka/cs-imageindex

Foto-/Video-Ordner-Indexer: liest EXIF-/GPS-Daten aus, erzeugt Szenenbeschreibungen per Vision-LLM und erkennt Gesichter. Baut einen durchsuchbaren Index für ganze NAS-Verzeichnisse, arbeitet im Hintergrund und läuft auf Windows, Linux, macOS und illumos.

cs-proxy

github.com/guenther-alka/cs-proxy

Go-basierter HTTP/HTTPS-Edge vor webserver.pl: terminiert TLS, liefert statische Inhalte mit Caching/Kompression und reverse-proxied dynamische Requests. Optional zusätzlich eigenständiger Reverse-Proxy für lokale KI-Backends (llama-server, Ollama) mit API-Key- und IP-Absicherung.

cs-s3gateway

github.com/guenther-alka/cs-s3gateway

Nur lesender S3-Zugang und Web-Seite für ZFS-Snapshots und normale Ordner als einzelnes Go-Binary ohne eigenes Datenformat: jeder Snapshot eines Datasets (<dataset>/.zfs/snapshot) erscheint als schreibgeschützter Ordner in einem Bucket, normale Ordner lassen sich als weitere Buckets freigeben. Nutzt Zugangsdaten und Zertifikat von RustFS (SigV4, TLS, Ordner-Jail, Idle-Timeout) und ist mit WinSCP, rclone, restic, aws cli oder direkt im Browser (Ansicht und Download) erreichbar. Start, Stop, Autostart, Idle-Timeout und Buckets über das Menü System > Services > CS-S3 Gateway.

cs-scripts

github.com/guenther-alka/cs-scripts

Begleit-Repository mit Build-Skripten für OmniOS/illumos und Solaris (RustFS, cs-imageindex, rclone, restic) sowie dem eigenständigen Ollama-Bibliotheks-Parser, den die Seite „About > CS Tools Download" für die Modellauswahl lädt.

cs-send

github.com/guenther-alka/cs-send

Benachrichtigungs-Tool für Report-Jobs: verschickt Status- und Fehlermeldungen per SMTP-Mail oder an Discord, Slack, ntfy, Gotify und Telegram. Fest in die napp-it CS Report-Job-Infrastruktur eingebunden.

cs-sleeper

github.com/guenther-alka/cs-sleeper

Daemon für automatisches Disk-Spin-down und -Wake-up im Menü System > Power. Reduziert Stromverbrauch und Laufzeit ungenutzter Festplatten, ohne aktive Pools oder Freigaben zu beeinträchtigen.

cs-stream

github.com/guenther-alka/cs-stream

Verschlüsselter Tunnel-/Streaming-Proxy (vormals zstream) für bidirektionale Verbindungen zwischen Servern. Dient unter anderem als Transport-Layer für rclone-Übertragungen und erzwingt seit v2.1.0 eine explizite IP-Allowlist.

cs-sync

github.com/guenther-alka/cs-sync

Echtzeit-Sync-Tool für Dateien, ZFS-Ziele und S3-/RustFS-Buckets mit eigenem Wire-Protokoll, Lösch-Budget, Quarantäne und ChaCha20-Poly1305-Verschlüsselung. Ins Realtime-Sync-Menü von napp-it CS integriert, Autostart über server_boot_tasks.pl.

cs-team

github.com/guenther-alka/cs-team

Eigenständige Zusammenarbeits-Plattform („Nextcloud light“) als einzelnes Go-Binary mit eingebauter Web-Oberfläche, auch auf dem Handy nutzbar: CalDAV-Kalender, Calc und Text mit Mehrbenutzer-Bearbeitung, Files mit Freigaben und WebDAV, Aufgaben (Ticketsystem light), Chat und Nachrichten sowie Benutzer, Gruppen und Organisationen. Speicher ist ein Ordner (z. B. ZFS-Dataset) oder ein S3-/RustFS-Bucket; Start und Stop über das Menü System > Services > 17_cs-team. Mail-Server, DynDNS-Adresse und Webhooks werden in cs-team selbst (Menü Einstellungen) eingestellt.

📄 Handbuch (Deutsch, PDF)  ·  📄 Manual (English, PDF)

Hinweis: Die Tools werden nicht automatisch heruntergeladen — die Installation erfolgt manuell über das Menü About > CS Tools Download im napp-it CS Web-GUI. Ein manuelles Herunterladen von GitHub per Hand ist dabei trotzdem nicht nötig.