Zum Hauptinhalt springen

Netzlaufwerke

Netzlaufwerke hängen Freigaben anderer Server – per SMB (cifs) oder NFS – unter /mnt/remotes/<name> ein. Sie lassen sich in Apps nutzen und unter Freigaben erneut freigeben: per SMB jedes Netzlaufwerk, per NFS nur NFS-Netzlaufwerke ohne automatisches Einhängen.

Netzlaufwerk anlegen​

Netzlaufwerke → Neues Netzlaufwerk:

FeldSMBNFS
NameKleinbuchstaben, Ziffern, -, _; ergibt /mnt/remotes/<name>ebenso
ServerHostname oder IPv4-AdresseHostname, IPv4- oder IPv6-Adresse
Freigabe / ExportFreigabename, z. B. backup oder home$ (ohne Leerzeichen)Exportpfad, z. B. /volume1/archive
AnmeldungBenutzername, Passwort, optional Domäne; leer = Gastzugriff– (der Server entscheidet anhand der Adresse)
Version3.1.1, 3.0, 2.1, 2.0, 1.0 oder automatisch4.2, 4.1, 4, 3 oder automatisch
Besitzeruid/gid: lokaler Besitzer aller Dateien–

Optionen:

  • Nur lesen: wird ro eingehängt.
  • Beim ersten Zugriff einhängen (Automount): Eine .automount-Unit hängt das Laufwerk erst beim ersten Zugriff ein. Ein nicht erreichbarer Server verzögert so den Systemstart nicht. Empfohlen und voreingestellt.
  • Beim Systemstart einhängen: Die Unit wird für remote-fs.target aktiviert.

Nach dem Anlegen wird das Laufwerk sofort eingehängt. Schlägt das fehl, bleibt es angelegt und zeigt den Fehler aus dem Journal.

Zugangsdaten​

Das SMB-Passwort steht nur in /appdata/bunkerbox/data/credentials/<name> (Verzeichnis 700, Datei 600, nur root) und wird nie wieder angezeigt oder über die API ausgegeben. Beim Bearbeiten bleibt es erhalten, solange Benutzername und Domäne gleich bleiben; sonst muss es neu eingegeben werden. Ohne Benutzernamen wird als Gast eingehängt und die Datei gelöscht.

systemd-Units​

Pro Netzlaufwerk schreibt Bunkerbox nach /etc/systemd/system/:

  • mnt-remotes-<name>.mount (What=, Where=, Type=cifs|nfs, Options=, TimeoutSec=30)
  • bei Automount zusätzlich mnt-remotes-<name>.automount

Bindestriche im Namen werden wie bei systemd-escape --path als \x2d geschrieben (old-nas → mnt-remotes-old\x2dnas.mount). Optionen:

  • immer: nosuid und nodev, damit setuid-Programme und Gerätedateien eines fremden Servers auf diesem Rechner (und in Containern, die den Pfad einbinden) nicht wirksam werden
  • SMB: credentials=… bzw. guest, vers=, uid=/gid= mit forceuid/forcegid und file_mode=0664,dir_mode=0775, iocharset=utf8, noserverino, _netdev, nofail
  • NFS: vers=, hard,timeo=600,retrans=2, _netdev, nofail

Beim Start des Dienstes werden die Units aus data/remote-mounts.json neu geschrieben. Alle Werte werden vorher streng geprüft (keine Zeilenumbrüche, %-Platzhalter, Kommas oder Leerzeichen in Server und Freigabe), damit keine zusätzlichen Optionen oder Abschnitte in eine Unit gelangen.

Zustände​

ZustandBedeutung
Eingehängtin /proc/mounts als cifs bzw. nfs eingetragen
Wird bei Zugriff eingehängtAutomount aktiv, noch nicht eingehängt
Nicht eingehängtUnits gestoppt
FehlgeschlagenUnit fehlgeschlagen; die letzten Journal-Zeilen werden angezeigt

Einhängen startet Automount und Mount, Aushängen stoppt beide. Schlägt das Aushängen fehl (Dateien noch geöffnet), bleibt das Laufwerk eingehängt.

Erneut freigeben​

Eingehängte Netzlaufwerke erscheinen beim Anlegen einer Freigabe als Ort. Bunkerbox prüft den Zustand des Netzlaufwerks statt auf das Verzeichnis zuzugreifen, damit ein hängender Server weder ein Automount auslöst noch die Oberfläche blockiert. POSIX-ACLs gibt es auf Netzlaufwerken nicht; setze uid/gid auf den Besitzer, unter dem die Dateien lokal erscheinen sollen. Per NFS lassen sich nur NFS-Netzlaufwerke ohne Automount weitergeben; ihre Exporte erhalten automatisch eine feste fsid. SMB-Netzlaufwerke (cifs) und Automount-Einhängepunkte kann der Linux-NFS-Server nicht exportieren, sie lassen sich nur per SMB freigeben.

Löschen​

Ein Netzlaufwerk, das noch freigegeben ist, lässt sich nicht löschen – zuerst die Freigaben löschen. Beim Löschen (Bestätigung mit dem Namen) wird ausgehängt, die Units und die Zugangsdaten werden entfernt und das leere Verzeichnis /mnt/remotes/<name> gelöscht. Daten auf dem entfernten Server bleiben unberührt.

Mock-Modus​

Im Mock-Modus gibt es die per SMB eingehängte diskstation (//diskstation.fritz.box/archiv, nur lesen) und das NFS-Archiv nfs-archive mit Automount. Server, deren Name offline enthält, lassen sich nicht einhängen, um Fehler auszuprobieren.