blog
Painéis

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.

JR · · 11 min de leitura · 3 tabelas · 4 blocos de código

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
  1. O Terminal do cPanel não é um nível de acesso
  2. O que cada nível permite rodar de fato
  3. Onde o shell é liberado, no WHM ou no chamado ao suporte
  4. Por que usar chave em vez da senha da conta cPanel
  5. Sete mensagens de erro do SSH e o que cada uma quer dizer
  6. Revogar o acesso de um dev sem derrubar webmail, FTP e painel
  7. 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.

Os três níveis de shell de uma conta cPanelDisabled ShellSem sessão de shell, conta inteiraJailed ShellHome próprio, binários do jailNormal ShellSistema inteiro, limitado por permissões
O Terminal do cPanel não é um nível: ele entrega o shell que a conta já tem atribuído no WHM.

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

  1. 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).
  2. Localize a conta pelo usuário ou domínio.
  3. Escolha entre *Normal Shell*, *Jailed Shell* e *Disabled Shell* e salve (documentação).
  4. 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

  1. Liste o que está autorizado: cat ~/.ssh/authorized_keys ou a tela de gerenciamento de chaves no cPanel.
  2. Identifique as chaves pelo comentário no fim da linha. Se houver linha sem comentário, trate como desconhecida e remova.
  3. Remova ou desautorize as chaves da pessoa que saiu.
  4. Confirme a revogação tentando conectar com aquela chave. O esperado é Permission denied (publickey).
  5. 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.
  6. Remova contas FTP secundárias criadas para aquele projeto.
  7. 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).
  8. 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:

Revogar acesso de um dev sem derrubar o restoListar authorized_keysIdentifique cada chave pelo comentárioRemover a chave da pessoaDesautorize na área de SSHTestar a conexãoEsperado: Permission denied (publickey)Senha foi compartilhada?Se sim, troque e avise o clienteLimpar FTP e tokensContas secundárias e chaves de deployVoltar para Disabled ShellSó se ninguém mais precisa
Offboarding cirúrgico: revogar por chave individual não derruba painel, FTP nem webmail.

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:

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

  1. Documentação oficial (cpanel) — Manage Shell Access. Consultado em 2026-09-24.
Leia também