As ligações FTP falham. Falham na primeira configuração, falham após meses a funcionar bem, e falham de formas que dão mensagens de erro crípticas. Este guia cobre os erros de ligação FTP e SFTP mais comuns no Mac e como resolver cada um.

Timeout de ligação

Tenta ligar-se e nada acontece. Após 30-60 segundos, recebe um erro de timeout.

Causas comuns:

  • Uma firewall está a bloquear a ligação (a firewall do Mac, o router ou a firewall do servidor).
  • Está a usar o modo FTP Ativo quando precisa do modo Passivo. O modo Ativo requer que o servidor se ligue de volta ao Mac, o que a maioria dos routers NAT e firewalls bloqueiam.
  • O hostname ou endereço IP do servidor está errado.
  • O serviço FTP do servidor não está a correr.

Soluções:

  • Mude para o modo FTP Passivo. Esta é a configuração correta para quase todas as ligações modernas.
  • Verifique a firewall do Mac: Definições do Sistema > Rede > Firewall. Certifique-se de que a sua app FTP é permitida.
  • Verifique o hostname fazendo ping no Terminal: ping ftp.example.com
  • Tente ligar com outra app (como o comando sftp no Terminal) para excluir problemas específicos da app.

Ligação recusada

A ligação é rejeitada imediatamente, sem espera.

Causas comuns:

  • Porta errada. FTP usa a porta 21, SFTP usa a porta 22, FTPS Implicit usa a porta 990.
  • O serviço FTP/SFTP não está a correr no servidor.
  • A firewall do servidor está a bloquear explicitamente o seu IP.

Soluções:

  • Verifique o número da porta. Esta é a causa mais comum.
  • Confirme com o seu fornecedor de servidor que FTP/SFTP está ativado.
  • Pergunte se o seu IP precisa de ser adicionado à lista branca.

530 Login incorrect

Liga-se com sucesso mas o login é rejeitado.

Causas comuns:

  • Nome de utilizador ou palavra-passe errados. Copiar-colar às vezes adiciona espaços invisíveis ou quebras de linha.
  • A conta existe mas não está ativada para acesso FTP (alguns painéis de hosting requerem ativação separada do FTP).
  • Sensibilidade a maiúsculas/minúsculas. Alguns servidores tratam nomes de utilizador como sensíveis a maiúsculas.

Soluções:

  • Digite as credenciais manualmente em vez de colar.
  • Aceda ao painel de controlo do hosting e verifique se a conta FTP está ativa.
  • Tente ligar via Terminal para ver a resposta exata do servidor: ftp ftp.example.com

425 Can't open data connection

Faz login com sucesso mas as listagens de ficheiros ou transferências falham com erro 425.

Causas comuns:

  • Incompatibilidade de modo Ativo vs Passivo. O servidor não consegue estabelecer o canal de dados.
  • Para FTPS: falhas de reutilização de sessão TLS entre ligações de controlo e dados.

Soluções:

  • Mude para o modo Passivo.
  • Para FTPS, tente o modo Explicit na porta 21 em vez de Implicit na porta 990, ou vice-versa.
  • Alguns servidores requerem versões TLS específicas. Tente limitar a TLS 1.2 se disponível nas definições do cliente.

Falha no handshake SSL/TLS

Específico de ligações FTPS. A negociação de encriptação falha.

Causas comuns:

  • O certificado SSL do servidor expirou.
  • Está a ligar com FTP simples a uma porta que espera FTPS, ou vice-versa.
  • Incompatibilidade de versão TLS. O servidor requer TLS 1.2 mas o cliente tenta TLS 1.0.
  • Certificado autoassinado em que o cliente não confia.

Soluções:

  • Certifique-se de que selecionou FTPS (não FTP simples) nas definições de ligação.
  • Tente ambos os modos FTPS Explicit e Implicit.
  • Se o servidor usa um certificado autoassinado, verifique se o cliente tem opção para o aceitar.
  • Contacte o administrador do servidor para verificar se o certificado é válido e as versões TLS estão configuradas corretamente.

Falha na verificação da host key (SFTP)

Específico de SFTP. O Mac recusa ligar porque a chave SSH do servidor não corresponde ao esperado.

Causas comuns:

  • O servidor foi reinstalado ou as chaves SSH foram regeneradas.
  • É a primeira ligação e a verificação estrita de host está ativada.
  • Potencial ataque man-in-the-middle (raro, mas é para isto que o aviso serve).

Soluções:

  • Se sabe que o servidor foi reinstalado, remova a chave antiga: ssh-keygen -R hostname
  • Religue e aceite a nova chave quando solicitado.
  • Se não esperava uma mudança de chave, verifique com o administrador do servidor antes de aceitar.

Permissão negada

Liga-se e faz login, mas não consegue ler ficheiros, escrever ficheiros ou aceder a certos diretórios.

Causas comuns:

  • O utilizador FTP não tem permissões de leitura/escrita no diretório alvo.
  • A propriedade do diretório no servidor não corresponde ao utilizador FTP.
  • Restrições chroot/jail impedem a navegação fora do diretório home.

Soluções:

  • Contacte o administrador do servidor para verificar as permissões da sua conta.
  • Verifique se o caminho remoto no cliente FTP está correto e acessível pelo seu utilizador.
  • Em servidores que controla, verifique as permissões do diretório: ls -la /path/to/directory

Problemas específicos do Mac

Algumas particularidades do macOS:

  • O macOS removeu o servidor FTP integrado a partir do High Sierra (10.13). Se precisa de um servidor FTP no Mac, precisa de software de terceiros.
  • Atualizações do macOS podem afetar o SFTP. Grandes atualizações (especialmente Monterey) afetaram a conectividade SFTP em apps como Cyberduck e Transmit. Reiniciar o Mac ou repor a configuração SSH geralmente resolve.
  • Avisos do Gatekeeper podem impedir que apps FTP recém-descarregadas abram. Clique com o botão direito na app e selecione Abrir, ou vá a Definições do Sistema > Privacidade e Segurança para a permitir.