Docs

Troubleshooting

Die häufigsten Fehlermeldungen mit ihrer Ursache und Lösung.

„sshfs.exe nicht gefunden”

SSHFS-Win ist nicht installiert oder liegt an einem unüblichen Pfad. Lösung: Installer von winfsp/sshfs-win laufen lassen. Die App sucht in:

  • C:\Program Files\SSHFS-Win\bin\sshfs.exe
  • C:\Program Files (x86)\SSHFS-Win\bin\sshfs.exe

Auch PATH wird durchsucht.

„mount point in use”

Der gewählte Laufwerksbuchstabe ist noch von einem alten Mount belegt. Schritte:

  1. Anderen Buchstaben wählen, oder
  2. Settings → Stale Mounts bereinigen ausführen, oder
  3. Im Explorer das alte Laufwerk trennen, oder
  4. Als letzter Ausweg: Windows neu starten.

„Authentifizierung fehlgeschlagen”

  • Passwort prüfen — Edit → Passwort neu setzen.
  • Bei Key-Auth: Pfad zum privaten Schlüssel korrekt? Hat die Datei keine Passphrase?
  • Auf dem Server: ~/.ssh/authorized_keys enthält den Public-Key?
  • Server-Config: PasswordAuthentication bzw. PubkeyAuthentication in sshd_config aktiv?

„Verbindung abgelehnt”

SSH-Daemon läuft nicht oder Firewall blockt. Test:

ssh -p <port> <user>@<host>

Aus PowerShell. Wenn das auch fehlschlägt, ist es kein App-Problem.

Laufwerk taucht im Explorer auf, aber „Zugriff verweigert”

WinFsp-Berechtigungsproblem. Die App setzt bereits:

-oidmap=user -ouid=-1 -ogid=-1
-oumask=000 -ocreate_umask=000
-odefault_permissions

Falls das Problem trotzdem auftritt: SSHFS-Win neu installieren und prüfen, ob der WinFsp-Dienst läuft (services.msc).

App startet nicht oder bringt nichts in den Vordergrund

Single-Instance-Lock per Windows-Mutex aktiv. Eine zweite Instanz beendet sich sofort und versucht, das vorhandene Fenster zu fokussieren. Falls das Fenster nicht erscheint:

  • Tray prüfen — App ist evtl. minimiert.
  • Im Taskmanager nach NeoSSHWinManager.exe suchen und beenden.

Logs einsehen

Settings → Debug-Modus aktivieren. Logs landen in %APPDATA%\SSHWinManager\app.log. Bei Mount-Problemen ist der vollständige sshfs.exe-stderr enthalten.