CLI-Tool
vdsm/virtual-dsm avatar
vdsm/virtual-dsm

Virtual DSM in einem Docker-Container

vdsm/virtual-dsm bietet eine praxistaugliche Open-Source-Implementierung mit stabiler Einsatzbarkeit für reale Anwendungsfälle.

3.981 Sterne487 ForksShellMIT
GitHub

Auf einen Blick

Was ist das?
Ein Docker-Image, das Virtual DSM ausführt, mit KVM-Beschleunigung, konfigurierbarem Speicher und mehreren Netzwerkoptionen.
Für wen ist es gedacht?
Die README schließt mit der Wiederholung, dass der Container nur auf Synology-Hardware ausgeführt werden sollte und das Projekt nicht mit Synology verbunden ist. Die MIT-Lizenz besagt, dass die Software ohne Gewährleistung bereitgestellt wird.
Darf ich es kommerziell nutzen?
Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
Wird es noch gepflegt?
Ja. Die letzten Commits kamen vor 13 Tagen.
In welcher Sprache ist es geschrieben?
Hauptsächlich Shell, laut der Sprachstatistik von GitHub.

Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 14. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.

TIEFGEHENDE OPEN-SOURCE-ANALYSE

Virtual DSM in einem Docker-Container

Das Projekt beschreibt sich selbst als Virtual DSM in einem Docker-Container. Es ist in Shell geschrieben und unter der MIT-Lizenz veröffentlicht. Die README besagt, dass der Container Virtual DSM ausführt, Installationsdateien automatisch herunterlädt und Web-basierten Zugriff auf den DSM-Desktop bietet. Sie listet außerdem nahezu native Leistung mit KVM-Beschleunigung sowie anpassbare CPU-, Speicher- und Speicherzuweisung als Funktionen auf.

Anforderungen und unterstützte Hosts

Die README spezifiziert Docker oder Podman auf einem Linux-Host mit KVM-Unterstützung oder Docker Desktop oder Podman Desktop auf Windows 11 mit aktivierter verschachtelter Virtualisierung. Es sind mindestens 2 GB RAM und 32 GB freier Speicherplatz erforderlich. Docker Desktop auf Linux, macOS und Windows 10 wird nicht unterstützt, da es keinen KVM-Zugriff für Container bietet. Die README gibt nicht an, welche KVM-Funktionen oder CPU-Modelle über das Vorhandensein von /dev/kvm hinaus erforderlich sind.

Starten mit Docker Compose, CLI oder Kubernetes

Die README enthält ein Docker-Compose-Beispiel mit dem Image vdsm/virtual-dsm. Das Beispiel setzt DISK_SIZE auf 256G, übergibt /dev/kvm und /dev/net/tun an den Container, fügt NET_ADMIN hinzu, mappt Port 5000 und mountet ./dsm auf /storage. Außerdem wird ein docker run-Befehl mit denselben Optionen sowie eine kubectl apply-URL für ein Kubernetes-Manifest gezeigt. Es gibt keine Anleitung zum Erstellen des Images aus dem Quellcode.

Speicher-, Festplatten-, CPU- und GPU-Einstellungen

Das FAQ erklärt, wie Sie den Speicherort ändern, indem Sie den Bind-Mount in der Compose-Datei ersetzen. Die Festplattengröße wird mit DISK_SIZE gesteuert, und zusätzliche Festplatten können mit DISK2_SIZE, DISK3_SIZE und entsprechenden Volumes hinzugefügt werden. Physische Festplatten oder Partitionen können über devices-Einträge durchgereicht werden. CPU und RAM werden mit CPU_CORES und RAM_SIZE eingestellt, standardmäßig mit 2 Kernen und 2 GB. GPU-Durchreichung verwendet GPU: "Y" und /dev/dri; die README sagt, dass dies die Gesichtserkennung in Synology Photos aktiviert, aber keine Hardware-Transkodierung für Videos bietet.

Netzwerkmodi und IP-Zuweisung

Standardmäßig verwendet der Container Bridge-Netzwerke und teilt die IP-Adresse mit dem Host. Um eine individuelle Adresse zu vergeben, zeigt die README das Erstellen eines macvlan-Netzwerks mit docker network create und das Anschließen des Containers. Die README weist darauf hin, dass der Container wegen des macvlan-Designs nicht vom Docker-Host erreichbar ist, und schlägt ein zweites macvlan als Workaround vor. Sie beschreibt auch einen DHCP-Modus durch Setzen von DHCP: "Y", Hinzufügen von /dev/vhost-net und einer device_cgroup_rule, damit DSM eine IP vom Router anfordern kann.

Versionsauswahl und KVM-Überprüfung

Die Standardinstallation ist DSM Version 7.2. Eine ältere Version kann installiert werden, indem URL auf einen .pat-Datei-Download gesetzt wird oder indem eine lokale .pat-Datei an /boot.pat gebunden wird, was URL überschreibt. Die README sagt, dass ein Wechsel zwischen Versionen bei Beibehaltung der Dateidaten möglich ist. Zur KVM-Überprüfung empfiehlt sie die Installation von cpu-checker und die Ausführung von kvm-ok sowie die Prüfung, ob /dev/kvm existiert. Wenn kvm-ok erfolgreich ist, der Container aber weiterhin KVM als nicht verfügbar meldet, empfiehlt sie, vorübergehend privileged: true zu setzen, um Berechtigungs- oder Gerätezugriffsprobleme auszuschließen.

Unterschiede zum Standard-DSM und rechtliche Bedingungen

Die README nennt zwei Unterschiede zum Standard-DSM: Virtual Machine Manager ist nicht verfügbar und Surveillance Station enthält keine kostenlosen Lizenzen. Zur Rechtsfrage sagt sie, dass das Projekt nur Open-Source-Code enthält und kein Synology-Material verbreitet oder Urheberrechtsschutz umgeht. Allerdings erfordert die Installation von Virtual DSM die Zustimmung zum Synology-EULA, das die Installation auf Nicht-Synology-Hardware nicht erlaubt. Daher empfiehlt die README, den Container nur auf offiziellen Synology-NAS-Geräten auszuführen. Die MIT-Lizenz gewährt das Recht, die Software zu verwenden, zu kopieren, zu modifizieren, zu fusionieren, zu veröffentlichen, zu verteilen, zu unterlizenzieren und zu verkaufen, bietet jedoch keine Garantie und lehnt Haftung ab.

Projektbezogener Prüfpunkt

Ein konkreter Starttest für Virtual DSM: Die Compose-Datei mit vdsm/virtual-dsm, DISK_SIZE 256G, /dev/kvm, /dev/net/tun, NET_ADMIN, Port 5000:5000 und ./dsm:/storage bildet den dokumentierten Einstieg. Danach ist http://127.0.0.1:5000/ aufzurufen. kvm-ok und die Existenz von /dev/kvm prüfen die Hostvoraussetzung. Bei macvlan ist zu beachten, dass der Docker-Host die Container-IP nicht direkt erreicht.

Redaktionelles Fazit

Die README schließt mit der Wiederholung, dass der Container nur auf Synology-Hardware ausgeführt werden sollte und das Projekt nicht mit Synology verbunden ist. Die MIT-Lizenz besagt, dass die Software ohne Gewährleistung bereitgestellt wird.

Offizielle Quellen

  1. Official README
  2. Project repository
  3. Release notes
Community-Notizen

Community-Notizen