blog
Painéis

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.

JR · · 13 min de leitura · 3 tabelas · 2 blocos de código

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
  1. O que muda na tela quando você troca FTP por SFTP
  2. As quatro informações que você precisa antes de abrir o FileZilla
  3. Conectar por senha primeiro, para validar host, usuário e porta
  4. Gerar e autorizar a chave sem sair do cPanel
  5. Apontar a chave no FileZilla sem errar o lugar
  6. Autenticou, conectou e a pasta aparece vazia
  7. O que cada mensagem de erro do FileZilla quer dizer
  8. Como desfazer tudo e o que manter daqui pra frente
  9. 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.

O erro muda conforme o motivo, e isso ajuda a saber o que pedir:

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

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:

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.

Da geração da chave à conexão sem senhaGerarcPanel, Acesso SSH, nova chaveAutorizarGerenciar, Autorizar a chave públicaBaixarChave privada, OpenSSH ou PPKApontarFileZilla, tipo Arquivo de chaveConectarPede passphrase, não a senha
Gerar não basta: sem o passo Autorizar, o FileZilla continua pedindo a senha do cPanel.

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.

Pasta vazia no SFTP: o que checar, em ordemConectou e não lista nadaAutenticação funcionou, listagem vaziaDiretório remoto padrãoLimpe o campo na aba AvançadoArquivos ocultosServidor, forçar exibição de ocultosPermissão no servidorchmod 700 .ssh, 600 authorized_keysUsuário erradoConta FTP não vale para SFTPTeste sem FileZillaComando sftp, depois pwd e ls
Ordem de verificação quando o SFTP autentica mas a pasta aparece vazia.

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:

  1. 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.
  2. 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.
  3. Desfazer permissão: se você aplicou chmod no 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

  1. Documentação oficial (cpanel) — How to Configure Your SFTP Client (cPanel). Consultado em 2026-09-18.
Leia também