Reconstruir reinstala o sistema operativo de raiz no seu servidor existente, o que apaga completamente o disco e lhe dá uma máquina limpa com os mesmos endereços IP.
É a ferramenta certa para um pequeno número de tarefas e uma péssima ferramenta para tudo o resto. Este guia explica quando uma reconstrução é realmente a resposta, o que destrói, uma consequência específica que apanha as pessoas desprevenidas, e como se preparar bem antes de clicar.
Quando reconstruir é a decisão certa
Reconstrua quando:
- Quer mudar de sistema operativo, por exemplo de Ubuntu para Debian, ou de uma versão do Ubuntu para outra.
- O sistema operativo não arranca ou está tão avariado que repará-lo demoraria mais do que começar de novo.
- Vai dar ao servidor uma utilização completamente diferente e não quer que fique nada da configuração antiga.
- Quer mesmo que tudo o que está no disco desapareça.
Não reconstrua para desfazer uma alteração que acabou de fazer. É para isso que servem os snapshots, e reverter é mais rápido e mantém os seus dados. Não reconstrua para libertar espaço em disco, para corrigir uma aplicação lenta ou porque algo está mal configurado: nada disso exige substituir o sistema operativo.
Leia isto antes de reconstruir
Uma reconstrução destrói permanentemente tudo o que está no servidor: todos os sites, caixas de correio, bases de dados, ficheiros carregados, pacotes instalados, certificados, tarefas cron e ficheiros de configuração. Não pode ser desfeita, e não há mais nenhum passo de confirmação depois do último. A caixa de diálogo de confirmação di-lo claramente: "Isto reinstala o sistema operativo e destrói permanentemente tudo o que está no servidor. Não pode ser desfeito."
A reconstrução apaga as ferramentas da KapsuleHost que são instaladas no disco quando um servidor é aprovisionado pela primeira vez, e são essas ferramentas que o painel usa para chegar ao interior da máquina. Voltamos a colocá-las por si, automaticamente, e verificamo-las. Os seus dados de cópias de segurança existentes estão guardados à parte num armazenamento externo encriptado e não são afetados por uma reconstrução.
Enquanto isso acontece, Restaurar, Fazer cópia de segurança agora, a aplicação em tempo real da firewall e de patches, e a consola do navegador não funcionam, porque todos dependem das ferramentas no disco. Normalmente demora alguns minutos. O servidor fica marcado como em reconstrução durante todo esse tempo: não é mostrado como pronto até cada um desses componentes ter sido lido de volta da máquina e confirmado, por isso o painel nunca lhe mostra um servidor verde que não consegue realmente gerir.
Se não conseguirmos restaurá-las, é avisado. O servidor fica em reconstrução em vez de passar a verde, e a nossa equipa de operações é alertada ao mesmo tempo. Não tem de verificar por si.
Os seus endereços IPv4 e IPv6 não mudam. Só o conteúdo do disco muda.
Preparar uma reconstrução
Percorra esta lista antes de começar. Nada disto é opcional se o servidor tiver algo que lhe interesse.
- Crie um snapshot. Um snapshot é uma cópia completa do disco. É a única coisa que lhe permite recuperar a máquina atual se mudar de ideias. Consulte Snapshots do servidor na nuvem.
- Exporte tudo aquilo com que quer continuar a trabalhar. Copie bases de dados, ficheiros carregados e configurações para fora do servidor: o seu computador, outro servidor ou armazenamento de objetos. As suas cópias de segurança existentes sobrevivem à reconstrução e o painel pode restaurá-las quando a reconstrução terminar, mas uma cópia guardada por si é o caminho mais rápido para voltar a ter um site a funcionar.
- Anote o que está instalado. Depois de uma reconstrução, vai montar a sua stack à mão. Uma lista de pacotes, serviços, virtual hosts e tarefas cron poupa horas.
- Verifique o seu DNS. Se algo aponta para este servidor, vai apontar para uma máquina vazia enquanto a reconstrução e a reconfiguração durarem.
- Confirme que consegue voltar a entrar. Decida agora como se vai ligar ao sistema operativo acabado de instalar, e consulte Ligar-se ao servidor na nuvem por SSH.
A consola do navegador fica indisponível durante os poucos minutos entre o fim da reconstrução e a reposição das ferramentas, por isso não faça dela a sua única forma de entrar. Tenha o SSH preparado.
Como reconstruir
- Inicie sessão no KPanel.
- Clique em Servidores Cloud na barra lateral esquerda e depois no servidor.
- Clique em Reconstruir SO nos botões de ação no topo da página.
- Abre-se a caixa de diálogo Reconstruir SO com a linha "Todos os dados neste servidor serão perdidos. Escolha o SO a instalar:" e uma lista pendente.
- Escolha o sistema operativo que quer:
- Ubuntu 24.04 LTS, a versão atual com suporte de longo prazo.
- Ubuntu 22.04 LTS, a versão anterior com suporte de longo prazo.
- Debian 12 (Bookworm), um Debian estável e leve.
- Clique em Reconstruir Servidor.
- Aparece uma confirmação final, com o título "Reconstruir" e o nome do seu servidor. Leia-a e depois clique em Reconstruir servidor.

Reconstruir SO só está disponível quando o servidor está Em execução ou Desligado. Um servidor ainda em aprovisionamento, ou já em reconstrução, não pode ser reconstruído.
O que acontece a seguir
- O estado do servidor muda para Em reconstrução e aparece uma faixa: "Reconstrução em curso: a página será atualizada automaticamente."
- Tudo no disco é apagado e a imagem do sistema operativo escolhido é escrita no seu lugar.
- O servidor reinicia na nova instalação.
- A página atualiza-se sozinha e o estado volta a Em execução.
O servidor fica offline durante todo esse tempo. Uma reconstrução é normalmente rápida, mas trate-a como uma interrupção e não como uma tarefa em segundo plano, e faça-a numa altura em que os seus utilizadores não notem.
Depois da reconstrução
Tem agora um sistema operativo de base. Nada do que instalou antes existe.
- Ligue-se ao servidor e confirme que obtém uma shell. Consulte Ligar-se ao servidor na nuvem por SSH.
- Volte a aplicar as regras da firewall. A reconstrução removeu as antigas. Consulte Firewall e gestão de segurança do servidor na nuvem.
- Instale de novo a sua stack: servidor web, runtime, base de dados e todas as dependências da aplicação.
- Restaure os seus próprios dados exportados.
- Volte a emitir os certificados SSL. Os anteriores estavam no disco que foi apagado.
Não presuma que a cópia de segurança diária vai voltar a apanhar o servidor sozinha. Se as ferramentas de cópia de segurança do servidor foram removidas pela reconstrução, as cópias de segurança não recomeçam por si. Verifique o cartão Cópias de Segurança depois da reconstrução e contacte-nos se indicar que as cópias de segurança não estão configuradas. Consulte Cópias de segurança do servidor na nuvem.
Alternativas a considerar primeiro
| O que quer | Ferramenta melhor do que uma reconstrução |
|---|---|
| Desfazer uma alteração que acabou de fazer | Reverter um snapshot |
| Recuperar ficheiros apagados ou uma base de dados avariada | Restaurar a partir de uma cópia de segurança |
| Mais CPU, memória ou disco | Redimensionar o servidor |
| Outra família de processadores ou região | Encomendar um servidor novo; consulte Escolher entre ARM, Standard e Dedicated vCPU |
| Um ambiente limpo para testar | Aprovisionar um segundo servidor pequeno e manter este intacto |
Resolução de problemas
O botão Reconstruir SO está a cinzento. O servidor não está num estado que o permita. Aguarde que termine o aprovisionamento ou uma reconstrução em curso.
O estado fica parado em Em reconstrução. A página verifica o estado a cada poucos segundos e atualiza-se sozinha. Se não mudar ao fim de quinze minutos, contacte o suporte com o nome do servidor.
Não consigo ligar-me depois da reconstrução. Está a ligar-se a uma instalação do sistema operativo totalmente nova, com novas chaves de anfitrião, por isso o seu cliente SSH recusa a impressão digital antiga. Remova a entrada da chave de anfitrião desatualizada para esse endereço IP e volte a ligar-se. Se a própria autenticação falhar, contacte-nos.
Reconstruí por engano. Se criou um snapshot antes, reverta-o. Se não criou, os dados perderam-se. É por isso que a confirmação está redigida como está.
Se não tem a certeza de que uma reconstrução é o que precisa, envie um email para support@kapsulehost.com a explicar o que quer alcançar, antes de começar. Uma reconstrução é uma das poucas ações na plataforma que não têm volta atrás.