Pular para o conteúdo
Documentação

CmCP: painel central de vários servidores

O que é o CmCP, o painel que acompanha vários miniCPs numa tela só, e como cadastrar um servidor nele.

R Regis Manze 20/11/2026 5 min de leitura

O CmCP (cluster miniCP) é um painel central para acompanhar e administrar vários servidores miniCP numa tela só. Ele mostra a saúde de todos, aponta alertas e permite agir em cada servidor sem entrar no painel dele.

O CmCP roda separado dos miniCPs, por padrão na porta 5001. Ele conversa com cada miniCP usando o token do cluster gerado no próprio miniCP.

O que dá para fazer

  • Ver todos os servidores em cards ou tabela: CPU, memória, disco, domínios, usuários, visitantes online e alertas.
  • Ver quais contas mais consomem, em cada servidor e no cluster inteiro (Ranking de consumo).
  • Ver o histórico de CPU, memória, disco e visitantes (6 horas, 24 horas ou 7 dias).
  • Gerenciar um servidor: serviços, logs, domínios e usuários.
  • Localizar em qual servidor está um domínio.
  • Atualizar os miniCPs à distância.
  • Abrir o painel de um miniCP já logado.

Um miniCP fora do ar ou lento não trava o CmCP: ele aparece como offline e os demais continuam respondendo normalmente.

Entrar no CmCP

  1. Acesse o endereço do CmCP no navegador, por exemplo https://cmcp.exemplo.com.br:5001.
  2. Entre com usuário e senha.

Na primeira execução o CmCP cria o usuário admin com uma senha aleatória, informada a quem fez a instalação. Troque essa senha no primeiro acesso.

Para criar outros usuários ou trocar senhas, use Sistema > Usuários no menu lateral. A senha precisa ter ao menos 6 caracteres. Todos os usuários do CmCP têm o mesmo nível de acesso. O login fica salvo por até 30 dias enquanto houver uso.

Segurança do login (CmCP 1.8.0)

  • Bloqueio por tentativas: 5 senhas erradas em 15 minutos bloqueiam o IP por 15 minutos. Durante o bloqueio, a tela mostra "Muitas tentativas. Aguarde N min.".
  • Sessões derrubadas: ao remover um usuário ou trocar a senha dele, todas as sessões abertas desse usuário são encerradas na hora.
  • Arquivos protegidos: o arquivo com os tokens dos servidores (cluster.json) e o segredo da sessão (.secret) ficam com permissão 600 (só o dono do serviço lê). O segredo não fica mais na unit do systemd, e reinstalar o CmCP mantém o segredo existente.
  • Novo login após atualizar: depois de atualizar para a 1.8.0, todos os usuários precisam entrar de novo uma vez.

Cadastrar um miniCP

1. Gerar o token no miniCP

  1. Entre no miniCP como administrador.
  2. Abra Configurações e fique na aba Geral.
  3. Na seção Cluster (gerenciamento central), clique em Gerar token.
  4. Copie o token exibido.

2. Registrar no CmCP

  1. No CmCP, abra o Dashboard.
  2. Clique em Adicionar.
  3. Preencha:
    • Nome: como o servidor vai aparecer no CmCP.
    • URL: endereço do miniCP com a porta, por exemplo https://painel.exemplo.com.br:5000.
    • Token do cluster: o token copiado no passo anterior.
  4. Clique em Adicionar.

O servidor aparece no dashboard e no menu lateral, em Servidores. Para conferir, abra o menu do card (três pontos) e clique em Testar conexão: a resposta mostra a versão do miniCP ou o erro.

Dica: informe a URL com https://. Se você digitar só o endereço, o CmCP assume http://.

Como o token é usado

O CmCP envia o token do cluster no cabeçalho Authorization: Bearer <token> de cada chamada aos endereços /cluster/* do miniCP. Desde a versão 2.64.0, o miniCP só aceita o token nesse cabeçalho: o token na URL (?token=) é recusado, para não ficar gravado em logs. Se você tem scripts próprios que chamam /cluster/*, envie o token no cabeçalho.

Token errado conta no mesmo bloqueio por força bruta do login e da API: 5 erros em 15 minutos bloqueiam o IP de origem por 15 minutos, para o login, a API e o cluster. O bloqueio fica na Auditoria do miniCP com a ação cluster_blocked.

Trocar o token ou remover um servidor

  • Regerar o token: no miniCP, clique em Regerar e confirme. O token antigo para de funcionar e o servidor aparece no CmCP com token invalido (401). Remova o servidor no CmCP e cadastre de novo com o token novo.
  • Remover do CmCP: no menu do card, clique em Remover. O miniCP não é alterado.
  • Cortar o acesso pelo miniCP: em Configurações > Geral > Cluster, clique em Remover e confirme. Nenhum CmCP consegue mais acessar aquele servidor.

Atenção: depois de regerar, atualize o token no CmCP logo. Enquanto ele continuar tentando com o token antigo, as falhas se acumulam e o IP do CmCP acaba bloqueado por 15 minutos.

Atenção: o token do cluster dá controle administrativo do servidor: parar serviços, suspender contas, desativar domínios, atualizar o painel e abrir o miniCP logado como administrador. Guarde-o como uma senha de root e regere se houver suspeita de vazamento.

Versões do miniCP

Alguns recursos do CmCP dependem da versão de cada miniCP. Servidores mais antigos continuam aparecendo, com menos informação.

Recurso no CmCP miniCP mínimo
Card no dashboard e gerenciar servidor Qualquer versão com token do cluster
Localizar domínio completo (cota, tipo, certificado) 2.56.0
CPU real e consumo por conta 2.60.0
Atualização remota e abrir painel já logado 2.61.0
Conexões TCP por conta no ranking 2.62.0

Em versões anteriores à 2.60, o card mostra a carga (load) dividida pelos núcleos no lugar da CPU real.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!