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.

Resposta curta: 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.
Neste artigo
- O Terminal do cPanel não é um nível de acesso
- O que cada nível permite rodar de fato
- Onde o shell é liberado, no WHM ou no chamado ao suporte
- Por que usar chave em vez da senha da conta cPanel
- Sete mensagens de erro do SSH e o que cada uma quer dizer
- Revogar o acesso de um dev sem derrubar webmail, FTP e painel
- Padrão para tocar dez ou vinte sites sem virar bagunça
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).
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 [email protected]:... 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).
- 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:
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
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:
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:
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_keysou 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
~/.sshdo 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:
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 doauthorized_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/configpor 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.
Referências
- Documentação oficial (cpanel) — Manage Shell Access. Consultado em 2026-09-24.