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.

Host gilt als „gemountet”, obwohl der Laufwerksbuchstabe zu etwas anderem gehört

Ist beim Start bereits ein Laufwerk vorhanden (z. B. E:) und in NeoSSHWinManager ein Host auf genau diesen Laufwerksbuchstaben konfiguriert, hält die App den Host für gemountet — obwohl E: in Wirklichkeit zu etwas anderem gehört (USB-Stick, lokale Partition, ein anderes Netzlaufwerk). Weil der Host als „gemountet” gilt, lässt er sich nicht normal bearbeiten. So änderst du den Laufwerksbuchstaben trotzdem:

  1. Settings → Debug-Modus aktivieren.
  2. Der Host lässt sich im Debug-Modus dennoch bearbeiten (Edit).
  3. Im Bearbeiten-Dialog einen freien Laufwerksbuchstaben wählen und speichern.

Danach kann der Debug-Modus wieder deaktiviert werden.

„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.