# Como liberar acesso SSH no cPanel em 3 níveis de shell

Shell restrito, shell completo e Terminal do navegador não são a mesma coisa. O que cada um roda, como pedir a liberação e como revogar o acesso de um dev sem derrubar FTP, webmail e o painel do cliente.

> o cPanel/WHM trabalha com três níveis de shell em Account Functions » Manage Shell Access (Normal, Jailed e Disabled), e o Terminal do navegador não é um quarto nível: ele apenas herda o shell da conta. Liberar SSH é escolher o nível certo e autorizar a chave.

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

---

Quem mantém dez, vinte sites de clientes já passou por isto: o cliente contrata uma hospedagem cPanel, você abre o painel, encontra o ícone **Terminal**, digita `wp core update` e recebe um erro de comando não encontrado. Ou pior, o Terminal nem aparece na lista de ícones. A conclusão apressada é que "o plano não tem SSH". Às vezes tem, e o que falta é uma configuração de uma linha no WHM.

Este guia separa três coisas que costumam ser tratadas como uma só: o Terminal que roda no navegador, o shell restrito (jailed) e o shell completo. Depois mostra como pedir a liberação certa, como autorizar chave no lugar de senha e como tirar o acesso de um dev sem derrubar o FTP, o webmail e o login do cliente no painel.

## O Terminal do cPanel não é um nível de acesso

O Terminal é uma **interface**. Ele abre uma sessão de shell dentro do navegador, sem cliente SSH, sem porta exposta, sem chave. O ambiente que você recebe ali é o shell que a conta tem atribuída no servidor.

Esse comportamento não está descrito na página de documentação que cito mais abaixo: ela cobre os níveis de shell, não o Terminal. O que segue é procedimento de operação, verificado na interface, e vale conferir no servidor do seu cliente antes de prometer prazo. Com shell desabilitado, o Terminal não resolve. Com shell restrito, o Terminal te coloca no mesmo ambiente restrito que um `ssh` de fora colocaria.

Por isso a frase "tem Terminal, então tem SSH" é enganosa nos dois sentidos. Já vi conta com Terminal visível e ambiente tão cortado que `composer` não existia, e conta sem o ícone Terminal na lista de recursos cujo acesso por `ssh` funcionava normalmente com chave.

Quem decide o nível é o item de shell da conta. Na documentação oficial do cPanel, isso mora em **WHM » Account Functions » Manage Shell Access**, e são três opções: *Normal Shell*, *Jailed Shell* e *Disabled Shell* ([docs.cpanel.net](https://docs.cpanel.net/whm/account-functions/manage-shell-access/)).

### Normal Shell, o sistema de arquivos inteiro limitado só por permissões

Acesso de shell completo, com a visão normal do sistema de arquivos do servidor, limitado apenas pelas permissões do usuário Unix. O dev enxerga `/etc`, `/usr`, os diretórios de outros usuários na medida em que as permissões permitirem, e a lista completa de binários instalados.

### Jailed Shell, home próprio e só os binários que o admin colocou no jail

Ambiente restrito. A conta recebe um sistema de arquivos próprio, montado pelo servidor, no qual `/` deixa de ser a raiz real da máquina. O usuário vê o próprio home, um conjunto de binários que o administrador disponibilizou no jail e pouco mais. Em instalações cPanel, o shell restrito costuma aparecer como `/usr/local/cpanel/bin/jailshell` quando você roda `echo $SHELL`.

### Disabled Shell, a conta continua inteira menos a sessão de shell

Sem acesso de shell. A conta continua existindo por inteiro: cPanel, FTP, e-mail, banco, cron. Só a sessão interativa de shell é negada.

## O que cada nível permite rodar de fato

A tabela abaixo é o mapa que uso antes de prometer prazo para um cliente. "Depende" aqui não é evasiva: é a resposta honesta, porque o que existe dentro de um jail é decidido pelo administrador do servidor, e isso varia de provedor para provedor.

| Tarefa | Disabled Shell | Jailed Shell | Normal Shell |
|---|---|---|---||
| Abrir o Terminal do cPanel | não | sim, já no ambiente restrito | sim |
| Conectar por `ssh` de fora | não | sim | sim |
| SFTP / SCP | não | sim | sim |
| `wp-cli` | não | depende do binário estar no jail | sim |
| `composer install` | não | depende do PHP CLI e do `composer` no jail | sim |
| `git pull` por HTTPS | não | depende do `git` no jail | sim |
| `git pull` por SSH (porta de saída 22) | não | depende do firewall de saída | depende do firewall de saída |
| Rodar um cron manualmente para depurar | não | sim, dentro do jail | sim |
| Tarefas do Cron Jobs do cPanel continuarem rodando | sim | sim | sim |
| Ler `/var/log` do servidor, ver processos de outras contas | não | não | conforme permissões |

Três linhas merecem comentário.

A primeira é o SFTP. Com *Disabled Shell*, SFTP e SCP caem junto com o `ssh` interativo, porque os dois dependem de um shell válido atribuído ao usuário. Se em algum servidor o SFTP continuar funcionando mesmo com shell desabilitado no WHM, é porque o administrador montou um arranjo fora do padrão (um shell dedicado só a SFTP, por exemplo). Trate como exceção e confirme com o provedor em vez de contar com isso no seu fluxo de deploy.

A segunda é o cron. Desabilitar o shell de uma conta não desliga as tarefas agendadas no **Cron Jobs** do cPanel, porque o agendador não usa o shell de login da conta para executar o comando. O que você perde é a capacidade de rodar aquele mesmo comando na mão para ver a saída. Se o site do cliente depende de um cron crítico e você vai mexer no shell, valide antes com uma tarefa descartável do tipo `date >> $HOME/teste-cron.log` a cada cinco minutos, e confirme o arquivo crescendo depois da mudança.

A terceira é o `git` por SSH. Muitos servidores compartilhados bloqueiam conexões de saída na porta 22, então `git@github.com:...` falha com timeout enquanto `https://github.com/...` funciona. Isso não tem relação com o shell da conta, é regra de firewall, e a correção é trocar a URL do remote ou pedir liberação de saída ao provedor.

## Onde o shell é liberado, no WHM ou no chamado ao suporte

### Revendedor ou dono do servidor, liberar em Manage Shell Access

- Entre no WHM e vá em **Account Functions » Manage Shell Access**. A interface lista as contas do servidor (ou as suas contas, no caso de revenda com a ACL correspondente).
- Localize a conta pelo usuário ou domínio.
- Escolha entre *Normal Shell*, *Jailed Shell* e *Disabled Shell* e salve ([documentação](https://docs.cpanel.net/whm/account-functions/manage-shell-access/)).
- Peça ao dono da conta que entre no cPanel e autorize a chave pública na área de SSH. A mudança de shell libera o direito; ela não cria credencial nenhuma.

Na revenda, o padrão que recomendo é *Jailed Shell* como regra e *Normal Shell* só quando existe uma tarefa concreta que o jail não cobre. O jail te livra de uma classe inteira de problema: um dev com pressa não consegue passear pelo sistema de arquivos do servidor nem encostar em coisa que não é dele.

### Hospedagem compartilhada, o que escrever no chamado para não voltar vazio

Pedido vago gera resposta vaga. Mande o que precisa rodar, não só "quero SSH". Frase pronta, adapte o usuário e o domínio:

> **** Preciso de acesso de shell para a conta `usuario_cpanel` (domínio exemplo.com.br) para rodar `wp-cli` e `composer install` em deploys. Shell restrito (jailed) atende, não preciso de shell completo. Já tenho a chave pública ed25519 pronta para autorizar em SSH Access. Podem confirmar também o host e a porta de conexão e se há bloqueio de saída na porta 22 para `git`.

Esse texto responde de antemão as três perguntas que o suporte faria e deixa registrado que você não está pedindo privilégio a mais do que precisa. Se a resposta for que o plano não oferece shell em nenhum nível, a alternativa de trabalho é SFTP mais o Terminal, quando existir, e deploy por artefato pronto em vez de `composer install` no servidor.

## Por que usar chave em vez da senha da conta cPanel

Senha de SSH em conta cPanel é a senha da conta cPanel. Quem tem ela entra no painel, no FTP e no shell, e revogar significa trocar a senha do cliente. Chave separa as coisas: uma chave por pessoa, revogação de uma linha, sem tocar em mais nada.

### Gere o par na máquina do dev

```bash
ssh-keygen -t ed25519 -C "joao@agencia" -f ~/.ssh/id_ed25519_cliente
```

Use passphrase. O comentário no final (`-C`) é o que vai te salvar daqui a um ano, quando você abrir o `authorized_keys` e precisar saber de quem é cada chave.

### Autorize a chave pública no cPanel e confira o authorized_keys

O caminho a seguir é procedimento de operação, verificado na interface do cPanel, e não está coberto pela página de documentação citada acima (ela trata só dos níveis de shell no WHM). Nomes de menu mudam entre versões e temas, então procure pela área de SSH dentro do grupo de segurança do painel.

No cPanel do cliente, abra **Security » SSH Access » Manage SSH Keys**. Importe o conteúdo de `~/.ssh/id_ed25519_cliente.pub` (só a pública, nunca a privada) e, no meu uso da interface, a importação sozinha não libera o acesso: a chave ainda precisa ser marcada como autorizada, o que na prática grava a linha em `~/.ssh/authorized_keys`. Confirme abrindo esse arquivo depois.

Se preferir fazer pelo shell, quando já houver um acesso funcionando:

```bash
mkdir -p ~/.ssh && chmod 700 ~/.ssh
cat >> ~/.ssh/authorized_keys <<'EOF'
ssh-ed25519 AAAA... joao@agencia
EOF
chmod 600 ~/.ssh/authorized_keys
```

Permissão frouxa em `~/.ssh` ou no `authorized_keys` faz o sshd ignorar a chave sem dizer nada de útil no cliente: você só vê `Permission denied (publickey)`. Para confirmar que é isso, rode `ssh -v` e veja se a chave chegou a ser oferecida, e peça ao provedor a linha correspondente do log do servidor, que costuma registrar "bad ownership or modes".

### Padronize host, porta e chave no `~/.ssh/config`

Aqui mora o ganho de tempo da agência. Em vez de decorar host, porta e usuário de cada cliente, escreva uma vez. Exemplo fictício, troque host, usuário e porta pelos que o provedor informou:

```
Host cliente-alfa
    HostName servidor.exemplo.com.br
    User alfauser
    Port 22
    IdentityFile ~/.ssh/id_ed25519_cliente
    IdentitiesOnly yes
    ServerAliveInterval 60
```

Com isso, `ssh cliente-alfa` e `sftp cliente-alfa` funcionam, e `rsync -avz ./dist/ cliente-alfa:~/public_html/` também. O `IdentitiesOnly yes` evita que o cliente SSH ofereça todas as suas chaves em sequência e leve um bloqueio por excesso de tentativas.

### Quatro comandos para saber em que ambiente você caiu

Primeira coisa depois de conectar:

```bash
id; echo $SHELL; pwd; ls /
composer -V; php -v; wp --info; git --version
```

Se `/` mostra pouca coisa e `$SHELL` aponta para um caminho com `jailshell`, você está no shell restrito. A segunda linha responde, em quatro comandos, se o deploy que você planejou é viável ali dentro.

## Sete mensagens de erro do SSH e o que cada uma quer dizer

Os textos abaixo são exemplos do que aparece com mais frequência; a redação exata varia conforme o servidor e a versão do OpenSSH.

| Mensagem de exemplo | Leitura provável | Onde agir |
|---|---|---||
| `Permission denied (publickey)` | a chave não está autorizada, o cliente ofereceu outra chave, ou a permissão de `~/.ssh` está frouxa | área de SSH no cPanel, `IdentityFile` no `~/.ssh/config`, `chmod` no servidor |
| `Permission denied (publickey,password)` | senha também é aceita, mas a credencial usada está errada | confirme usuário e chave |
| `This account is currently not available.` | conecta, autentica e cai: shell desabilitado para a conta | Manage Shell Access no WHM |
| `ssh: connect to host ... port 22: Connection timed out` | porta fechada, host errado ou seu IP bloqueado | confirme porta com o provedor e cheque bloqueio de IP |
| `Connection refused` | não há serviço escutando naquela porta | porta provavelmente é outra |
| `bash: wp: command not found` | autenticou e entrou, o binário é que não existe no ambiente | instalar no home do usuário ou pedir no jail |
| `Host key verification failed.` | a chave do servidor mudou (migração, reinstalação) | confirmar com o provedor antes de remover a linha do `known_hosts` |

Repare na diferença entre `This account is currently not available.` e `bash: wp: command not found`. As duas frustram igual, mas a primeira é permissão e resolve no WHM; a segunda é ambiente, e não adianta pedir "mais acesso", adianta instalar o `wp-cli` no home ou usar shell completo.

## Revogar o acesso de um dev sem derrubar webmail, FTP e painel

O cenário clássico: o freelancer entregou, a agência trocou de time, e alguém decide "trocar todas as senhas". Aí o webmail do financeiro para de sincronizar no celular e o cliente liga irritado. Dá para ser cirúrgico.

| Ação | Tira o SSH? | Efeito colateral |
|---|---|---||
| Desautorizar/remover a chave do dev na área de SSH | sim, para quem usava aquela chave | nenhum em cPanel, FTP, webmail |
| Mudar a conta para *Disabled Shell* no WHM | sim, para todos | Terminal, SFTP e SCP deixam de funcionar para todos |
| Trocar a senha da conta cPanel | sim, se o acesso era por senha | derruba login do painel e o FTP principal do cliente |
| Remover conta FTP secundária | não | só aquele acesso FTP |
| Trocar senha de uma caixa de e-mail | não | só aquele cliente de e-mail |

A regra prática que sai da tabela: **se cada pessoa tinha a própria chave, o offboarding é uma linha de `authorized_keys` e ninguém percebe.** Se o acesso era pela senha da conta, a revogação obrigatoriamente respinga no painel e no FTP principal, e aí você precisa avisar o cliente antes.

### Checklist de offboarding em oito passos

- Liste o que está autorizado: `cat ~/.ssh/authorized_keys` ou a tela de gerenciamento de chaves no cPanel.
- Identifique as chaves pelo comentário no fim da linha. Se houver linha sem comentário, trate como desconhecida e remova.
- Remova ou desautorize as chaves da pessoa que saiu.
- Confirme a revogação tentando conectar com aquela chave. O esperado é `Permission denied (publickey)`.
- Se a pessoa também conhecia a senha da conta, troque a senha do cPanel e avise o cliente, porque isso muda o login dele no painel e a senha do FTP principal.
- Remova contas FTP secundárias criadas para aquele projeto.
- Reveja tokens de API e chaves de deploy dentro da aplicação (a chave de deploy do repositório costuma ficar esquecida no `~/.ssh` do servidor).
- Se ninguém mais precisa de shell naquela conta, volte para *Disabled Shell*, lembrando que isso também encerra SFTP e SCP.

Frase pronta para o cliente, quando ele perguntar por que precisa saber disso:

> **** Removemos o acesso técnico do profissional que saiu. O acesso de shell (linha de comando no servidor) foi revogado pela chave individual dele, sem alterar sua senha do painel, seus e-mails ou o FTP. Se em algum momento a senha da conta tiver sido compartilhada, aí sim precisamos trocá-la, e avisamos antes porque ela muda o seu login no painel.

## Padrão para tocar dez ou vinte sites sem virar bagunça

O que evita retrabalho não é o comando, é a convenção. A que funciona:

- **Uma chave por pessoa, nunca por projeto.** Chave de projeto compartilhada entre três devs vira chave impossível de revogar.
- **Comentário obrigatório na chave**, no formato `pessoa@agencia`. É o único metadado que sobrevive dentro do `authorized_keys`.
- **Shell restrito como padrão.** Só suba para shell completo quando houver uma tarefa nomeada que exija, e considere voltar depois.
- **Um bloco no `~/.ssh/config` por cliente**, com nome previsível (`cliente-alfa`, `cliente-beta`). Guarde esse arquivo no repositório interno da agência, sem chave privada, só a configuração.
- **Registro de quem tem acesso a quê**, uma planilha basta: cliente, usuário, tipo de shell, chaves autorizadas, data. No dia do desligamento, essa planilha é o checklist.
- **Nada de senha de conta cPanel em canal de chat.** A senha é o acesso mestre: painel, FTP e shell no mesmo pacote.

Quando o provedor não oferece shell em nenhum nível, o plano B é mover o trabalho pesado para fora do servidor: `composer install` na sua máquina ou na esteira de CI, e sobe o resultado por SFTP ou `rsync`. É mais lento de configurar uma vez e mais previsível todo mês, porque para de depender do que existe ou não dentro do jail de cada hospedagem.

Uma observação final sobre segurança, e ela vale contra o interesse de quem vende plano maior: habilitar shell completo para "facilitar" é a troca errada. O shell restrito cobre `wp-cli`, `composer` e `git` na maioria dos deploys de WordPress, e limita o estrago de uma chave vazada ao home daquela conta. Peça o restrito primeiro, meça o que falta, e só então peça mais.

