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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

cs-sync

github.com/guenther-alka/cs-sync

Echtzeit-Sync-Tool für Dateien, ZFS-Ziele (Sender/Master pusht, zfsreceive ist der Empfänger/Slave-Modus - früher zfspull) und S3-/RustFS-Buckets mit eigenem Wire-Protokoll. Für Proxmox speichert es die VM-/CT-Config als ZFS-Property an den Disks (cs-sync pveconf, Restore für die Disaster Recovery einer VM, Anleitung im Handbuch), 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.

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

cs-team

github.com/guenther-alka/cs-team

Ein einzelnes Go-Programm mit eingebauter Web-Oberfläche, ohne Datenbank, für Teams, Schulen und Vereine. Daten in einem Ordner (z. B. ZFS-Dataset) oder S3-/RustFS-Bucket; mit napp-it oder eigenständig auf Windows, Linux, FreeBSD, macOS und OmniOS/illumos. Drei Fähigkeiten:

– Kollaborationsserver („Nextcloud light“): Kalender (CalDAV), Calc und Text mit Mehrbenutzer-Bearbeitung, Dateien mit Freigaben und WebDAV, Aufgaben, Chat und Nachrichten, KI-Assistent; auch am Handy.

– Zentrales Verzeichnis für Pools und Gruppen: eigene Konten und Gruppen oder Spiegelkonten aus Active Directory/LDAP; LDAPS-Server für die Anmeldung an Windows (pGina), Linux, FreeBSD und macOS; der cs-team-Rechner wird mit denselben Namen, Passwörtern und Gruppen zum SMB-Server.

– Hochverfügbarkeit: Failover Primary → Secondary mit replizierten ZFS-Daten; Konten und Passwörter gehen mit, auf OmniOS/Solaris bleiben auch die SMB-Rechte eindeutig erhalten.

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

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.