Startseite
» Gewusst wie
»
Wie man ein entferntes SSHFS-Verzeichnis beim Systemstart in Debian automatisch einbindet
Wie man ein entferntes SSHFS-Verzeichnis beim Systemstart in Debian automatisch einbindet
Um ein entferntes SSHFS-Verzeichnis in Debian automatisch einzubinden, konfigurieren Sie die nicht-interaktive SSH-Authentifizierung und fügen Sie einen SSHFS-Eintrag hinzu /etc/fstab. Mit systemd können Sie entweder beim Systemstart eine Verbindung herstellen oder die automatische Einbindung beim Systemstart aktivieren und die Verbindung herstellen, sobald auf das Verzeichnis zugegriffen wird. Die zweite Methode ist hilfreich, wenn der entfernte Server oder das Netzwerk während des Systemstarts möglicherweise nicht verfügbar ist.
Diese Referenz basiert auf der Dokumentation zu Debian 13 „trixie“ vom 9. Oktober 2026, einschließlich der Dokumentation zu SSHFS 3.7.3 und systemd 257. Die Befehle sind Konfigurationsbeispiele und stammen nicht aus einer getesteten Installation. Konsultieren Sie die Handbücher Ihrer Installation, falls Sie eine andere Version verwenden.
Wählen Sie aus, wann die SSHFS-Verbindung gestartet werden soll.
Anforderung
Konfigurationsauswahl
Erwartetes Verhalten
Das Verzeichnis soll nach dem Systemstart bei Bedarf verfügbar sein.
Verwendenx-systemd.automount
Der erste Zugriff löst die Fernmontage aus.
Versuchen Sie, die Remote-Verbindung während des Systemstarts herzustellen.
Auslassenx-systemd.automount
systemd startet die Einbindung als Teil des Systemstarts.
Der Startvorgang kann fortgesetzt werden, wenn kein Speicherplatz verfügbar ist.
Verwendennofail
Die Einbindung ist keine notwendige Boot-Abhängigkeit.
Eine Anwendung muss auf diesen Speicher warten.
Fügen Sie dem Dienst dieser Anwendung eine Abhängigkeit hinzu.
Die Anwendung startet erst nach erfolgreicher Einbindung.
Das Hauptbeispiel verwendet eine bedarfsgesteuerte Einbindung. Die Unterscheidung ist wichtig: Eine aktive automatische Einbindung bedeutet nicht, dass bereits eine SSHFS-Verbindung besteht. Die Beziehung zwischen der automatischen Einbindung und der zugehörigen Einbindungseinheit wird im Handbuch zu systemd automount von Debian erläutert.
Bevor Sie beginnen
Der Debian-Client verwendet systemd und Sie haben sudo-Zugriff.
Das Remote-Konto unterstützt SFTP und kann auf das gewünschte Verzeichnis zugreifen.
Der Client kann den Remote-Host erreichen, einschließlich aller erforderlichen VPN- oder Jump-Hosts.
Sie haben die Möglichkeit, den SSH-Host-Key-Fingerabdruck des Remote-Servers zu überprüfen.
Der lokale Mountpunkt ist leer und kein kritisches Systemverzeichnis.
Ersetzen Sie files@storage.example.net:/srv/data<Hostname> durch Ihren Remote-Benutzernamen, Hostnamen und Ihr Verzeichnis. Der Hostname ist ein Platzhalter. Der lokale Mountpunkt ist <Local Mountpoint> /mnt/remote; der zugehörige Schlüssel ist <Key> /root/.ssh/sshfs_boot.
Dies ist eine vom Administrator verwaltete Systemeinbindung. Sie läuft lokal als Root, meldet sich aber auf dem Remote-Server als normaler Benutzer an files, nicht als Remote-Root. Die SSHFS-Projektdokumentation empfiehlt generell, normale interaktive Einbindungen als normaler Benutzer auszuführen. Eine Systemeinbindung beim Systemstart erfordert eine sorgfältige Verwaltung von Anmeldeinformationen und Zugriffsrechten.
Installieren Sie SSHFS auf dem Debian-Client. Das Remote-System benötigt einen funktionierenden SFTP-Dienst; eine separate SSHFS-Installation ist für die reine Dateibereitstellung nicht erforderlich. Falls die Paketinstallation fehlschlägt, beheben Sie das Repository- oder Verbindungsproblem, bevor Sie die Boot-Konfiguration bearbeiten.
Installieren Sie den SSHFS-Client und die OpenSSH-Tools unter Debian.
2. Montagepunkt und zugehörigen Schlüssel vorbereiten
Überschreiben Sie keinen vorhandenen Schlüssel unter diesem Pfad. Wählen Sie gegebenenfalls einen anderen Namen und verwenden Sie diesen im Folgenden einheitlich. Die leere Passphrase ist in diesem Beispiel für die unbeaufsichtigte Entsperrung beabsichtigt: Während des Systemstarts ist niemand verfügbar, der den Schlüssel entsperren kann. Schützen Sie den Client und erteilen Sie dem Remote-Konto nur die benötigten Verzeichnisberechtigungen. Falls Ihre Richtlinie verschlüsselte Schlüssel erfordert, richten Sie stattdessen einen verwalteten, unbeaufsichtigten Entsperrmechanismus ein.
Die Optionen zur Schlüsselerzeugung sind im Debian- Handbuch zu ssh-keygen dokumentiert . Ein im Desktop-SSH-Agent freigeschalteter Schlüssel steht dem System-Mount nicht automatisch zur Verfügung.
Bereiten Sie die lokalen Verzeichnisse vor, bevor Sie den dedizierten Boot-Key erstellen.
3. Schlüssel autorisieren und unbeaufsichtigtes SFTP verifizieren.
Vergleichen Sie während dieser Verbindungsherstellung den angezeigten Host-Key-Fingerabdruck mit einem Wert, den Sie vom Serveradministrator über einen vertrauenswürdigen Kanal erhalten haben, bevor Sie die Verbindung akzeptieren. Der Befehl wird als lokaler Root-Benutzer ausgeführt, daher wird der Host-Key-Eintrag üblicherweise in den SSH-Dateien des Root-Benutzers gespeichert. Falls die passwortbasierte Einrichtung auf dem Server deaktiviert ist, lassen Sie den Administrator stattdessen den öffentlichen Schlüssel installieren.
Testen Sie anschließend SFTP mit derselben Identitäts- und Host-Schlüsseldatei, die auch für die Boot-Einbindung verwendet wird:
Geben Sie an der SFTP-Eingabeaufforderung `sft` und ls /srv/dataanschließend `sft` ein bye. Dies muss ohne Passwortabfrage oder Bestätigungsaufforderung funktionieren. `sft` verhindert die interaktive Authentifizierung; die explizite Host-Key-Einstellung gewährleistet die Authentifizierung. Diese Optionen sind im OpenSSH-Client-KonfigurationshandbuchBatchMode=yes definiert .
Verwenden Sie für einen nicht standardmäßigen Port die Optionen -p 2222`ssh-copy-id`, -P 2222`sftp` und ` port=2222SSHFS`. Falls ein Jump-Host erforderlich ist, konfigurieren und testen Sie diese Route auch im SSH-Kontext von root.
Autorisieren Sie den zugehörigen öffentlichen Schlüssel für das Beispiel-Remote-Konto; überprüfen Sie den Host-Fingerabdruck während der Einrichtung.
4. Überprüfen Sie, ob die manuelle Montage funktioniert.
Prüfen Sie, ob sich das Verzeichnis im gewünschten Remote-Verzeichnis befindet. In diesem Beispiel ist der Zugriff zunächst nur dem lokalen Mount-Besitzer (root) gestattet. Verwenden Sie daher für die Prüfung sudo. Hängen Sie das Verzeichnis anschließend aus, bevor Sie die systemd-verwaltete Konfiguration starten. Schließen Sie alle Shells und Anwendungen, die das Verzeichnis verwenden, falls es belegt ist.
SSHFS verwendet die Berechtigungen des Remote-Kontos. Root-Rechte auf dem Client gewähren keine zusätzlichen Berechtigungen auf dem Server. Beheben Sie Authentifizierungs-, SFTP- oder Remote-Pfadfehler hier, bevor Sie die Konfiguration speichern.
Das Terminal zeigt ein Beispiel für die manuelle Einbindung; verwenden Sie den vollständigen Befehl und die Überprüfungsoptionen im Text.
5. Fügen Sie den persistenten fstab-Eintrag hinzu.
sudo cp -a /etc/fstab /etc/fstab.sshfs-backup
sudoedit /etc/fstab
Wählen Sie einen anderen Sicherungsdateinamen, falls die Sicherung bereits existiert. Fügen Sie Folgendes als eine einzige Zeile hinzu und ersetzen Sie dabei den Beispielserver und -pfad:
Das SSHFS-Handbuch von Debian gibt sshfsden Dateisystemtyp für fstab an und akzeptiert ihn fuse.sshfsaus Kompatibilitätsgründen. Die letzten Felder deaktivieren die Planung von Dump und Dateisystemprüfung für diesen Eintrag. Konsultieren Sie die fstab-Formatreferenz, falls Pfade Leerzeichen enthalten.
Option
Zweck
_netdev
Klassifiziert die Halterung als netzwerkabhängig.
nofail
Der Bootvorgang kann ohne diese Einbindung fortgesetzt werden.
x-systemd.automount
Erstellt eine zugriffsgesteuerte automatische Einbindung.
x-systemd.mount-timeout=30s
Begrenzt die Wartezeit des ersten Mount-Befehls.
ConnectTimeout=10
Bounds SSH-Verbindungsaufbau.
reconnectund Server-Alive-Einstellungen
Hilft dabei, eine unterbrochene Verbindung zu erkennen und wiederherzustellen.
Die systemd-spezifischen Optionen sind im Debian-Systemd-Mount-Handbuch dokumentiert . Das Mount-Timeout setzt keine Frist für jede nachfolgende Dateioperation.
Sichern Sie die fstab-Datei, bevor Sie den persistenten SSHFS-Eintrag hinzufügen.
6. Laden Sie systemd neu und aktivieren Sie die automatische Einbindung.
sudo findmnt --verify --verbose
sudo systemctl daemon-reload
sudo systemctl start mnt-remote.automount
systemctl status mnt-remote.automount
sudo ls /mnt/remote
findmnt -t fuse.sshfs
Prüfen Sie die Bestätigungsmeldungen, bevor Sie fortfahren. Das Handbuch von findmnt beschreibt die Überprüfung der fstab-Datei; dabei wird die Konfiguration geprüft, nicht die Funktion der Remote-Anmeldeinformationen. Der Zugriff auf das Verzeichnis führt einen separaten Verbindungstest durch.
Die oben genannten Einheitennamen entsprechen /mnt/remote. Für einen anderen Pfad leiten Sie den Mount-Namen mit ab systemd-escape --path --suffix=mount /your/path. Aus fstab generierte Einheiten benötigen keinen separaten systemctl enableBefehl.
Soll beim Systemstart ein Verbindungsversuch erfolgen, entfernen Sie x-systemd.automountden entsprechenden Eintrag. Nachdem die Benutzer des Verzeichnisses freigegeben wurden, stoppen Sie dessen automatische Einbindung und die Mount-Einheiten, laden Sie systemd neu und starten Sie die zugehörige Mount-Einheit. Behalten Sie den Eintrag bei, nofailwenn der Speicher optional bleiben soll.
systemd neu laden und die generierte Automount-Unit starten.
7. Überprüfen Sie das Verhalten nach einem Neustart.
Starten Sie das System zu einem geeigneten Wartungszeitpunkt neu. Überprüfen Sie bei der On-Demand-Konfiguration zuerst die automatische Einbindung und greifen Sie dann auf das Verzeichnis zu:
systemctl status mnt-remote.automount
sudo ls /mnt/remote
systemctl status mnt-remote.mount
findmnt -t fuse.sshfs
Erwartete Anzeichen sind ein aktives automatisches Mounten nach dem Systemstart und ein tatsächliches SSHFS-Mounten nach dem Zugriff. Ein autofsEintrag allein beweist nicht, dass entfernte Dateien verbunden sind. Überprüfen Sie eine bekannte entfernte Datei oder ein Verzeichnis, nicht nur, ob der lokale Mountpunktordner existiert.
Falls eine Anwendung diesen Speicher vor dem Start benötigt, fügen Sie ihrem Dienst ein Drop-in hinzu, das Folgendes enthält:
[Unit]
RequiresMountsFor=/mnt/remote
Diese in systemd.unit dokumentierte Abhängigkeit lädt und ordnet die notwendigen Mounts. Laden Sie systemd neu und testen Sie den Start der Anwendung separat. Die Anwendung benötigt außerdem die entsprechenden lokalen Zugriffsrechte.
Greifen Sie auf das Verzeichnis zu und überprüfen Sie dann die tatsächliche SSHFS-Einbindung und deren Gerätestatus.
Wiederholen Sie den SFTP-Test im Root-Kontext; überprüfen Sie den ausgewählten Schlüssel und die Remote-Autorisierung.
Host-Key-Überprüfung schlägt fehl
Überprüfen Sie den Server-Fingerabdruck und den Eintrag „known_hosts“ des Root-Verzeichnisses. Untersuchen Sie einen geänderten Schlüssel, bevor Sie ihn aktualisieren.
Namensauflösung oder Verbindungsfehler
Prüfen Sie DNS, Routing, Portzugriff, VPN-Start und die Verfügbarkeit des Jump-Hosts.
sudo kann Dateien lesen, ein lokaler Benutzer jedoch nicht.
Überprüfen Sie die FUSE-Zugriffsrichtlinien und die Zuordnung der Besitzverhältnisse.
Mount ist beschäftigt
Prozesse schließen, deren Arbeitsverzeichnis oder geöffnete Dateien sich unter dem Mountpunkt befinden.
network-online.targetEs handelt sich um einen Startsynchronisierungspunkt, nicht um eine Garantie für die Erreichbarkeit eines bestimmten Servers oder VPNs. Die Erklärung zu systemd network-online beschreibt diese Einschränkung.
Für den gezielten Zugriff durch einen lokalen Benutzer sollten Sie allow_other,default_permissions,uid=1000,gid=1000die lokalen IDs durch die entsprechenden lokalen IDs ersetzen. Dadurch wird der Zugriff über den Mount-Inhaber hinaus ermöglicht, während die Kernel-Berechtigungsprüfungen weiterhin gelten. Die UID/GID-Optionen ändern die angezeigte, nicht die serverseitige Eigentümerschaft. Root-Mounts benötigen keine entsprechende Einstellung user_allow_otherin der fuse.conf; diese Richtlinie ermöglicht es Nicht-Root-Mounts, einen umfassenderen Zugriff anzufordern. Weitere Informationen finden Sie im FUSE-Berechtigungshandbuch . Testen Sie die Anwendung nach der Änderung dieser Optionen erneut als der vorgesehene Benutzer.
Nachdem das zugrundeliegende Problem behoben wurde, löschen Sie den fehlgeschlagenen Mount-Status und versuchen Sie den Zugriff erneut:
sudo systemctl reset-failed mnt-remote.mount
sudo ls /mnt/remote
Die Wiederherstellung nach dem erneuten Verbinden ist nicht für jede Anwendung transparent: Zuvor geöffnete Dateien können beschädigt werden und müssen möglicherweise erneut geöffnet werden. Unterbrochene Schreibvorgänge können zu Datenverlust führen. Wählen Sie ein anderes Speicherdesign, wenn Ihre Arbeitslast höhere Ausfallsicherheit erfordert.
Lesen Sie zuerst das Montageprotokoll; löschen Sie einen Fehlerzustand, nachdem Sie dessen Ursache behoben haben.
Betriebscheckliste und Rollback
Unattended SFTP funktioniert mit der exakten Boot-Identität.
Der Host-Schlüssel wird überprüft und in der erwarteten Datei gespeichert.
Der fstab-Eintrag wird analysiert und enthält keine Passwörter oder Inhalte privater Schlüssel.
Der Zugriff nach einem Neustart führt zum gewünschten Remote-Aufruf.
Der jeweilige lokale Benutzer oder Dienst kann die benötigten Dateien lesen.
Sie verstehen, wie die Anwendung mit nicht verfügbarem Speicherplatz umgeht.
Um die Konfiguration zu deaktivieren, beenden Sie die Anwendungen, die das Verzeichnis verwenden, mnt-remote.automountund mnt-remote.mountentfernen Sie anschließend nur diesen Eintrag aus der fstab sudo systemctl daemon-reload. Führen Sie dann den Befehl aus. Die übrigen fstab-Einträge bleiben erhalten. Durch das Entfernen der Mount-Konfiguration werden keine Remote-Dateien gelöscht und der autorisierte Remote-Schlüssel nicht widerrufen.