Symlinks funktionieren nicht bei SFTP-Mount — NetDrive

Ein Deploy-Verzeichnis auf Ihrem SFTP-Server hält einen current-Symlink, der auf den jeweils aktiven Release-Ordner zeigt — current → releases/20260821-1. Das ist ein Standardmuster für Zero-Downtime-Deploys, und genau die Art von Sache, die still und leise bricht, sobald NetDrive auf diesen Server zeigt. Der Link erscheint als leere Datei, als defekte Verknüpfung oder taucht gar nicht erst auf, und ein Skript, das erwartet, dass S:\current\config.yaml einfach funktioniert, tut das plötzlich nicht mehr.

SFTP-Server mit funktionierender Symlink-Unterstützung einbinden

Mit NetDrive erscheinen Google Drive, OneDrive, S3, SFTP, WebDAV und mehr als native Laufwerke unter Windows und macOS — ohne Synchronisation, ohne vollständige Downloads.

• Symlinks lösen sich auf SFTP-Mounts korrekt auf, ab Version 3.17.817
• Passwort- oder SSH-Schlüssel-Authentifizierung
• Verfügbar für Windows, macOS und den experimentellen Linux-Build

WindowsmacOS

NetDrive herunterladen →

Kostenlose Testversion. Lifetime- und Abo-Pläne verfügbar.

Zuerst die Version prüfen

NetDrive hat Symlink-Unterstützung für SFTP-Verbindungen in Version 3.17.817 (07.01.2023) eingeführt. In jedem älteren Build hat ein Symlink auf dem Server keine Entsprechung auf der gemounteten Seite — er erscheint möglicherweise gar nicht oder als Null-Byte-Datei statt auf sein Ziel zu verweisen. Das ist die häufigste Ursache für „meine Symlinks funktionieren nicht”-Meldungen und sollte vor allem anderen auf dem Server ausgeschlossen werden.

Um die installierte Version zu prüfen, öffnen Sie den NetDrive Drive Manager, klicken Sie auf das NetDrive-Symbol (Systray unter Windows, Menüleiste unter macOS) und öffnen Sie About NetDrive. Steht dort eine Versionsnummer älter als 3.17.817, aktualisieren Sie zunächst — die aktuelle Version ist 3.19.7, verfügbar unter netdrive.net/download.

Bereits auf 3.17.817 oder neuer? Prüfen Sie den Link selbst

Liegt es nicht an der Version, liegt es meist an der Konfiguration des Symlinks selbst. Gehen Sie Folgendes von der Serverseite aus durch, über eine reguläre SSH-Sitzung:

• Absolute vs. relative Ziele. Ein relativer Symlink (current → releases/20260821-1) löst sich relativ zu seinem eigenen Verzeichnis auf und übersteht einen Mount in der Regel gut. Ein absoluter Symlink (current → /var/www/app/releases/20260821-1) löst sich nur korrekt auf, wenn genau dieser absolute Pfad auch existiert und aus Sicht des SFTP-Kontos auf das Dateisystem erreichbar ist — was nicht garantiert ist, wenn das Konto in ein Unterverzeichnis chroot-beschränkt ist.

  # Run this on the server to see how the link is defined
  ls -la /var/www/app/current

• Ein Ziel außerhalb des Root-Verzeichnisses des SFTP-Kontos. Manche Server beschränken SFTP-Nutzer auf ein Chroot-Jail, das im Home-Verzeichnis oder einem bestimmten Pfad verwurzelt ist. Ein Symlink, der auf etwas außerhalb dieses Roots zeigt, ist für die SFTP-Sitzung — und damit für NetDrive — unsichtbar, unabhängig von der NetDrive-Version. Bestätigen Sie, dass der Zielpfad innerhalb desselben Roots liegt, auf den das SFTP-Konto beschränkt ist.

• Ein Ziel, das ins Leere zeigt. Wurde der Release-Ordner, auf den ein Symlink zeigt, gelöscht oder umbenannt (ein halbfertiges Deploy, ein zu früh gelaufenes Cleanup-Skript), ist der Link selbst intakt, hat aber nichts, worauf er sich auflösen könnte. ls -la auf dem Server zeigt den Link je nach Shell-Konfiguration in einer anderen Farbe oder markiert ihn als defekt.

• Berechtigungen am Ziel, nicht nur am Link. Die Symlink-Datei selbst kann lesbar sein, während das Zielverzeichnis Berechtigungen hat, die das SFTP-Konto blockieren. Prüfen Sie beides.

Die Korrektur über den Mount bestätigen

Sobald Sie Version und Link-Konfiguration ausgeschlossen haben und bestätigt ist, dass der Link relativ, innerhalb des Roots und auf etwas Existierendes gerichtet ist, verbinden Sie das Laufwerk in NetDrive neu (Rechtsklick auf die Verbindung im Drive Manager und Reconnect wählen, oder trennen und neu verbinden) und prüfen Sie den gemounteten Pfad direkt:

# Windows PowerShell — replace S: with your assigned drive letter
dir S:\current

# macOS / Linux Terminal
ls -la /Volumes/sftp-mount/current

Listet der Inhalt des Zielordners nun korrekt auf, löst sich der Symlink auf. Erscheint er nach Prüfung von Version und Link-Gültigkeit weiterhin leer oder fehlend, liegt die verbleibende Variable meist an der serverseitigen SFTP-Subsystem-Konfiguration — konkret daran, ob der sftp-server-Prozess des Servers die Symlink-Traversierung deaktiviert hat, was eine Frage für den Serveradministrator ist, keine NetDrive-Einstellung.

Fazit

Symlink-Handling auf einem SFTP-Mount hängt von zwei unabhängigen Dingen ab: ob Ihr NetDrive-Build es überhaupt unterstützt (3.17.817+) und ob der Link selbst aus Sicht des SFTP-Kontos gültig ist. Prüfen Sie zuerst die Version — das ist die schnellere Lösung — und arbeiten Sie sich dann durch das Ziel des Links, bevor Sie NetDrive dafür verantwortlich machen. Zu allgemeineren SFTP-Verbindungsproblemen siehe Fix SFTP Authentication Failures in NetDrive, und für die Ersteinrichtung Mount an SFTP Server on Windows.

— Morgan, NetDrive