Pular para o conteúdo
Documentação

Perguntas frequentes: administradores

Respostas rápidas para administradores do miniCP: SSL, HAProxy, domínio removido, bloqueio de IP, backups, réplica e indicadores de CPU.

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

Respostas rápidas para as dúvidas mais comuns de quem administra um servidor miniCP. Cada resposta aponta o capítulo com o passo a passo completo.

O certificado SSL não foi emitido. Por quê?

O Let's Encrypt só emite o certificado quando o domínio já aponta para o servidor que responde por ele (o HAProxy, quando o servidor está atrás de um). Confira:

  1. O registro DNS do domínio (e do www, se pediu) já aponta para o endereço correto.
  2. O provisionamento terminou: na página HAProxy, veja o job do domínio. Status erro traz o motivo.
  3. Um e-mail padrão está definido em Configurações. Sem ele o certificado não é pedido.

Quando o registro é criado na Cloudflare pelo próprio painel, o HAProxy + SSL roda cerca de 1 minuto depois, para o DNS propagar. Veja Administração: SSL, HAProxy e DNS.

Removi um domínio, mas ele continua no HAProxy e na Cloudflare.

Remover o domínio tira o site do servidor web e do painel, e mantém os arquivos na home. A publicação no HAProxy e o registro DNS são removidos à parte, na página HAProxy e na Cloudflare. Pela API, DELETE /api/v1/domains/<dominio>?haproxy=1 remove o domínio do HAProxy na mesma chamada.

Um cliente (ou eu) está bloqueado por erro de senha.

O painel bloqueia o IP por 15 minutos depois de 5 tentativas erradas em 15 minutos. Senhas erradas no login, tokens errados na API e tokens errados do cluster somam na mesma contagem, e o bloqueio vale para os três. Basta aguardar. Os bloqueios ficam em memória: reiniciar o serviço do painel também os libera.

Onde ficam os logs das contas?

Desde a versão 2.66.0, em /var/log/minicp/users/<usuario>/: access e error de cada domínio, slowlog do PHP-FPM (fpm-slow.log), apps Node.js (node-<dominio>.log) e serviços do cliente (<nome>.log e <nome>-error.log). A pasta é do root, com permissão 0750 e grupo do usuário. Em ~/logs o painel cria atalhos com os nomes de antes, então o cliente continua lendo pelo mesmo caminho.

A migração é feita sozinha, uma vez por servidor, na atualização (ação user_logs_v2 na Auditoria). A rotação passa a cobrir /var/log/minicp/users/*/*.log, e a pasta de logs é removida junto com a conta. Veja Usuários (contas de hospedagem).

O cliente diz que não consegue apagar nem esvaziar um log.

É o esperado. Os arquivos de log são abertos pelo servidor web como administrador; mantê-los numa pasta que o cliente controla permitia que um cliente mal-intencionado afetasse arquivos do sistema. Por isso o cliente só lê. Para esvaziar, ele usa o botão Limpar Logs Antigos na tela Logs (mantém as entradas de hoje). Crons e scripts do cliente podem continuar gravando os próprios arquivos em ~/logs, com outros nomes.

A réplica pode assumir se o servidor principal cair?

Não para sites com banco de dados. A replicação copia contas, arquivos, pools PHP-FPM, vhosts, certificados e apps Node, mas não copia bancos MySQL/PostgreSQL, crons das contas nem Redis/sessões. Veja a tabela completa em Replicação para servidor réplica.

Onde ficam os backups? Estão seguros?

Os backups das contas ficam no disco do próprio servidor, com os arquivos da home e os bancos MySQL/MariaDB e PostgreSQL da conta (em db/*.sql.gz e db/*.pgsql.gz). Eles protegem contra exclusão acidental, mas não contra perda do disco ou do servidor. Copie-os para outro lugar, por exemplo um bucket S3/MinIO. Detalhes em Backups das contas.

Um backup ficou como "parcial". O que fazer?

O dump de algum banco falhou. O arquivo foi guardado sem esse banco e os backups antigos da conta não foram apagados, porque podem ser os únicos com o banco íntegro. Veja no log do backup qual banco falhou, corrija a causa (serviço parado, falta de espaço, tabela com problema) e rode o backup de novo. Detalhes em Backups das contas.

O card de CPU mostra um número e o load mostra outro. Qual vale?

O card de CPU mostra o uso real do processador (agora, média e pico do último minuto). O load conta processos esperando para rodar, inclusive os que esperam disco. Em servidores com muitos crons agendados no mesmo minuto, o load sobe na virada do minuto mesmo com a CPU tranquila. Para saber se o servidor está sobrecarregado, olhe a CPU real e a tela de consumo por conta.

O histórico de disponibilidade (uptime) zerou.

O histórico de uptime fica em memória e recomeça quando o serviço do painel é reiniciado, por exemplo após uma atualização. As verificações seguintes voltam a preencher o gráfico.

Como atualizo o miniCP?

Pela aba de atualização em Configurações, que mostra a versão instalada, as versões disponíveis e o que mudou em cada uma. Com vários servidores cadastrados no CmCP, a atualização pode ser feita de lá, servidor por servidor. Veja Administração: servidor e desempenho e CmCP: gerenciar e atualizar servidores.

Como integro outro sistema (ERP, automação) com o painel?

Pela API do miniCP. Gere um token em Configurações → API: o token de leitura só consulta, o de escrita cria, altera e remove domínios. Comece por API do miniCP: visão geral e tokens.

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!