Synology iSCSI einrichten: LUN und Target erstellen und unter Linux einbinden

Kein Kommentar Autor: Jürgen (jdo)

Mit iSCSI wird Speicher auf Deinem Synology-NAS zu einer Festplatte, die Linux wie ein lokales Laufwerk behandelt. Auf dem NAS legst Du im SAN Manager eine LUN und ein Target an. Unter Linux verbindest Du Dich mit open-iscsi und iscsiadm, danach formatierst und mountest Du die Platte wie jede andere.

Die Technologie ist nicht mehr neu. Banal gesagt bekommst Du eine weitere Festplatte, die allerdings im Netzwerk vorgehalten wird. SCSI-Befehle werden einfach in IP-Pakete gepackt. Das NAS sieht dabei keine Dateien, sondern nur Blöcke. Dateisystem und Ordner verwaltet allein Dein Linux-Rechner.

Daraus folgt die wichtigste Regel: Eine LUN gehört immer nur einem Linux-Rechner. Synology sieht für Linux-Hosts keinen gleichzeitigen Zugriff auf dieselbe LUN vor, sonst drohen beschädigte Daten. Sollen mehrere Geräte an dieselben Daten, nimm eine Freigabe per SMB, NFS oder WebDAV. Für Filme und Musik im Heimnetz passt der Medienserver auf dem Synology besser.

Synology iSCSI einrichten: LUN und Target im SAN Manager

Seit DSM 7 heißt die zuständige App SAN Manager, in DSM 6.2 war es der iSCSI Manager. Vorher brauchst Du ein Volume im Speicher-Manager. So legst Du Target und LUN in einem Durchgang an:

Öffne den SAN Manager, wechsle zu iSCSI und klicke auf Erstellen.
Gib dem Target einen Namen. Für die IQN macht DSM einen Vorschlag, den Du übernehmen kannst.
Aktiviere die CHAP-Authentifizierung und vergib Benutzername und Passwort. Gegenseitigen CHAP brauchst Du im Heimnetz meist nicht.
Wähle bei der LUN-Zuordnung Neue LUN erstellen.
Lege Name, Speicherort (Volume), Kapazität (mindestens 1 GB) und die Speicherzuweisung fest. Zum Schluss bestätigst Du mit Übernehmen.

Thick Provisioning reserviert den Platz sofort und bietet laut Synology bessere Stabilität und Leistung. Thin Provisioning belegt Platz erst bei Bedarf und unterstützt auf Btrfs-Volumes (je nach Modell) Schnappschüsse. Läuft das Volume voll, kann allerdings das Dateisystem auf der LUN abstürzen.

iSCSI-LUN-Assistent: Name, Ort und Größe — LUN-Eigenschaften im damaligen Speicher-Manager, Aufnahme von 2014. Der SAN Manager fragt dieselben Werte ab.

iSCSI-LUN-Assistent: Name und IQN des Targets — Target mit IQN und CHAP, Aufnahme von 2014

iSCSI-LUN-Assistent: fertig — Zusammenfassung vor dem Übernehmen, Aufnahme von 2014

Steht die Berechtigung der LUN auf Alle zulassen, darf jeder Initiator im Netz lesen und schreiben. Sicherer ist ein eigener Eintrag unter Host: Dort trägst Du die IQN Deines Linux-Rechners ein und gibst ihm Lesen/Schreiben. Die Option Mehrere Sitzungen am Target lässt Du aus. Wer sie nutzt, braucht laut Synology ein Cluster-Dateisystem wie VMFS oder OCFS.

Unter Linux: open-iscsi installieren

Der Linux-Teil gilt nicht nur für das Synology. Er funktioniert mit jedem NAS oder Gerät, das iSCSI zur Verfügung stellt. Unter Debian, Ubuntu und Linux Mint heißt das Paket open-iscsi:

sudo apt install open-iscsi

Fedora nennt es iscsi-initiator-utils (sudo dnf install iscsi-initiator-utils), Arch Linux wieder open-iscsi. Bei der Installation entsteht die IQN Deines Rechners. Diese trägst Du im SAN Manager unter Host ein:

sudo cat /etc/iscsi/initiatorname.iscsi

Target finden und anmelden

Dann gehen wir mal auf Entdeckungsreise. Führe auf der Kommandozeile nachfolgenden Befehl aus und tausche die IP-Adresse einfach gegen die Deines NAS / Synology:

sudo iscsiadm -m discovery -t sendtargets -p 192.168.100.5

Da kommt dann etwas in der Art raus: 192.168.100.5:3260,0 iqn.2000-01.com.synology:cartman.name. Die Erkennung läuft beim Synology ohne CHAP, die Zugangsdaten gelten erst für die Anmeldung. Klappt die Erkennung trotzdem nicht, legst Du den Eintrag mit -o new, IQN und IP direkt an.

Jetzt hinterlegst Du die CHAP-Daten für dieses Target:

T=iqn.2000-01.com.synology:cartman.name
P=192.168.100.5
sudo iscsiadm -m node -T $T -p $P -o update -n node.session.auth.authmethod -v CHAP
sudo iscsiadm -m node -T $T -p $P -o update -n node.session.auth.username -v linuxpc
sudo iscsiadm -m node -T $T -p $P -o update -n node.session.auth.password -v DeinPasswort

Gut, dann meldest Du Dich an und machst die Verbindung dauerhaft:

sudo iscsiadm -m node -T $T -p $P --login
sudo iscsiadm -m node -T $T -p $P -o update -n node.startup -v automatic
sudo systemctl enable iscsid open-iscsi

Unter Fedora und RHEL heißen die Dienste iscsid und iscsi. Alternativ trägst Du Startverhalten und CHAP global in /etc/iscsi/iscsid.conf ein: node.startup = automatic, node.session.auth.authmethod = CHAP sowie Benutzername und Passwort. Diese Werte gelten aber nur für Targets, die Du danach neu entdeckst.

LUN partitionieren, formatieren und einbinden

Welches Gerät die LUN geworden ist, zeigt lsblk (alternativ dmesg oder sudo iscsiadm -m session -P 3). Du erkennst sie an Größe und Hersteller SYNOLOGY:

lsblk -o NAME,SIZE,VENDOR,MODEL

Im Beispiel ist es wenig spannend sdb. Prüfe den Namen genau, ein falsches Gerät löscht Deine Daten. Danach legst Du eine Partition an, formatierst sie und hängst sie ein:

sudo cfdisk /dev/sdb
sudo mkfs.ext4 /dev/sdb1
sudo mkdir -p /mnt/iscsi
sudo mount /dev/sdb1 /mnt/iscsi

iSCSI: Mittels cfdisk eine Partition erstellen, Aufnahme von 2014

iSCSI: Partition formatiert und gemountet, Aufnahme von 2014

Nach dem Neustart automatisch einbinden

Wer sich nun wundert, was denn nach einem Neustart passiert: Mit node.startup = automatic meldet sich Linux wieder an und die Platte taucht erneut auf. Voraussetzung ist natürlich, dass das NAS / Synology über das Netzwerk erreichbar ist. Der Gerätename kann sich dabei ändern, in /etc/fstab nutzt Du deshalb die UUID aus sudo blkid /dev/sdb1:

UUID=Deine-UUID  /mnt/iscsi  ext4  _netdev,nofail  0  0

_netdev ist hier Pflicht. Erst damit behandelt systemd das iSCSI-Laufwerk als Netzwerk-Mount und wartet aufs Netz. nofail sorgt dafür, dass Dein Rechner auch dann startet, wenn das NAS aus ist.

iSCSI nach Neustart von Kubuntu — dmesg nach dem Neustart: Die LUN meldet sich als SYNOLOGY iSCSI Storage, Aufnahme von 2014

Bei Thin Provisioning unterstützt die LUN laut Synology die Speicherplatzrückgewinnung. Zeigt lsblk --discard /dev/sdb bei DISC-GRAN und DISC-MAX andere Werte als 0B, gibt sudo fstrim -v /mnt/iscsi gelöschte Blöcke ans NAS zurück. Automatisch geht das per fstrim.timer.

Verbindung trennen

Erst aushängen, dann abmelden. Der letzte Befehl löscht den Eintrag, sonst verbindet sich Linux beim nächsten Start wieder. Die Zeile in /etc/fstab entfernst Du ebenfalls.

T=iqn.2000-01.com.synology:cartman.name
P=192.168.100.5
sudo umount /mnt/iscsi
sudo iscsiadm -m node -T $T -p $P --logout
sudo iscsiadm -m node -T $T -p $P -o delete

Löschst Du die LUN im SAN Manager, sind alle Daten darauf weg. Eine LUN ist auch kein Backup. Für die Sicherung eines Linux-Rechners aufs NAS eignet sich rsync über SSH ohne Passwort-Eingabe.

Rückblick: der erste Test 2014

Der erste Test lief im Januar 2014 auf einer Synology DS212j unter Kubuntu 13.10. Damals lag iSCSI noch im Speicher-Manager. Weil die Festplatten schon als RAID mit mehreren geteilten Ordnern liefen, blieb nur eine LUN aus regulären Dateien, also eine Art Container auf dem Volume. Das war in der Regel langsamer, zum Testen aber egal. Es reichte ein GByte mit einfacher CHAP-Anmeldung im hauseigenen Netz.

Aktualisiert am 12.10.2026 von Henry. Fakten geprüft.