Pular para o conteúdo
Documentação

Replicação para servidor réplica

O que a replicação do miniCP copia para um servidor réplica, o que ela não copia e como provisionar, monitorar e sincronizar a réplica.

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

A Replicacao mantém um segundo servidor (a réplica) com as mesmas contas, arquivos e configurações web do servidor principal. O painel sincroniza por SSH em intervalos regulares. A réplica serve como servidor de reserva ou como mais um nó atrás de um balanceador.

Acesse pelo menu Monitoramento > Replicacao.

Atenção: a replicação não copia bancos de dados, crons das contas nem dados do Redis. Ela não é um failover completo para sites que usam banco. Veja a seção "O que NÃO é replicado".

O que é replicado

A cada ciclo, para cada conta incluída na réplica:

Item Como é tratado
Usuário do sistema Criado na réplica com o mesmo UID e GID do principal.
Senha O hash da senha é copiado. O login funciona igual nos dois servidores.
Suspensão Conta suspensa no principal fica bloqueada na réplica, e os domínios dela ficam desativados.
Home (/home/<usuario>) Copiada por rsync, espelhando exclusões. Pula logs, tmp, .cache, backups, caches e sessões de aplicação e sockets.
Pools PHP-FPM Copiados; o PHP-FPM recarrega só quando o pool muda.
Vhosts Apache e NGINX Copiados e habilitados (ou desabilitados, se o domínio estiver inativo).
Certificados SSL Certificados do painel e do Let's Encrypt de cada domínio.
Apps Node.js Serviço e variáveis de ambiente copiados; o código vem na home.
Páginas padrão Página de domínio não configurado e página de site inativo.

Remoções também são propagadas:

  • Domínio removido no principal: vhost, link do NGINX e serviço Node são apagados na réplica.
  • Pool PHP removido: apagado na réplica.
  • Conta removida no principal: fica bloqueada na réplica (login travado, shell desativado). Os arquivos não são apagados. Remova manualmente se quiser.

Antes de recarregar o Apache ou o NGINX na réplica, o painel testa a configuração. Se o teste falhar, o reload não é feito e o erro vai para o log.

Dica: se o UID/GID de uma conta já existir diferente na réplica, essa conta é pulada para não entregar arquivos a outro usuário. Corrija na réplica e rode de novo.

O que NÃO é replicado

Não replicado Consequência
Bancos MySQL/MariaDB A réplica não tem os dados do site.
Bancos PostgreSQL Idem.
Crons das contas Tarefas agendadas não rodam na réplica.
Redis (cache, sessões, filas) Sessões de usuários não existem na réplica.
Logs e tmp das contas Cada servidor tem os seus. A réplica cria vazias as pastas ~/logs, ~/tmp e a pasta de logs da conta em /var/log/minicp/users/<usuario>/, usada pelos vhosts e pools.
Sudo Os usuários do painel não têm sudo. Qualquer arquivo sudoers antigo de uma conta é removido na réplica.

Na prática: sites estáticos ou que usam banco em um servidor separado funcionam na réplica. Sites com banco local (Laravel, Magento, WordPress com MySQL local) não funcionam sozinhos na réplica sem uma solução própria de replicação de banco.

Preparar o acesso SSH

A réplica é acessada por chave SSH, sem senha.

  1. Copie a chave do quadro Chave SSH Publica (para acesso aos replicas).
  2. Na réplica, adicione a chave ao root:
echo "ssh-ed25519 AAAA... minicp" >> /root/.ssh/authorized_keys
chmod 600 /root/.ssh/authorized_keys

Adicionar uma réplica

  1. Clique em Adicionar Replica.
  2. Preencha:
Campo O que informar
Nome (identificador) Nome curto: minúsculas, números, - ou _.
Intervalo (min) De quanto em quanto tempo sincronizar. Padrão 5.
Host / IP Endereço da réplica.
Usuario SSH e Porta SSH Padrão root e 22.
Usuarios para sincronizar Vazio = todas as contas. Ou lista separada por vírgula.
Habilitar sync automatico Liga a sincronização no intervalo definido.
Backend HAProxy e Porta Backend Opcional. Adiciona a réplica a um backend do HAProxy.
  1. Clique em Adicionar.

Se você informar um backend do HAProxy, a réplica entra nele em modo MAINTENANCE. Ela só recebe tráfego quando você ativar pela tela HAProxy.

Atenção: editar o backend depois, em Editar, não altera o HAProxy. Use a tela HAProxy para isso.

Provisionar a réplica

O provisionamento instala na réplica os componentes necessários. A réplica deve ser um Debian 13 com o SSH já configurado.

  1. Na linha da réplica, clique no ícone de foguete (Provisionar).
  2. Os itens já vêm marcados conforme o que está instalado no principal: versões do PHP, Apache, Nginx, MariaDB, PostgreSQL (com versão), Redis, Varnish, Certbot e Node.js.
  3. Desmarque o que não quiser.
  4. Clique em Iniciar Provisionamento e acompanhe o progresso.

Provisione antes do primeiro sync. Se uma versão do PHP usada por uma conta faltar na réplica, o log avisa e os domínios daquela versão ficam desativados na réplica.

Monitorar a réplica

A tabela Servidores Replicas mostra:

  • Health: atualizado a cada 30 segundos. Verde = serviços ativos; amarelo = CPU acima de 80%; vermelho = serviço com falha ou "SSH down". Passe o mouse para ver CPU, RAM, disco, uptime e serviços.
  • Status Sync: ok, pendente ou o número de erros.
  • Ultima: data e hora do último sync.

O botão Servicos abre um painel com os recursos da réplica e a lista de serviços (Apache, Nginx, MariaDB, PostgreSQL, Redis, FTP, PHP-FPM). Para cada serviço você pode iniciar, parar, reiniciar e ver os logs recentes.

Sincronizar agora e ver o log

  • Sync agora (ícone de setas): dispara a sincronização na hora, em segundo plano.
  • Ver log de sync: mostra o log do último ciclo, conta por conta, com cada item copiado e cada erro.

O log também fica no servidor principal em:

/var/log/minicp-replica-<nome>.log

Editar, pausar ou remover

  • Editar: muda host, porta, intervalo, contas e liga/desliga o Sync automatico habilitado. Desligado, a réplica aparece como "pausado".
  • Excluir: remove a réplica do painel e, se houver backend configurado, tira o servidor do HAProxy. Nada é apagado na réplica.
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!