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
- Acesse o endereço do CmCP no navegador, por exemplo
https://cmcp.exemplo.com.br:5001. - 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ão600(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
- Entre no miniCP como administrador.
- Abra Configurações e fique na aba Geral.
- Na seção Cluster (gerenciamento central), clique em Gerar token.
- Copie o token exibido.
2. Registrar no CmCP
- No CmCP, abra o Dashboard.
- Clique em Adicionar.
- 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.
- 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 assumehttp://.
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.