SFTP no FileZilla: porta 22, chave autorizada e pasta vazia
Os três campos que mudam na tela do FileZilla, o erro exato de quando o SSH não está liberado na conta e o desfecho que ninguém documenta: autenticar com sucesso e ver a pasta vazia.

Resposta curta: troque o protocolo do site para SFTP no FileZilla, use a porta 22 (ou a porta SSH que sua hospedagem informar) e o usuário principal do cPanel, nunca uma conta de FTP. A chave você gera e, principalmente, autoriza em Acesso SSH, dentro do painel.
Neste artigo
- O que muda na tela quando você troca FTP por SFTP
- As quatro informações que você precisa antes de abrir o FileZilla
- Conectar por senha primeiro, para validar host, usuário e porta
- Gerar e autorizar a chave sem sair do cPanel
- Apontar a chave no FileZilla sem errar o lugar
- Autenticou, conectou e a pasta aparece vazia
- O que cada mensagem de erro do FileZilla quer dizer
- Como desfazer tudo e o que manter daqui pra frente
- Quando FTPS basta e o SFTP não compensa o trabalho
O que muda na tela quando você troca FTP por SFTP
Na tela do FileZilla, a diferença entre FTP e SFTP cabe em três pontos. O seletor Protocolo, no Gerenciador de sites, que sai de FTP - Protocolo de Transferência de Arquivos para SFTP - SSH File Transfer Protocol. O campo Porta, que sai de 21 e vai para 22 (ou para a porta SSH que a sua hospedagem informar). E uma janela nova na primeira conexão, avisando que a chave do host é desconhecida e mostrando uma impressão digital, algo como ssh-ed25519 255 SHA256: seguido de uma sequência de caracteres.
Trocar só a porta e deixar o protocolo em FTP não conecta. Trocar só o protocolo e deixar 21 também não, a menos que o servidor escute SSH ali, o que não é o caso do padrão do cPanel. Os dois campos andam juntos.
No FTP simples, usuário e senha viajam em texto claro. Qualquer ponto da rede entre o seu notebook e o servidor vê a credencial. No SFTP, a transferência acontece dentro de uma sessão SSH: o canal é cifrado e você pode autenticar com um par de chaves, sem digitar senha nenhuma.
A diferença prática que mais pega quem vem do tutorial de FTP: as contas criadas em "Contas FTP" no cPanel não servem para SFTP. O SFTP usa as credenciais de SSH da conta, ou seja, o usuário principal do cPanel. A documentação oficial do cPanel descreve exatamente esse caminho em How to Configure Your SFTP Client.
| FTP | FTPS (FTP sobre TLS) | SFTP | |
|---|---|---|---|
| Porta típica | 21 | 21 (com AUTH TLS) | 22, ou a porta SSH que a hospedagem informar |
| Canal cifrado | não | sim | sim |
| Base do protocolo | FTP | FTP + TLS | SSH |
| Usuário | conta de FTP ou usuário cPanel | conta de FTP ou usuário cPanel | usuário principal do cPanel com SSH liberado |
| Aceita par de chaves | não | não | sim |
| Contas FTP secundárias funcionam | sim | sim | não |
Se você só quer parar de mandar senha em texto claro e não pretende mexer em chave, o FTPS já resolve esse ponto e exige uma mudança só no campo "Protocolo". O SFTP com chave é um passo acima: tira a senha do caminho e deixa um rastro por chave, que você revoga sem trocar a senha do painel.
As quatro informações que você precisa antes de abrir o FileZilla
Separe estas quatro informações. Sem elas, todo o resto é tentativa e erro.
- Host: o nome do servidor ou o domínio do site. O IP do servidor também funciona e é útil quando o domínio ainda aponta para outro lugar (ou está atrás de proxy/CDN, que não repassa SSH).
- Usuário: o usuário principal do cPanel, aquele que aparece no canto do painel. Não é o e-mail, não é a conta de FTP.
- Porta: 22 é o padrão do SSH. Parte das hospedagens usa uma porta alternativa por segurança. Confirme com o seu provedor antes de culpar a senha.
- SSH liberado na conta: em muitos planos compartilhados o acesso SSH vem desativado e precisa ser habilitado a pedido. Se estiver desativado, nenhuma configuração do FileZilla vai conectar.
O erro muda conforme o motivo, e isso ajuda a saber o que pedir:
- Se o servidor não escuta SSH naquela porta, ou um firewall bloqueia, o log do FileZilla traz
Error: Connection refusedouError: FATAL ERROR: Network error: Connection refused, quase imediato. Quando o pacote some no caminho, em vez disso a tentativa fica parada e termina emError: Connection timed out. - Se o servidor responde mas a sua conta não tem SSH liberado, o handshake acontece e a autenticação falha:
Error: Authentication failed.logo depois deStatus: Connected to .... Em alguns servidores aparece antes a linhaDisconnected: No supported authentication methods available (server sent: publickey), que é o jeito do servidor dizer que senha não vale ali.
Nesse caso, o pedido ao suporte é específico: habilitar o acesso SSH/SFTP para o usuário principal do cPanel (informe o nome do usuário e o domínio), confirmar a porta em que o SSH escuta e dizer se o shell fica em modo normal ou jailed. Com essas três respostas você preenche o Gerenciador de sites sem adivinhar.
Antes de qualquer mudança em arquivos do site, faça um backup. No cPanel, Arquivos > Assistente de backup > Backup > Diretório inicial gera o download da sua pasta pessoal. Chave SSH não quebra site, mas mexer em permissão de pasta por engano quebra, e voltar atrás sem cópia é caro.
Conectar por senha primeiro, para validar host, usuário e porta
Este é o caminho curto. Serve para validar host, usuário e porta antes de complicar com chave. Se falhar aqui, a chave não vai resolver: o problema está em um dos três campos ou no SSH desativado.
Criar o site no Gerenciador de sites
No FileZilla, menu Arquivo > Gerenciador de sites e clique em Novo site. Dê um nome que você reconheça depois, algo como producao-exemplo (exemplo fictício).
Protocolo, host e porta: os campos que andam juntos
- Protocolo:
SFTP - SSH File Transfer Protocol. É o campo que mais gente esquece: trocar só a porta e deixar o protocolo em FTP não funciona. - Servidor: o host ou IP.
- Porta: 22, ou a porta alternativa informada pela hospedagem. Deixando em branco, o FileZilla assume 22.
- Tipo de autenticação:
Normal. - Usuário e Senha: os do cPanel.
A impressão digital que aparece na primeira conexão (e quando desconfiar dela)
Na primeira conexão aparece uma janela dizendo que a chave do servidor é desconhecida, com uma sequência de caracteres (a impressão digital). Isso é normal e é parte do SSH: o cliente está registrando com quem falou. Marque Sempre confiar neste host e siga.
Se essa mesma janela reaparecer depois, avisando que a chave mudou, pare. Ou o servidor foi reinstalado/migrado, ou você está falando com outra máquina. Confirme com o provedor antes de aceitar.
Por que você cai fora de public_html e isso está certo
Conectou, o painel da direita listou pastas, e entre elas aparece public_html. É o comportamento esperado: o SFTP abre no diretório inicial da conta, não dentro do site. Os arquivos do WordPress estão em public_html.
Gerar e autorizar a chave sem sair do cPanel
Com a conexão por senha funcionando, vale trocar a senha por uma chave. Todo o procedimento acontece no painel, sem terminal.
Onde fica o Acesso SSH no cPanel
No cPanel, seção Segurança, ícone Acesso SSH. Clique em Gerenciar chaves SSH.
Nome, passphrase e tamanho da chave que você vai gerar
Clique em Gerar uma nova chave. Preencha:
- Nome da chave: o padrão é
id_rsa. Se você já tem uma chave nesse nome, use outro, comofilezilla-notebook(exemplo fictício), para não sobrescrever. - Senha da chave (passphrase): opcional, mas recomendada. É o que impede que alguém com acesso ao seu computador use o arquivo da chave. Guarde no gerenciador de senhas; não há recuperação.
- Tipo e tamanho: se o painel oferecer escolha, prefira o padrão sugerido ou uma chave RSA de 4096 bits.
A chave privada fica gerada no servidor para download. Baixe, guarde no seu computador e não envie por e-mail, WhatsApp ou repositório Git.
Gerar não basta: a chave precisa ser autorizada
Esse passo é o que a maioria pula. Gerar não basta: na lista Chaves públicas, a nova chave aparece como não autorizada. Clique em Gerenciar e depois em Autorizar. Isso grava a chave em ~/.ssh/authorized_keys na conta, no servidor. A documentação do cPanel descreve o uso das chaves SSH para SFTP em How to Configure Your SFTP Client.
Qual formato de chave privada baixar para o FileZilla
Na lista Chaves privadas, use Exibir/Baixar. O cPanel oferece a opção de converter a chave para o formato PPK (usado pelo PuTTY) informando a passphrase. Para o FileZilla, qualquer um dos dois costuma servir: ele converte formatos OpenSSH ao importar e pede a passphrase na hora.
Apontar a chave no FileZilla sem errar o lugar
Usar a chave em um site específico
No Gerenciador de sites, no seu site SFTP, troque Tipo de autenticação para Arquivo de chave. Em Arquivo de chave, clique em Procurar e selecione o arquivo baixado. Se o FileZilla disser que precisa converter o arquivo, aceite: ele salva uma versão compatível ao lado do original.
Registrar a chave para todos os sites SFTP de uma vez
Menu Editar > Configurações > Conexão > SFTP > Adicionar arquivo de chave. A chave registrada ali entra no conjunto que o FileZilla oferece ao servidor em qualquer conexão SFTP, inclusive nos sites com Tipo de autenticação em Normal. A exceção é o site configurado com Arquivo de chave, que usa o arquivo apontado naquele site. É o caminho prático de quem administra vários sites no mesmo servidor com a mesma chave.
Como saber se a senha do cPanel saiu mesmo do caminho
Conecte. Se a chave tiver passphrase, o FileZilla pede a passphrase (da chave), não a senha do cPanel. No log da parte de cima da janela aparece a negociação e, em seguida, a listagem. Se ele ainda pedir a senha do cPanel, a chave não foi aceita: volte ao painel e confirme que ela está autorizada, não apenas gerada.
Depois que a chave funcionar, vale pedir à hospedagem que desative a autenticação por senha no SSH da sua conta, se o plano permitir. Aí a chave deixa de ser conveniência e passa a ser a única porta.
Autenticou, conectou e a pasta aparece vazia
Este é o desfecho que nenhum tutorial de FTP cobre, porque no FTP ele quase não acontece. No SFTP, autenticar e não listar nada é comum e tem causas bem separadas.
O diretório remoto forçado que esconde tudo
No Gerenciador de sites, aba Avançado, existe o campo Diretório remoto padrão. Se alguém digitou ali /public_html em uma conta cujo diretório inicial é /home/usuario, o FileZilla tenta abrir um caminho absoluto que não existe e mostra pasta vazia ou erro de diretório. Deixe o campo em branco e reconecte: você cai no diretório inicial, de onde enxerga public_html.
Ligar a exibição de arquivos ocultos
Menu Servidor > Forçar exibição de arquivos ocultos. Uma pasta que parecia vazia costuma ter .htaccess, .ssh e .well-known. Sem isso você pode concluir errado que a conta está vazia.
Permissão de .ssh e authorized_keys: o que vale é a do servidor
O SSH ignora a chave (e às vezes derruba a sessão logo após autenticar) quando as permissões estão frouxas. Atenção ao detalhe que faz muita gente perder tempo: quem é avaliado é o .ssh da conta no servidor, não o do seu computador. Rodar chmod no terminal da sua máquina não altera nada do lado remoto e ainda pode mexer na sua chave privada local.
Os comandos abaixo precisam rodar dentro da conta no servidor: pelo Terminal do cPanel (seção Avançado), ou em uma sessão SSH aberta com o usuário principal. Se o seu plano não mostra o ícone Terminal e o SSH não está liberado, não tente adaptar: abra um chamado pedindo ao suporte que ajuste as permissões de ~/.ssh e ~/.ssh/authorized_keys.
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
A primeira linha deixa a pasta .ssh acessível só pelo dono. A segunda faz o mesmo com o arquivo de chaves autorizadas. Nenhuma das duas apaga nada, mas se você rodar chmod no caminho errado quebra o acesso ao site, e é por isso que o backup vem antes.
O diretório inicial da conta também não pode ser gravável por grupo ou por todos. Se você mudou a permissão de /home/usuario para 777 em algum tutorial antigo, a autenticação por chave para de funcionar sem mensagem clara.
Conta de FTP, shell desativado e jailed shell: o que cada um faz
Conta criada em Contas FTP não autentica em SFTP. O sintoma não é listagem incompleta: é credencial recusada, por mais certa que a senha esteja. Use o usuário principal do cPanel.
Contas com shell desativado costumam autenticar e cair na sequência. Já contas com jailed shell funcionam bem para SFTP. Nesse modo, o caminho continua sendo /home/usuario: o que muda é que você não enxerga outras contas do servidor e o restante da árvore de sistema aparece reduzido, com poucos diretórios. Isso é esperado e não é erro. A situação em que o cliente mostra / como se fosse o seu diretório inicial é outra, específica de servidores com chroot no SFTP, e não é o padrão do cPanel.
Testar com o comando sftp para saber se o problema é o cliente
Quando você não sabe se o problema é o cliente ou o servidor, tire o FileZilla da equação. No terminal do seu computador (macOS, Linux ou PowerShell no Windows 10/11):
sftp -P 22 [email protected]
Troque 22 pela porta da sua hospedagem, usuario pelo usuário do cPanel e exemplo.com.br pelo host (valores de exemplo). O esperado é o prompt sftp>. Digite pwd e depois ls para ver onde você caiu e o que existe ali. Se o comando travar sem resposta, o problema é rede ou porta, não credencial. Se pedir senha mesmo com a chave configurada, a chave não está autorizada no servidor.
O que cada mensagem de erro do FileZilla quer dizer
| Sintoma no FileZilla | Causa provável | O que fazer |
|---|---|---|
| Conexão expira sem pedir senha | Porta SSH fechada na sua rede ou porta errada | Testar de outra rede (4G do celular) e confirmar a porta com a hospedagem |
| "Connection refused" imediato | Nada escutando naquela porta, ou SSH desativado no servidor | Pedir a liberação do SSH para a conta |
| Pede senha e recusa a correta | Credencial de "Contas FTP", que não vale para SFTP, ou SSH desativado para a conta | Usar o usuário principal do cPanel e confirmar o SSH liberado |
| Continua pedindo senha com chave configurada | Chave gerada mas não autorizada | Acesso SSH > Gerenciar chaves SSH > Autorizar |
| "Too many authentication failures" | Cliente tentando várias chaves antes da certa | Apontar a chave direto no site, em Tipo de autenticação: Arquivo de chave |
| Autentica e cai na sequência | Permissão frouxa em .ssh, authorized_keys ou no diretório inicial, no servidor |
chmod 700 e chmod 600 pelo Terminal do cPanel, ou pedir ao suporte |
| Conecta e lista vazio | Diretório remoto forçado inexistente, ou ocultos escondidos | Limpar o campo em Avançado e forçar exibição de ocultos |
| Avisa que a chave do host mudou | Servidor reinstalado, migrado, ou host errado | Confirmar com o provedor antes de aceitar |
Como desfazer tudo e o que manter daqui pra frente
Nada do que foi feito aqui é irreversível, desde que você saiba onde mexeu:
- Remover a chave: cPanel > Acesso SSH > Gerenciar chaves SSH > Desautorizar e depois Excluir. Se a chave privada vazou, faça isso primeiro e gere outra. Desautorizar é imediato e não afeta o site.
- Voltar para senha no FileZilla: no Gerenciador de sites, troque Tipo de autenticação de volta para
Normal. Funciona enquanto o SSH por senha estiver habilitado na conta. - Desfazer permissão: se você aplicou
chmodno caminho errado dentro do servidor e o site caiu, restaure a pasta pelo backup que fez no início.
Duas práticas que valem mais que a configuração em si: uma chave por máquina (assim você revoga o notebook perdido sem derrubar o desktop) e nunca guardar a chave privada dentro de public_html, nem em pasta sincronizada com nuvem pública.
E se depois de tudo o FTP simples ainda for o que você usa para subir um tema de vez em quando, pelo menos troque o protocolo para FTPS no mesmo Gerenciador de sites. É um campo. A senha para de viajar em texto claro hoje, e a chave você configura quando tiver meia hora tranquila.
Quando FTPS basta e o SFTP não compensa o trabalho
Nem todo cenário justifica o trabalho de gerar, autorizar e guardar chave. A tabela abaixo é o critério que usamos para responder isso, e em metade das linhas a resposta não vende plano nenhum:
| Situação | FTPS basta | Vale ir de SFTP |
|---|---|---|
| Você sobe arquivo no seu próprio site, uma ou duas vezes por mês | sim, e para por aqui | só se quiser tirar a senha do caminho |
| A hospedagem não libera SSH no plano | sim, é a única opção cifrada | não dá, não insista |
| Três ou mais pessoas com acesso ao mesmo site | funciona, mas todas dividem a mesma senha | sim: uma chave por pessoa, revogada individualmente |
| Deploy automatizado por script ou CI | dá para fazer, com senha em variável | sim: chave sem passphrase dedicada ao robô |
| Notebook que viaja ou é compartilhado | senha em texto no cliente FTP | sim, e com passphrase na chave |
| Você só precisa parar de mandar senha em texto claro hoje | sim, muda um campo | depois, sem pressa |
| Precisa de contas separadas por pasta (cliente só no diretório dele) | sim, é o que contas FTP fazem | não, SFTP no cPanel usa o usuário principal |
A última linha costuma ser a decisiva em agência: se o requisito é isolar um freelancer dentro de uma pasta, contas FTP com TLS resolvem e SFTP não resolve, porque ele entraria com o usuário principal da conta.
Referência do procedimento no painel: How to Configure Your SFTP Client, documentação oficial do cPanel.
Referências
- Documentação oficial (cpanel) — How to Configure Your SFTP Client (cPanel). Consultado em 2026-09-18.