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