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

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

João Rizzon · 2026-10-24 · Painéis

---

## 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](https://docs.cpanel.net/knowledge-base/ftp/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 refused` ou `Error: FATAL ERROR: Network error: Connection refused`, quase imediato. Quando o pacote some no caminho, em vez disso a tentativa fica parada e termina em `Error: 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 de `Status: Connected to ...`. Em alguns servidores aparece antes a linha `Disconnected: 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, como `filezilla-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](https://docs.cpanel.net/knowledge-base/ftp/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 usuario@exemplo.com.br
```

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 `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](https://docs.cpanel.net/knowledge-base/ftp/how-to-configure-your-sftp-client/), documentação oficial do cPanel.

