macOS SSHFS 向け macFUSE GUI ロゴ
macFUSEGui

サポートガイド

macFUSEGui トラブルシューティング

マウントがつながらない、スリープ後にリモートが stale になる、macOS がアプリをブロックするといった場合は、このページで前提条件、認証、マウント状態、回復処理のどこが崩れているかを絞り込みます。

1. 前提条件の失敗

何もマウントできない場合は、まず macFUSE と sshfs が両方入っているかを確認してください。実際のファイルシステムと転送はこの 2 つに依存します。

brew install --cask macFUSE
brew install gromgit/fuse/sshfs-mac

2. 初回起動の承認問題

未署名ビルドは一度だけ承認が必要です。アプリが一瞬で消える、または起動できない場合は Finder から右クリックで開いてください。

その後、「システム設定 > プライバシーとセキュリティ」に承認導線が出ていないか確認します。

3. 認証とホスト情報の問題

  • ホスト名、ユーザー名、リモートパスが正しいか確認する。
  • 保存済みリモートを信用しすぎず、アプリから資格情報を再テストする。
  • 貼り付けたパスワードが怪しい場合は一度きれいに保存し直す。

4. マウントポイントの衝突

SSH 接続が成功しても、ローカルマウントポイントが別のリモートと衝突したり stale path を指したりすると失敗します。各リモートに固有のローカルパスを使ってください。

5. スリープ、復帰、ネットワーク回復の問題

macFUSEGui は必要なリモートをスリープ、復帰、ネットワーク回復後に戻す設計です。stale のままなら、一度切断してからネットワークが本当に戻っているか確認し、再接続します。

繰り返す場合は診断をコピーし、回復のどの段階が失敗したかを確認してください。

6. stale mount / broken mount

Finder にリモートが見えていてもパスが応答しない場合は stale mount として扱います。まずアプリから切断し、stale mount が残ったまま設定を消さないでください。

7. 推測の前に診断を見る

診断スナップショットは推測を減らすためにあります。繰り返し失敗する場合は、環境、状態、直近の回復イベントを一度に確認できる形でコピーしてください。

関連ガイド