Häufige Fragen (FAQ)

Häufige Fragen (FAQ)

Was ist Synology Manager Plus und wofür brauche ich es?

Es ist ein Claude-Code-Plugin, mit dem du ein Synology-NAS — oder mehrere — über SSH verwaltest. Statt dich durch DSM zu klicken, nutzt du klare Befehle für Einrichtung, Health-Diagnose, SMART-Festplatten, Speicher, Logs, DSM-Updates und Docker-Compose, alles aus einer Claude-Code-Session.

Was kostet Synology Manager Plus?

Nichts. Es ist Open Source unter der MIT-Lizenz und vollständig kostenlos. Es läuft lokal in deinem Claude Code — es gibt keinen Cloud-Dienst und keine Abo-Gebühren.

Brauche ich die DSM-Web-API oder ein zusätzliches Paket auf dem NAS?

Nein. Synology Manager Plus arbeitet ausschließlich über SSH und nutzt Standard-Werkzeuge, die DSM mitbringt. Du musst lediglich den SSH-Dienst in DSM aktivieren (Systemsteuerung → Terminal & SNMP).

Die erste Verbindung schlägt fehl — woran liegt das?

Meist an einem von drei Punkten: SSH ist in DSM nicht aktiviert, der Port stimmt nicht, oder der Benutzer hat keinen Shell-Zugang. Den Host-Schlüssel bestätigst du einmalig beim interaktiven ! ssh-copy-id-Schritt (Fingerprint prüfen, dann akzeptieren). Danach prüfst du alles mit /diag.

Warum brauchen manche Befehle passwortloses sudo — und wie richte ich es ein?

/smart-status, /health-summary, /dsm-update-check und alle Docker-Befehle brauchen erhöhte Rechte. DSM hat kein visudo, daher legst du eine Drop-in-Datei an: echo '<user> ALL=(ALL) NOPASSWD: /usr/bin/smartctl, /usr/syno/sbin/synoupgrade, /usr/local/bin/docker' | sudo tee /etc/sudoers.d/synology-manager-plus und anschließend sudo chmod 0440 /etc/sudoers.d/synology-manager-plus.

Ein Docker-Befehl meldet „command not found" — warum?

DSM installiert Docker unter /usr/local/bin/docker, das bei nicht-interaktiven SSH-Sitzungen nicht im PATH liegt. Synology Manager Plus ruft Docker deshalb immer über diesen absoluten Pfad auf — du musst nichts tun, der absolute Pfad ist im Plugin fest verdrahtet.

/smart-status zeigt keine oder unerwartete Werte — was tun?

Probiere einen anderen Device-Type. Trage smartctl_device_type: sat (oder ata, nvme, scsi) im Profil context/nas/<slug>/profile.md ein — Standard ist ata. Verifiziert ist das Plugin gegen smartctl 6.5 auf DSM 7.3.1.

Wie schütze ich kritische Compose-Stacks vor versehentlichem Stoppen?

Trage die Projektnamen im Profil unter critical_compose_projects ein. /compose-down verweigert dann das Stoppen dieser Stacks, solange nicht die Umgebungsvariable SM_CONFIRM_CRITICAL=yes gesetzt ist.

Kann ich mehrere NAS verwalten?

Ja. Mit /nas-add nimmst du weitere NAS auf, /nas-list zeigt alle, /nas-use <slug> wechselt die aktive. /health-summary --all, /smart-status --all und /nas-status --all gehen sequenziell durch die ganze Flotte und liefern ein Verdict über den schlechtesten Einzelwert.

Landen meine NAS-Daten (Hosts, Benutzer, Schlüssel) in Git?

Nein. Die echten Profile, die aktive NAS und alle Snapshots unter context/nas/ sind git-ignoriert; im Repository liegt nur ein leeres Verzeichnis mit .gitkeep. Deine Topologie verlässt deinen Rechner nicht, und dein Inventar übersteht ein claude plugin update.

Installiert das Plugin DSM-Updates automatisch?

Nein. /dsm-update-check ist strikt read-only und meldet nur den Status. Die Installation eines DSM-Updates gehört bewusst in die DSM-Weboberfläche mit ihren Sicherheitsabfragen.

Wie wechsle ich die aktive NAS oder tausche den SSH-Schlüssel?

Die aktive NAS setzt du mit /nas-use <slug>. Zum Rotieren des Schlüssels löschst du ~/.ssh/synology-manager-plus_<slug>_ed25519 (samt .pub) und führst /setup-ssh bzw. /nas-add erneut aus — die Befehle erzeugen bei Bedarf einen neuen Schlüssel.

Worin unterscheidet sich Synology Manager Plus von Fleet Manager?

Synology Manager Plus ist auf Synology-NAS spezialisiert (DSM, RAID, SMART, Volumes). Fleet Manager ist das generische Pendant für beliebige Linux-Hosts. Beide lassen sich parallel nutzen.

Ist das ein offizielles Synology-Produkt?

Nein. Synology Manager Plus ist ein Community-Plugin und ein Fork von danielrosehill/synology-manager-plugin (Credit: Daniel Rosehill), unter MIT-Lizenz. Es steht in keiner Verbindung zur Synology Inc.