SSHFS unter Windows: SSH-Ordner als Laufwerk einbinden

WinFsp und SSHFS-Win: was macht was?

• WinFsp (Windows File System Proxy) ist ein Treiber, mit dem normale Programme Dateisysteme in Windows bereitstellen können – vergleichbar mit FUSE unter Linux. Er sorgt dafür, dass der Server als Laufwerksbuchstabe im Explorer erscheint.
• SSHFS-Win ist die Windows-Portierung des bekannten Linux-Werkzeugs sshfs. Es bringt sshfs.exe samt eigenem SSH-Client mit und verbindet WinFsp mit dem SFTP-Server.
• Eine Oberfläche wie NEO SSH-Win Manager ist optional. Sie speichert Verbindungen, startet sshfs.exe mit passenden Optionen, verbindet abgerissene Laufwerke neu und stellt sie beim Windows-Start wieder her.

1. Voraussetzungen installieren

Installiere zuerst WinFsp und danach SSHFS-Win. Beide gibt es kostenlos als MSI-Installer auf GitHub; für die Installation brauchst du einmalig Administratorrechte. Auf einem 64-Bit-Windows wählst du das x64-Paket von SSHFS-Win. Das spätere Verbinden und Trennen der Laufwerke funktioniert ohne Administratorrechte.

• WinFsp Releases
• SSHFS-Win Releases

2. Verbindung im SSH Manager anlegen

Lege in NEO SSH-Win Manager eine Verbindung an: Host, Port (meist 22), Benutzername und den Remote-Pfad, der zur Laufwerkswurzel werden soll – zum Beispiel /var/www oder auf einem Windows-Server C:\Projekte. Wähle Passwort oder SSH-Schlüssel als Anmeldung und einen Laufwerksbuchstaben, oder lass die App einen freien Buchstaben wählen. Die Zugangsdaten werden mit einem Schlüssel verschlüsselt gespeichert, der aus deinem App-Passwort abgeleitet ist.

3. Mit einem Klick einbinden

Ein Klick auf „Mount“ startet sshfs.exe im Hintergrund, und nach wenigen Sekunden erscheint der Server als Laufwerk im Explorer – nutzbar aus jedem Programm, auch aus Editoren, IDEs und Build-Tools. Mit „Automatisch neu verbinden bei Verbindungsverlust“ kommt das Laufwerk nach Netzwerkunterbrechungen zurück. Mit „Mit Windows starten“ und „Beim Start automatisch verbinden“ sind deine Laufwerke nach der Anmeldung wieder da.

Ohne Zusatz-Tool: Laufwerk per Explorer oder net use verbinden

SSHFS-Win meldet sich in Windows als Netzwerk-Anbieter an. Deshalb kannst du ein Laufwerk direkt im Explorer verbinden (Dieser PC → Netzlaufwerk verbinden) oder in der Eingabeaufforderung mit net use. Beim ersten Mal fragt Windows nach dem Passwort und kann es in der Anmeldeinformationsverwaltung speichern.

net use X: \\sshfs\alice@server.example.com
net use Y: \\sshfs.r\alice@server.example.com!2222\var\www
net use X: /delete

Die allgemeine Form lautet \\sshfs\BENUTZER@HOST[!PORT][\PFAD]. Das Präfix legt fest, wo der Pfad beginnt und wie du dich anmeldest:

Für gelegentlichen Zugriff reicht das. Der Weg hat aber Grenzen: Die Schlüssel-Varianten nutzen nur id_rsa und nur Schlüssel ohne Passphrase (andere Schlüssel brauchen einen Host-Alias in der SSH-Konfiguration), ein automatisches Neuverbinden lässt sich nicht einstellen, und jedes Laufwerk muss pro Benutzer einzeln gepflegt werden.

Für Fortgeschrittene: sshfs.exe direkt starten

Statt über net use kannst du sshfs.exe aus C:\Program Files\SSHFS-Win\bin auch selbst aufrufen. Das ist der Weg, den NEO SSH-Win Manager im Hintergrund geht, weil er volle Kontrolle über Neuverbindung, Caches und Rechte gibt. Starte den Befehl in diesem Ordner, denn sshfs.exe braucht die ssh.exe daneben. Mit -f bleibt der Prozess im Vordergrund, und das Laufwerk existiert, solange er läuft. Das Beispiel ist eine gekürzte Fassung der Optionen, die die App verwendet:

cd "C:\Program Files\SSHFS-Win\bin"
sshfs.exe alice@server.example.com:/var/www X: -p22 -f ^
  -ovolname=web -oreconnect ^
  -oServerAliveInterval=15 -oServerAliveCountMax=3 ^
  -oStrictHostKeyChecking=accept-new ^
  -oUserKnownHostsFile=C:/Users/alice/.ssh/known_hosts ^
  -oidmap=user -ouid=-1 -ogid=-1 -oumask=000 ^
  -oFileInfoTimeout=1000 -oDirInfoTimeout=1000 -odcache_dir_timeout=1 ^
  -oIdentityFile=C:/Users/alice/.ssh/id_ed25519

Häufige Probleme und ihre Lösung

Dateien enthalten nach dem Speichern nur Nullbytes

Das ist der tückischste SSHFS-Fehler. Beim Anlegen oder Überschreiben setzt sshfs die Datei auf dem Server zuerst auf ihre Endgröße – der SFTP-Server füllt diesen Bereich mit Nullen –, während die echten Daten noch in einem Schreib-Cache liegen. Mit -oFileInfoTimeout=-1 hält WinFsp diesen Zwischenstand dauerhaft für gültig und kann beim Zurücklesen die Nullen ausliefern. Wird sshfs.exe beim Trennen zusätzlich hart beendet, gehen noch nicht geschriebene Daten verloren. Lösung: einen endlichen Wert wie -oFileInfoTimeout=1000 verwenden, -osshfs_sync und -ono_readahead für synchrones Schreiben und Lesen ergänzen und Laufwerke immer sauber trennen. NEO SSH-Win Manager nutzt diese sicheren Einstellungen standardmäßig.

Neue Dateien und Ordner erscheinen erst nach rund 20 Sekunden

sshfs führt unterhalb des WinFsp-Caches einen eigenen Verzeichnis-Cache. Dessen Standardwert dcache_dir_timeout beträgt 20 Sekunden, und F5 im Explorer hilft nicht, weil sshfs weiter aus diesem Cache antwortet. Lösung: -odcache_dir_timeout=1 zusammen mit -oDirInfoTimeout=1000, oder den Verzeichnis-Cache mit -odir_cache=no ganz abschalten. In NEO SSH-Win Manager ist das die Einstellung „Verzeichnis-Cache deaktivieren (sofortiger Refresh)“.

Windows-Server: Laufwerke erscheinen als Ordner „C“ und „D“

Auf einem Server mit OpenSSH für Windows listet die SFTP-Wurzel „/“ die Laufwerksbuchstaben auf (/C:, /D:). Weil ein Doppelpunkt in Windows-Dateinamen nicht erlaubt ist, zeigt der Explorer sie als „C“ und „D“. Binde stattdessen einen konkreten Pfad ein – aus C:\Projekte wird /C:/Projekte – oder das Home-Verzeichnis des Benutzers. NEO SSH-Win Manager erkennt Windows-Server und wandelt solche Pfade automatisch um.

„Zugriff verweigert“ beim Speichern

Windows kann die Unix-Besitzer und Rechte-Bits des Servers nicht eins zu eins abbilden. Ohne -oidmap=user und eine passende umask wirken Dateien für Windows-Programme schreibgeschützt oder fremd. Bleibt der Fehler, prüfe die Rechte auf dem Server selbst (ls -l): SSHFS kann nie mehr erlauben, als der SSH-Benutzer darf.

Laufwerk hängt oder bleibt nach einem Abbruch stehen

Ohne Keep-Alive fällt eine abgerissene Verbindung erst nach einem langen TCP-Timeout auf, und der Explorer friert ein. -oServerAliveInterval=15 -oServerAliveCountMax=3 zusammen mit -oreconnect erkennt das nach etwa 45 Sekunden und verbindet neu. Laufwerke, die nach einem Absturz übrig bleiben, entfernst du mit net use X: /delete. NEO SSH-Win Manager räumt solche Geisterlaufwerke automatisch auf.

Host-Key oder SSH-Schlüssel wird abgelehnt

Meldet sshfs „REMOTE HOST IDENTIFICATION HAS CHANGED“, hat sich der Host-Key eines bekannten Servers geändert, etwa nach einer Neuinstallation. Prüfe das beim Server-Betreiber und entferne dann den alten Eintrag aus %USERPROFILE%\.ssh\known_hosts, zum Beispiel mit ssh-keygen -R host. Schlüssel müssen im OpenSSH-Format vorliegen: PuTTY-Schlüssel (.ppk) wandelst du mit PuTTYgen über „Conversions → Export OpenSSH key“ um.

Weitere schnelle Checks

• SSHFS-Win nicht gefunden → Installation prüfen und neu starten.
• Auth fehlgeschlagen → Passwort/Key/Zertifikat kontrollieren.
• Laufwerkskonflikt → freien Buchstaben wählen oder automatisch zuweisen lassen.

Wann ist SSHFS die richtige Wahl?

SSHFS ist ideal, wenn du mit Windows-Programmen an Server-Dateien arbeiten willst, als lägen sie lokal: Code in der IDE bearbeiten, Webprojekte pflegen, Logs und Konfigurationen öffnen. Für das Verschieben großer Datenmengen ist eine direkte SFTP-Übertragung oder rsync schneller, denn über SSHFS ist jeder Dateizugriff ein Netzwerk-Roundtrip. Im Firmennetz ist SMB oft flotter, braucht aber einen offenen Freigabe-Port – SSHFS kommt mit SSH aus.

SSHFS vs. SFTP vs. SMB im Vergleich

Häufige Fragen