Verwaltungsapp für Ugreen Nas-Systeme

Ugreen NAS Admin — Version 23.8.41

Desktop-Tool für Ugreen-NAS (und kompatible Geräte) per SSH: Dashboard, Skripte, Explorer, Docker, Health, Backup, NAS-Verwaltung, Login Track, Einstellungen u. v. m. — in vielen Sprachen.

Download

GitHub Releases (empfohlen):

Release Ugreen NAS Admin 23.8.41 · runlevel1977-del/UgreenNASAdmin

Highlights Auto-update: Like Pro — when a newer release is on GitHub, the app offers to download UgreenNASAdmin_setup_*.exe and run it automatically (ℹ Info →…

github.com

Alternativ „Latest“:

Release Ugreen NAS Admin 23.8.41 · runlevel1977-del/UgreenNASAdmin

Highlights Auto-update: Like Pro — when a newer release is on GitHub, the app offers to download UgreenNASAdmin_setup_*.exe and run it automatically (ℹ Info →…

github.com

Wichtig: Den grünen GitHub-Button „Code → Download ZIP“ nicht für die App nutzen — das ist nur Quellcode vom main-Branch, ohne fertige Release-EXE.

Das Wichtigste in v23.8.41: Auto-Update

Ab dieser Version musst du keine neue EXE mehr manuell suchen und herunterladen (sofern du eine Installation oder einen aktuellen Build nutzt):

1. Die App prüft beim Start (nach ein paar Sekunden) automatisch, ob auf GitHub eine neuere Version liegt.
2. Es erscheint ein Dialog: „Jetzt updaten“ oder „Später“ (pro Version max. einmal alle 24 h Erinnerung).
3. Bei „Jetzt updaten“ lädt die App die UgreenNASAdmin_setup_<Version>.exe von GitHub herunter und startet den Installer.
4. Die App beendet sich danach — du folgst dem Setup wie gewohnt.

Manuell prüfen: Header ℹ Info → Button „Nach Updates suchen“.

Download-Ort der Setup-Datei:

• Wenn in Settings → Pfade → Screenshot-Zielordner etwas eingetragen ist → dorthin
• sonst in den App-Datenordner (siehe unten)

Hinweis: Das Update läuft über den Windows-Installer — das ist die zuverlässigste Methode. Wer nur die portable ZIP ohne Installation nutzt, kann weiterhin „Später“ wählen und die ZIP manuell ersetzen.

(Öffentliches GitHub-Repo — kein Token nötig, anders als bei Ugreen NAS Admin Pro.)

Build-Änderung: One-Dir statt One-File (seit v23.8.39)

Die EXE liegt jetzt in einem Ordner, nicht mehr als einzelne Datei:

UgreenNASAdmin\

UgreenNASAdmin.exe

_internal\ ← DLLs, Python-Laufzeit, Bibliotheken

Vorteil: Kein temporärer _MEI*-Ordner mehr, python312.dll-Fehler beim Start sind damit behoben, stabilerer Start unter Windows.

Portable starten: Immer UgreenNASAdmin\UgreenNASAdmin.exe — nicht nur eine lose EXE in dist\.

Einstellungen & Verbindung: automatische Migration (v23.8.40 + 41)

Wenn nach dem Umstieg Verbindung oder Einstellungen weg waren: Ab v23.8.40 übernimmt die App beim ersten Start automatisch vorhandene Dateien aus:

• dem alten dist\-Ordner (Layout der früheren Einzel-EXE), oder
• %LOCALAPPDATA%\UgreenNASAdmin\ (typisch nach Installation unter Programme)

Relevante Dateien u. a.:
nas_admin_connection.json, app_settings.json, telegram_notify.json, …

Nach Installation unter „Programme“: Config liegt meist in
C:\Users\<Name>\AppData\Local\UgreenNASAdmin\
— nicht zwingend neben der EXE unter Program Files.

Weitere Änderungen der letzten Releases (Kurzüberblick)

v23.8.38 — Webcam / RTSP

• RTSP-Passwörter mit Sonderzeichen (!, ?, @, …) werden korrekt encodiert — ffmpeg/ffprobe laufen damit zuverlässiger.
• UGOS-Kamera-Scan: Fallback auf cameramgr/devices, wenn die Standard-API leer ist; Tapo/ONVIF aus verschachtelter Liste.

v23.8.39 — Hotfix

• App startete nicht mehr wegen eines defekten Buttons „Verbindung testen“ (Methode existierte nicht) — entfernt.

v23.8.37 — u. a.

• Ausführliche „Get Pro“-Anleitung in der Sidebar (Spende → Pro per E-Mail → Freischaltung).
• Webcam Recorder: USB, UGOS Surveillance API, manuelle RTSP-URLs.

Installation — zwei Wege

A) Installer (empfohlen)

1. UgreenNASAdmin_setup_23.8.41.exe herunterladen
2. Ausführen (ggf. SmartScreen: „Weitere Informationen“ → „Trotzdem ausführen“)
3. Sprache wählen, Zielordner bestätigen, optional Desktop-Verknüpfung
4. App starten, in Settings NAS-Verbindung eintragen und speichern

B) Portable (ZIP)

1. UgreenNASAdmin_v23.8.41_release.zip entpacken
2. Im Ordner source\dist\UgreenNASAdmin\ liegt die fertige App
3. UgreenNASAdmin.exe starten — gesamten Ordner UgreenNASAdmin\ mitnehmen (inkl. _internal\)
4. Alte .json-Configs ggf. in diesen Ordner legen oder von LocalAppData migrieren lassen (siehe oben)

Update von älteren Versionen

Bekannte Hinweise

• Windows SmartScreen / Defender: Die EXE ist nicht code-signiert — Warnungen sind üblich, keine Schadsoftware. Bei häufigem Test ggf. Ausnahme für den dist- bzw. Installationsordner.
• Erster Start nach One-Dir-Wechsel kann etwas länger dauern (viele DLLs in _internal\, ggf. Antivirus-Scan).
• Dokumentation: In der App unter ℹ Info → Handbuch / README / CHANGELOG; ausführlich auch auf GitHub im Repo.

Links

• Release v23.8.41: https://github.com/runlevel1977-d…es/tag/v23.8.41
• Alle Releases: https://github.com/runlevel1977-del/UgreenNASAdmin/releases
• SourceForge-Spiegel (falls verlinkt): https://sourceforge.net/projects/ugreennasadmin/

Feedback & Fehlermeldungen gern per E-Mail (Adresse in der App unter ℹ Info) — am hilfreichsten mit Log-Auszug aus der App und/oder Screenshot.

Kleiner Bug Behoben.

Lüfter — UGOS-Rückgabe: Beim „UGOS-Steuerung zurückgeben“ werden Kurven-Artefakte auf dem NAS jetzt vollständig entfernt — per Glob ugreen_fan_curve.state* (nicht nur die aktuell konfigurierten Fan-IDs). set -e im Rückgabe-Skript entfernt, damit ein Zwischenschritt das Löschen nicht abbricht.

v23.8.33. Schwerpunkt dieses Updates ist die Lüftersteuerung im Dashboard: statt fester „System / CPU“-Kacheln erkennt die App jetzt alle Lüfter, die euer NAS meldet, und steuert jeden einzeln — inklusive optionaler Temperaturkurven pro Lüfter.

Lüfterkurve (temperaturgesteuert) — pro Lüfter

Über „Lüfterkurve …“ auf der jeweiligen Kachel:

• Stützpunkte: Temperatur (°C) → Lüfterleistung (PWM %)
• Temperaturquelle: CPU (höchster Sensor) oder Platte (SMART-Temperatur des gewählten /dev/sdX)
• Live-Vorschau: ca. alle 3 Sekunden per SSH — aktuelle Temperatur, RPM und berechnetes Kurven-Ziel-%
• Nach „Speichern & auf NAS aktivieren“ legt die App auf dem NAS an:
  • Skript /volume1/scripts/ugreen_fan_curve_apply.sh
  • Konfiguration ugreen_fan_curve.env
  • Cron (jede Minute + nach Neustart mit kurzer Verzögerung)

Mehrere Lüfter = mehrere Kurven möglich. Jeder Lüfter hat seine eigene Kurve in den Einstellungen. Wenn ihr bei einem Lüfter festes Manuell-% mit Übernehmen setzt, wird nur dessen Kurve deaktiviert — die anderen laufen weiter.

Boot nach Neustart: Festes Manuell-% kann optional über ugreen_fan_boot.env nach Neustart wiederhergestellt werden (alle Kacheln im Profil). Lüfterkurven und festes Boot-PWM schließen sich gegenseitig aus — was zuletzt aktiv gesetzt wurde, gilt.

Kurzüberblick

Mit v23.8.32 liegt der Schwerpunkt auf zwei großen Themen:

1. UGOS Web-API tiefer in die App integriert — Speicher, Pools, Disks, Netzwerk und Health-Daten wie in der UGOS-Oberfläche, nicht nur per SSH-Parsing.
2. NAS-Verwaltung deutlich erweitert — geplanter Ein-/Ausschalt-Rhythmus wie in UGOS, HDD-Ruhezustand, Service-Log-Picker (.slog), Netzwerk-Übersicht (Lesen), plus ein überarbeitetes 50:50-Layout.

Zusätzlich: Der SSH-Verbindungsstatus im Header wird nach dem Start automatisch geprüft und zeigt grün, sobald das NAS erreichbar ist — nicht erst nach dem ersten manuellen Klick irgendwo in der App.

Die Version enthält weiterhin alle Features aus den vorherigen Releases (u. a. Runlevel Apps, Login Track, Migrations-Assistent, Handbuch-Button in der Kopfzeile, UGOS-API-Basis aus v23.8.3+).

UGOS API — erweiterte Auswertung (Dashboard, Speicher, Health)

Die App kann seit längerem die offizielle UGOS-Web-API ansprechen (Settings → Verbindung: HTTPS-Port, Zugangsdaten, SSL; Paket cryptography für den Login). In 23.8.32 wird daraus deutlich mehr in der Oberfläche sichtbar:

Dashboard — Kachel „Speicher (UGOS API)“

Neue Kachel im Dashboard mit derselben Perspektive wie die UGOS-Web-UI:

• Modell, UGOS-Version, Laufzeit, optional Seriennummer
• Pools (links) und physische Disks (rechts) mit Belegung, RAID-Typ, Sync-/Rebuild-Hinweisen
• Zusatzzeile: Lüfter-RPM (API), Netzwerk-Interfaces mit Link-Geschwindigkeit (z. B. 1000 Mbit/s), Volume-Belegung in Prozent

Wenn die API nicht erreichbar ist, laufen die SSH-Live-Daten (CPU, RAM, Netzwerk-Sparklines usw.) weiter; in der Kachel erscheint ein klarer Hinweis.

Speicher-Tab — „Pools (UGOS API)“

Neuer Button „Pools (UGOS API)“ (auch in „Alles aktualisieren“ eingebunden):

• Pools mit RAID-Level, Belegung, Sync-Status, Pool-100 %-Hinweis
• Volumes pro Pool
• Physische Disks mit Slot, Modell, Temperatur, SMART-Kurzstatus

Die klassischen SSH-Buttons (Volumes/df, Shares) funktionieren unabhängig weiter.

Health-Tab — UGOS-API-Liveblock

Beim Health-Refresh erscheint (sofern API konfiguriert) ein Block „UGOS API (live)“ mit Sysinfo, Lüfter, NIC-Geschwindigkeiten und Volume-Nutzung — ergänzend zu den SSH-basierten Checks (RAID, SMART, systemd failed …).

domain_tool-Warnung

Schlägt domain_tool.service fehl, erscheint eine explizite Warnung im Health-Log (SMB/Domain-Konfiguration). Im Report folgen Error Signatures zu domain_tool / smbftpd aus Journal und Log-Tails — hilfreich bei SMB-/Domain-Problemen.

Technischer Hintergrund (kurz)

Der Parser wertet u. a. Sysinfo, Fan, Netzwerk, Volumes und Pool-Mitglieder aus; Chart-overview-Keys werden ignoriert, damit keine falschen 0 %- oder „?“-Anzeigen mehr entstehen. Link-Geschwindigkeiten kommen u. a. aus network/iface/list.

NAS-Verwaltung — neue Blöcke und Layout

UGOS Power-Scheduler (Wochenplan)

Analog zur UGOS-GUI: geplantes Ausschalten und Wieder-Einschalten (rtcwake) pro Wochentag.

• Zeiten im Format HH:MM (24 h), mehrere Zeiten pro Tag durch Komma trennbar
• Laden, Vorschau (ohne Schreiben), Anwenden (power.conf + OffSched / OnSched)
• Neu generieren, wenn GUI und Datei auseinanderlaufen
• Erfordert „Volle Rechte“ und sudo — echtes Herunterfahren, Wartungsfenster beachten

Abgrenzung: Der bestehende Block „Geplanter täglicher Shutdown“ (Cron unter /etc/cron.d/…) nutzt eine andere Mechanik. Beides kann parallel existieren — vor Änderungen prüfen, was auf eurem NAS aktiv ist.

HDD-Ruhezustand

In der Energie-Gruppe: Kombobox internal_disk_sleep (Minuten bis Spin-down interner Platten, 0 = aus). Wird mit Lesen/Speichern der Energie-Einstellungen aus /etc/power.conf übernommen.

UGOS-Service-Logs (.slog)

• Liste laden aus /var/ugreen/log/*.slog
• Tail anzeigen der gewählten Datei im Protokoll (nur Lesen)

Viele UGOS-Dienste schreiben parallel zu journalctl in diese Dateien — oft schneller als nur Journal durchsuchen.

Netzwerk (UGOS, nur Lesen)

Zusammenfassung laden: Lesesicht auf LAN1/LAN2 — UGOS-JSON unter /etc/network/ugos.d/ plus ip link / ip addr (Link-Geschwindigkeit, verbunden/getrennt).

Keine Schreibaktion — IP-Profile oder Routing werden hier nicht geändert. Für Laufzeit-ip-Änderungen: Dashboard-Netzwerk-Kachel; dauerhafte UGOS-Konfiguration bleibt in der NAS-Oberfläche.

Layout 50:50

Der Tab NAS-Verwaltung startet jetzt mit gleicher Breite für Bedienbereich links und SSH-Protokoll rechts (50:50). Der Splitter bleibt ziehbar; lange Buttonbeschriftungen werden nicht mehr abgeschnitten (mehrzeilige Button-Zeilen, dynamische Hinweise).

Weitere NAS-Verwaltung (unverändert nutzbar)

Energie/WoL, Cron-Shutdown, USB-Auswurf, SMART, RAID/TRIM/Scrub, SSH-Drop-in mit Rollback, UGOS-*_serv-Dienste (inkl. Status anzeigen, Support-Snapshot), NGINX, earlyOOM, Samba, LED & Summer.

Header — SSH-Status automatisch grün

Bisher stand „Nicht verbunden“ (rot) oft bis zum ersten SSH-Befehl irgendwo in der App.

Neu: Kurz nach dem Start (und nach Laden/Wechsel/Speichern der Verbindung) läuft ein Hintergrund-SSH-Kurztest. Ist das NAS mit den gespeicherten Zugangsdaten (inkl. Keyring/SSH-Key) erreichbar, springt die Anzeige automatisch auf grün — „SSH verbunden“.

Handbuch & Dokumentation

• Deutsch: HANDBUCH.md / PDF HANDBUCH.pdf
• Englisch: HANDBOOK_EN.md / PDF HANDBOOK_EN.pdf
• Aktualisiert: Kapitel 15 (NAS-Verwaltung), 6 (Dashboard UGOS-Kachel), 13 (Health), 16 (Speicher)
• Handbuch-Button in der Kopfzeile springt weiterhin zum passenden Kapitel des aktiven Tabs (PDF-Seitensprung via handbook_page_index.json)

In der App: Info → Handbuch/PDF, oder 📖 Handbuch in der Kopfzeile.

Ugreen NAS Admin — Changelog v23.8.6 (Deutsch)

Version: 23.8.6 · Datum: 19.05.2026
Download: GitHub Releases v23.8.6

Das Release-Paket enthält:

• UgreenNASAdmin_setup_23.8.6.exe — Windows-Setup
• UgreenNASAdmin_v23.8.6_release.zip — Quellen + portable EXE + Installer

Handbuch direkt aus der App

• Neuer Button 📖 Handbuch in der Kopfzeile (zwischen Info und Screenshot).
• Öffnet automatisch das passende Handbuch-Kapitel zum gerade aktiven Tab.
• PDF-Seitenjump zur richtigen Seite (SumatraPDF, Edge, Adobe Reader).
• Fallback: Dialog mit Markdown-Auszug, plus Buttons für PDF (Seite) und gesamtes PDF.
• Keine Überlappung mehr mit Tab-Buttons (Webcam, UGOS API usw.).
• Beim PDF-Build wird handbook_page_index.json erzeugt (DE/EN) und ist in der EXE enthalten.

Login Track (neuer Tab 🔐)

• Zugriffe nach Client-IP aus mehreren Quellen per SSH: SSH, UGOS (App/Web), SMB, aktive Verbindungen (ss), optional last.
• Spalten: Zeit | IP | Quelle | Ergebnis | Benutzer | Detail
• Echtzeit-Modus (Standard): Polling ca. alle 4 s, Baseline + Delta, nur solange der Tab aktiv ist.
• Historie-Modus: ca. 30 Tage Journal + Log-Tails.
• Sortierung, Export als Textdatei, IP sperren über UGOS-Liste /ugreen/.config/block_ip_list.
• UI in 11 Sprachen · Handbuch §14

UGOS API (Dashboard)

• Button „UGOS API“ im Dashboard.
• Live-Snapshot über die offizielle UGOS-Web-API — CPU, RAM, Pools, Disks ohne SSH-Parsing.
• Port/HTTPS unter Einstellungen → Verbindung · RSA-Login benötigt cryptography.

Docker

• 15 Compose-Rezepte „Fehlt im App Center“ mit UGREEN-Pfaden /volume1/docker/…:
  MeTube, Jellyfin, Immich, Paperless-ngx, Vaultwarden, Nextcloud, AdGuard Home, Sonarr, Radarr, Prowlarr, qBittorrent, Uptime Kuma, Home Assistant, Syncthing, Portainer
• Homelab-Stapel: Monitoring (Uptime Kuma + Dozzle + Homepage), Media (MeTube + qBittorrent)
• Compose von GitHub laden im Docker-Assistenten
• Presets: MeTube, Scrutiny, Dozzle

Migrations-Assistent

Erreichbar im Backup-Tab und NAS↔NAS:

• rsync-Skripte für Volume-Umzug, NAS→NAS (Push/Pull), Synology/QNAP-Vorlage
• Dry-Run, Speichern unter /volume1/scripts/, optional Ausführung per SSH
• Vorab-Prüfung: Pfade, Speicher, Remote-SSH
• Rsync und Speichern im Hintergrund, Exit-Code-Auswertung

SSH & Performance

• Konfigurierbare Timeouts (Einstellungen → Verbindung: Standard/Lang)
• run_ssh_cmd_ex mit Exit-Codes — Timeout-Meldung statt UI-Freeze
• Storage Top-20: du-Scan im Hintergrund, Tab bleibt bedienbar
• SSH-Key-Hinweis nach Installation (Persistenz in UGOS_scripts)

Handbuch & Dokumentation (DE/EN + PDF)

• §14 Login Track · §77 Docker-Rezepte · §78 Migration · §79 SSH-Timeouts · §80 Storage Top-20 · §23.3.1 Settings · §23.4.5 SSH/UGOS · §48.1 Docker

Release & Installation

UgreenNASAdmin_v23.8.6_release/

├── source/ ← Quellen + dist/UgreenNASAdmin.exe (portable)

├── installer/ ← UgreenNASAdmin_setup_23.8.6.exe

└── LIESMICH_RELEASE.txt

Konfiguration bei Update: Alte JSONs manuell nach %LOCALAPPDATA%\UgreenNASAdmin\ kopieren (App vorher beenden):
nas_admin_connection.json, app_settings.json, telegram_notify.json, qnap_smb_prefs.json

Selbstbau: pip install -r requirements.txt → pip install paramiko cryptography → python builder.py