Como recuperar e gerenciar senhas no CloudPanel via CLI e interface

Quem usa o CloudPanel para hospedar sites e aplicações em servidores Linux sabe que o painel é leve, rápido e direto ao ponto. No entanto, perder a senha de acesso administrativo ou ficar bloqueado fora da interface web na porta 8443 pode acontecer com qualquer um.

Nessas horas, saber como recuperar o acesso sem precisar reinstalar o painel ou quebrar sites em produção é fundamental. O CloudPanel oferece dois caminhos claros: o utilitário de linha de comando clpctl (que opera direto no servidor via SSH) e a própria interface web (para rotações normais de credenciais).

Abaixo mostro o passo a passo exato para redefinir senhas administrativas e gerenciar os acessos individuais de sites e SFTP.

1. Redefinição de senha de administrador via linha de comando (CLI)#

Se você esqueceu a senha da conta de administrador ou a interface web não está acessível no navegador, o terminal SSH é o caminho mais rápido para recuperar o controle.

O CloudPanel possui um binário de controle chamado clpctl, localizado no sistema operacional. Esse utilitário conversa diretamente com o banco de dados interno do painel, sem depender do servidor web ou de serviços externos.

Conecte-se ao servidor via SSH com privilégios de root (ou usando sudo):

clpctl user:reset:password --userName=admin --password='MinhaNovaSenhaSegura123!'

Detalhes dos parâmetros:#

• --userName: Informe o nome do usuário que você deseja redefinir (como admin ou outro usuário cadastrado no painel).
• --password: Informe a nova senha entre aspas simples ('). As aspas são importantes no terminal Linux para evitar que caracteres especiais comuns em senhas fortes (como $, ! ou *) sejam interpretados pelo interpretador de comandos Bash.

O comando executa instantaneamente e atualiza o hash da senha no banco interno. Após a execução, você já pode acessar https://IP_DO_SERVIDOR:8443 e fazer login normalmente com a nova senha.

2. Alteração de senha administrativa pela interface web#

Quando você já está logado no painel e deseja apenas trocar a senha por questão de rotina ou política de segurança:

1. Acesse o painel pelo navegador em https://IP_DO_SERVIDOR:8443.
2. No canto superior direito da tela, clique em Admin Area (Área Administrativa).
3. No menu lateral esquerdo, clique na opção Users (Usuários).
4. Localize o usuário que deseja modificar e clique no ícone de edição.
5. Digite a nova senha nos campos correspondentes e clique em salvar.

Essa alteração afeta usuários com permissões globais no painel, responsáveis por gerenciar o servidor, adicionar novos domínios e configurar regras de firewall.

3. Redefinição de senha de usuários de sites (SSH e SFTP isolados)#

O CloudPanel adota uma arquitetura em que cada site possui seu próprio usuário de sistema isolado. Esse usuário é quem gerencia os arquivos da aplicação via SFTP ou SSH e pode ter acesso restrito apenas ao dashboard daquele site específico.

Se um desenvolvedor, cliente ou você mesmo precisar redefinir a senha desse usuário de site:

1. Na tela inicial do CloudPanel, clique sobre o domínio que você deseja gerenciar.
2. No menu lateral do site, clique na aba Settings (Configurações).
3. Role a página até encontrar a seção Site User (Usuário do Site).
4. No campo de senha, digite a nova credencial e confirme a alteração.

Ao salvar essa tela, o CloudPanel atualiza simultaneamente a senha de acesso ao SFTP, a permissão de login via SSH (caso esteja habilitada para aquele usuário) e a senha de login no dashboard do site.

4. Boas práticas de segurança após a redefinição de senhas#

Sempre que alterar senhas de servidores, especialmente via linha de comando, vale a pena seguir alguns cuidados rápidos:

1. Limpar o histórico do terminal: O Bash armazena os comandos digitados no arquivo ~/.bash_history. Se você rodou o clpctl com a senha em texto aberto, limpe o histórico da sessão para que a senha não fique registrada em disco:

   history -c && history -w

1. Ativar autenticação em dois fatores (2FA): O CloudPanel suporta 2FA nativo para usuários administradores. Ative essa camada extra no perfil do usuário para evitar acessos indevidos caso a senha vaze.
2. Senhas exclusivas por site: Evite usar a mesma senha de administrador nos usuários de sites individuais. Como os usuários de sites costumam ser compartilhados com desenvolvedores ou configurados em clientes FTP, manter credenciais separadas isola o restante do servidor.

Veja também

Cibersegurança Troubleshooting real: do crash status 255 no Fail2ban ao backend systemd e modularização no Nginx

Servidores Cifras em servidores web: da confusão conceitual com ransomware ao hardening real de SSL/TLS

Cibersegurança Análise forense de um comprometimento no CloudLinux e cPanel: da armadilha do sshd_config à persistência no PAM e IPMI

Este post está licenciado sob CC BY-NC.