サポートガイド
macFUSEGui トラブルシューティング
マウントがつながらない、スリープ後にリモートが stale になる、macOS がアプリをブロックするといった場合は、このページで前提条件、認証、マウント状態、回復処理のどこが崩れているかを絞り込みます。
1. 前提条件の失敗
何もマウントできない場合は、まず macFUSE と sshfs が両方入っているかを確認してください。実際のファイルシステムと転送はこの 2 つに依存します。
brew install --cask macFUSE
brew install gromgit/fuse/sshfs-mac2. 初回起動の承認問題
未署名ビルドは一度だけ承認が必要です。アプリが一瞬で消える、または起動できない場合は Finder から右クリックで開いてください。
その後、「システム設定 > プライバシーとセキュリティ」に承認導線が出ていないか確認します。
3. 認証とホスト情報の問題
- ホスト名、ユーザー名、リモートパスが正しいか確認する。
- 保存済みリモートを信用しすぎず、アプリから資格情報を再テストする。
- 貼り付けたパスワードが怪しい場合は一度きれいに保存し直す。
4. マウントポイントの衝突
SSH 接続が成功しても、ローカルマウントポイントが別のリモートと衝突したり stale path を指したりすると失敗します。各リモートに固有のローカルパスを使ってください。
5. スリープ、復帰、ネットワーク回復の問題
macFUSEGui は必要なリモートをスリープ、復帰、ネットワーク回復後に戻す設計です。stale のままなら、一度切断してからネットワークが本当に戻っているか確認し、再接続します。
繰り返す場合は診断をコピーし、回復のどの段階が失敗したかを確認してください。
6. stale mount / broken mount
Finder にリモートが見えていてもパスが応答しない場合は stale mount として扱います。まずアプリから切断し、stale mount が残ったまま設定を消さないでください。
7. 推測の前に診断を見る
診断スナップショットは推測を減らすためにあります。繰り返し失敗する場合は、環境、状態、直近の回復イベントを一度に確認できる形でコピーしてください。