Guia de suporte

Solução de problemas do macFUSEGui

Se um mount não conecta, fica stale depois do sleep ou o macOS bloqueia o app, esta página ajuda a separar a causa entre pré-requisitos, autenticação, estado do mount e recovery.

1. Falhas de pré-requisito

Se nada monta, confirme primeiro se macFUSE e sshfs estão instalados.

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

2. Problemas na aprovação inicial

Builds não assinadas exigem autorização única. Abra o app pelo Finder com clique direito.

Depois verifique Privacidade e Segurança para o aviso de aprovação.

3. Problemas de autenticação e host

• Confira hostname, usuário e caminho remoto.
• Reteste as credenciais dentro do app.
• Se a senha foi colada, salve de novo se parecer suspeita.

4. Conflitos de mount point

Mesmo com SSH funcionando, o mount pode falhar se o caminho local já estiver em uso ou apontando para um mount stale. Use caminhos locais únicos.

5. Problemas após sleep, wake e rede

O macFUSEGui tenta restaurar remotes desejados após sleep, wake e retorno da rede. Se um remote continuar stale, desconecte-o, confirme o caminho de rede e conecte novamente.

Se acontecer sempre, copie os diagnósticos para ver em qual fase do recovery falhou.

6. Mounts stale ou quebrados

Se o Finder ainda mostra o remote, mas o caminho não responde, trate-o como stale mount. Desconecte primeiro no app.

7. Diagnósticos antes de suposições

O snapshot de diagnóstico existe para reduzir chute. Copie ambiente, estado e eventos recentes antes de escalar o problema.

Guias relacionados