Solucionar erro de conexão FTP no cPanel: passo a passo definitivo

7 min de leitura  ·  Guia técnico

Solucionar erro de conexão FTP no cPanel exige identificar as causas mais comuns, como credenciais incorretas, bloqueio de portas ou problemas de configuração no servidor. Neste guia, você aprenderá a diagnosticar e corrigir o erro de conexão FTP, restaurando o acesso ao seu site de forma segura e eficiente.

Pré-requisitos

• Acesso ao painel cPanel da sua hospedagem
• Acesso root ou sudo ao servidor (para ajustes avançados)
• Cliente FTP instalado (FileZilla, WinSCP ou similar)
• Servidor rodando Linux (Ubuntu 22.04, CentOS 7/8, AlmaLinux 8 ou similar)
• Firewall configurável (iptables, firewalld, CSF ou UFW)
• Backup recente dos arquivos de configuração do servidor

Diagnóstico inicial do erro de conexão FTP no cPanel

Ao tentar conectar via FTP no cPanel, mensagens como "530 Login authentication failed" ou "Connection timed out" indicam problemas específicos. O primeiro passo é identificar a mensagem de erro exata exibida pelo cliente FTP, pois cada uma aponta para uma causa diferente.

1. Abra o cliente FTP (ex: FileZilla) e tente conectar usando usuário e senha do cPanel.
2. Anote a mensagem de erro exibida. Exemplos comuns:
   • 530 Login authentication failed
   • 421 Too many connections
   • Connection timed out
   • Could not connect to server
3. Teste a conexão com o comando telnet na porta 21:

   telnet seu-dominio.com 21

   Trying 192.0.2.1...
   Connected to seu-dominio.com.
   220---------- Welcome to Pure-FTPd [privsep] ----------
   220-You are user number 1 of 50 allowed.
   220-Local time is now 10:30. Server port: 21.
   220-This is a private system - No anonymous login
   220 You will be disconnected after 15 minutes of inactivity.

4. Se não houver resposta, o firewall pode estar bloqueando a porta 21.
5. Verifique se o domínio resolve corretamente para o IP do servidor:

   nslookup seu-dominio.com

   Server:  8.8.8.8
   Address: 8.8.8.8#53
   Non-authoritative answer:
   Name:   seu-dominio.com
   Address: 192.0.2.1

Esses testes ajudam a isolar se o problema está nas credenciais, rede, firewall ou DNS.

Corrigindo credenciais e permissões de usuário FTP

Erros como "530 Login authentication failed" geralmente indicam usuário ou senha incorretos, ou permissões insuficientes.

1. No cPanel, acesse Contas de FTP e redefina a senha do usuário FTP.
2. Verifique se o usuário FTP está atribuído ao diretório correto.
3. Confirme se o usuário não excedeu o limite de conexões simultâneas.
4. Se necessário, crie uma nova conta FTP para teste.
5. Teste novamente a conexão com o novo usuário e senha.

Se o acesso funcionar com a nova conta, o problema era relacionado à conta FTP anterior.

Verificando e liberando portas FTP no firewall do servidor

O FTP utiliza a porta 21 para comandos e um range de portas para dados (modo passivo). Firewalls mal configurados bloqueiam essas portas, impedindo a conexão.

1. Identifique o firewall ativo (iptables, firewalld, CSF, UFW):

   sudo systemctl status firewalld
   sudo ufw status
   sudo csf -l

   Status: active
   To                         Action      From
   --                         ------      ----
   21/tcp                     ALLOW       Anywhere

2. Liberte a porta 21 e o range passivo (ex: 30000:31000):

   sudo ufw allow 21/tcp
   sudo ufw allow 30000:31000/tcp

   Rule added
   Rule added

3. No cPanel/WHM, defina o range passivo em Service Configuration > FTP Server Configuration e ajuste as portas conforme o firewall.
4. Reinicie o serviço FTP para aplicar alterações:

   sudo systemctl restart pure-ftpd

   ● pure-ftpd.service - Pure-FTPd FTP server
      Loaded: loaded (/usr/lib/systemd/system/pure-ftpd.service; enabled)
      Active: active (running)

Atenção: Antes de alterar regras de firewall, faça backup das configurações atuais para evitar perda de acesso remoto.

Configurando modo passivo e NAT para FTP no cPanel

O modo passivo é essencial para conexões FTP atrás de NAT ou firewalls restritivos. Sem o range correto liberado, o cliente FTP não conseguirá transferir arquivos.

1. No WHM, acesse Service Configuration > FTP Server Configuration.
2. Defina o campo Passive Port Range (ex: 30000-31000).
3. Abra o range no firewall:

   sudo firewall-cmd --permanent --add-port=30000-31000/tcp
   sudo firewall-cmd --reload

   success
   success

4. Se o servidor estiver atrás de NAT, configure o endereço público em Masquerade Address no WHM.
5. Reinicie o serviço FTP após alterações.

Para detalhes sobre uso de clientes FTP, veja Como usar o Filezilla como software FTP da minha Hospedagem?.

Problemas comuns e como resolver

Sintoma: 530 Login authentication failed

Causa: Usuário ou senha incorretos, conta FTP desativada ou permissões insuficientes.
Solução: Redefina a senha no cPanel, crie uma nova conta FTP para teste e verifique o diretório atribuído ao usuário.

Sintoma: Connection timed out ao tentar acessar FTP

Causa: Firewall bloqueando porta 21 ou range passivo, ou problema de rede.
Solução: Libere as portas necessárias no firewall e teste a conexão usando telnet ou nmap.

Sintoma: 421 Too many connections

Causa: Limite de conexões simultâneas atingido por usuário ou IP.
Solução: Finalize sessões FTP inativas no cPanel ou aumente o limite de conexões no WHM.

Sintoma: Falha apenas em modo passivo

Causa: Range de portas passivas não liberado no firewall.
Solução: Configure o range passivo no FTP Server Configuration do WHM e abra as portas no firewall.

Perguntas frequentes sobre erro de conexão FTP no cPanel

Quais são as causas mais comuns do erro de conexão FTP no cPanel?

As causas mais comuns incluem credenciais incorretas, firewall bloqueando portas FTP, modo passivo desabilitado, limite de conexões simultâneas e problemas de DNS. Diagnosticar corretamente cada fator é essencial para restaurar o acesso.

Como posso saber se o firewall está bloqueando o FTP no meu servidor?

Você pode testar a conexão FTP usando a porta 21 e verificar as regras do firewall do servidor. Ferramentas como telnet ou nmap ajudam a identificar se as portas necessárias estão abertas para conexões externas.

O que fazer se o acesso FTP funciona localmente mas não remotamente?

Se o FTP funciona localmente, mas não externamente, é provável que haja bloqueio de firewall, NAT mal configurado ou DNS incorreto. Revise as regras de firewall e as configurações de rede para liberar as portas corretas.

Como corrigir problemas de modo passivo no FTP do cPanel?

No cPanel, configure o range de portas passivas no Pure-FTPd ou ProFTPd e libere essas portas no firewall. Isso garante que clientes FTP possam se conectar corretamente em modo passivo, especialmente atrás de NAT.

Conclusão

• Diagnostique o erro de conexão FTP no cPanel analisando a mensagem do cliente FTP e testando portas e DNS.
• Corrija credenciais, permissões e limites de conexão, além de liberar portas no firewall e configurar o modo passivo.
• Valide cada etapa com testes práticos para garantir que o acesso FTP seja restabelecido de forma segura.

Precisa de ajuda com conexão FTP e cPanel?

Conte com a AviraHost para garantir acesso FTP estável, seguro e suporte especializado em hospedagem Linux e cPanel.

Veja os planos de hospedagem