Tutorial do Debian 13 / Registrar o estado do servidor e preparar um clone independente da VM

Registre o sistema operacional, kernel, pacotes, serviços, rede e pontos de montagem de um servidor Debian para comparar seu estado antes e depois de alterações. Ao clonar uma máquina virtual, revise tanto sua identidade de hardware — o identificador universalmente único (UUID) e o endereço MAC (Media Access Control) do adaptador de rede — quanto o hostname do sistema convidado, machine-id e chaves SSH do host. Um inventário ajuda a escolher como recuperar o servidor, mas não substitui um backup completo dos dados e configurações.

Escolha o que incluir no estado de referência

Use a VM dedicada após concluir a configuração inicial e as verificações de autenticação por chave SSH. Registrar um estado conhecido de funcionamento ajuda a identificar mudanças após a instalação de pacotes, atualizações ou configuração de serviços. Defina o que você está comparando e quando cada registro foi coletado, em vez de confiar na memória de uma tela.

Informações registradas O que o registro informa Conteúdos não incluídos
SO e kernel Qual distribuição e kernel em execução estão sendo usados? A lista de todos os kernels instalados e o kernel em execução são diferentes.
Pacotes e marcas de instalação manual Qual versão e status de instalação foram registrados? Estes não são os arquivos .deb reais nem os dados do aplicativo.
Serviços Quais são as configurações de inicialização e o status atual de execução? O fato de estar em execução não garante a resposta normal do serviço.
Endereços, rotas e montagens Como estão configuradas atualmente as conexões de comunicação e dos dispositivos de armazenamento? Não coleta todos os arquivos de configuração permanentes e políticas de firewall.

Backups de arquivos de configuração, dados e segredos são gerenciados por políticas separadas. O mesmo servidor não pode ser reproduzido automaticamente apenas com a lista de pacotes. Isso ocorre porque versões anteriores podem desaparecer do repositório, e programas instalados a partir do código-fonte, contêineres e configurações de aplicativos nem sempre aparecem na lista do dpkg.

Execute o script completo de coleta do estado de referência

Execute isso no Debian como um usuário comum. Em um diretório de trabalho dedicado, cole o bloco completo para criar collect-baseline.sh e execute-o; se esse nome de arquivo já existir, inspecione-o e escolha um nome novo em vez de sobrescrevê-lo. O script usa umask 077 para restringir os registros recém-criados ao seu proprietário. Ele lê o estado do sistema e cria um novo diretório em sua home sem alterar as configurações do sistema.

cat > collect-baseline.sh <<'EOF'
set -eu
umask 077
record_dir="$HOME/server-baseline-$(date -u +%Y%m%dT%H%M%SZ)"
mkdir "$record_dir"
cat /etc/os-release > "$record_dir/os-release.txt"
uname -r > "$record_dir/kernel.txt"
dpkg-query -W -f='${binary:Package}\t${Version}\t${db:Status-Status}\n' > "$record_dir/packages.tsv"
apt-mark showmanual > "$record_dir/manual-packages.txt"
systemctl list-unit-files --type=service --no-pager > "$record_dir/service-files.txt"
systemctl list-units --type=service --state=running --no-pager > "$record_dir/running-services.txt"
ip -br address > "$record_dir/ip-address.txt"
ip route > "$record_dir/routes.txt"
findmnt --real > "$record_dir/mounts.txt"
lsblk -o NAME,SIZE,FSTYPE,MOUNTPOINTS > "$record_dir/disks.txt"
printf '%s\n' "$record_dir"
wc -l "$record_dir"/*
test -s "$record_dir/packages.tsv"
test -s "$record_dir/mounts.txt"
EOF
bash collect-baseline.sh

A primeira linha de saída é o caminho do diretório gerado, seguida pelas contagens de linhas de cada arquivo. No registro do curso original com instalação mínima do Debian 13.7, packages.tsv continha 334 registros e a lista de instalação manual continha 200. Estas são observações dessa VM, não os números de pacotes exigidos pelo Debian. Leia a coluna de status: um registro de pacote pode descrever um pacote removido com arquivos de configuração restantes, portanto, nem toda linha significa um pacote instalado.

O manual do dpkg-query documenta -W e o formato de saída para separar pacote, versão e status com tabulações. Aspas simples evitam que expressões como ${Version} sejam interpretadas primeiro pelo shell. apt-mark showmanual mostra pacotes que o APT marcou como instalados manualmente. Isso não significa necessariamente que uma pessoa os tenha instalado individualmente; eles também podem ser marcados pelo instalador ou pela configuração da imagem.

Se executado novamente no mesmo segundo e o diretório já existir, mkdir falhará e interromperá. Não exclua nem sobrescreva dados existentes; tente novamente após um curto período. set -e interrompe o script para evitar que dados parcialmente gravados sejam interpretados como um resultado completo após uma falha, mas arquivos pré-erro podem permanecer, então verifique se as duas verificações finais de arquivos não vazios também foram bem-sucedidas.

Inspecione os registros e compare alterações

Digite na solicitação abaixo o caminho realmente exibido pelo script e confira o conteúdo do diretório. Como o script foi executado com um bash separado, não assuma que a variável record_dir dentro dele permanece no shell atual.

read -r -p 'Generated baseline directory: ' baseline_dir
ls -ld "$baseline_dir"
head -n 5 "$baseline_dir/packages.tsv"
cat "$baseline_dir/kernel.txt"
cat "$baseline_dir/mounts.txt"

No comando ls -ld, verifique se você é o proprietário do diretório de registros e se o modo não permite acesso a outros usuários. Endereços de rede e listas de serviços também revelam a estrutura do servidor, então não envie o diretório original para fóruns públicos como está. O script não coleta chaves privadas SSH, arquivos de senha ou o machine-id bruto.

Após fazer alterações, execute o script de coleta novamente e insira os dois caminhos que são realmente gerados. Por exemplo, você pode verificar as diferenças nas mudanças de versão de pacotes e nos indicadores de instalação manual, respectivamente.

read -r -p 'Baseline directory before the change: ' before_dir
read -r -p 'Baseline directory after the change: ' after_dir
diff -u "$before_dir/packages.tsv" "$after_dir/packages.tsv"
diff -u "$before_dir/manual-packages.txt" "$after_dir/manual-packages.txt"

Nenhuma saída diff significa que os arquivos comparados correspondem. As linhas alteradas aparecem com - para o arquivo anterior e + para o arquivo posterior. Um código de saída 1 significa que diferenças foram encontradas; um arquivo ilegível é um erro diferente. Os registros de serviços em execução também podem mudar porque serviços transitórios iniciam ou param, ou a ordem de saída varia. Não infira uma falha a partir de apenas uma linha alterada. Copie os registros que você precisa manter para um armazenamento separado com controle de acesso que sobreviva à perda do disco da VM.

Entenda quais identidades um clone copia

Quando você clona um disco virtual, os arquivos internos do sistema operacional também são copiados. Mesmo que o VirtualBox crie um novo endereço MAC para a nova VM, você não deve presumir que as chaves de host SSH dentro dela também serão automaticamente regeneradas.

Informações Camada de gerenciamento Verificações antes de usar o clone como novo servidor
UUID e MAC da VM Hardware virtual do VirtualBox Use um novo UUID e novo endereço MAC, e verifique antes de conectar à rede.
Nome do host, endereço IP e DNS Configurações do convidado e da rede Escolha um nome apropriado para a função e um endereço que não seja duplicado.
machine-id Identificação do sistema operacional convidado Se for um novo servidor, verifique se o valor é único.
Chave de host SSH Identidade do servidor SSH Gere uma chave para o novo servidor e forneça a impressão digital verificada aos clientes.
Chaves de autenticação do usuário e segredos de aplicação Conta e aplicação Revise separadamente se os direitos de acesso e tokens copiados podem ser reutilizados.

UUIDs de disco e sistema de arquivos e machine-id são valores diferentes. Um disco replicado com o mesmo UUID de sistema de arquivos pode existir dentro de uma VM independente, mas se o disco original e o disco replicado estiverem conectados a um único convidado ao mesmo tempo, a seleção de montagem baseada em UUID pode se tornar ambígua. Simplesmente alterar o UUID do disco arbitrariamente também afeta as configurações de fstab e de inicialização, portanto, essa prática não faz isso.

Diferencie uma substituição que assume o papel de um servidor com falha de um servidor adicional que funcionará junto ao original. Se o original ainda estiver atendendo tráfego, não conecte um clone com endereços, nomes e dados de autenticação duplicados à mesma rede.

Prepare um clone independente sem conexão de rede

A prática tem como alvo apenas uma VM mínima sem serviços de negócios. Desligue normalmente a VM original. No VirtualBox Manager, selecione o nível de experiência Expert, se necessário, clique com o botão direito na VM desligada e escolha Clone… (Clonar…). Defina um nome e caminho de armazenamento diferentes, escolha clone completo, estado atual da máquina e gere novos endereços MAC para todos os adaptadores de rede. Não selecione a opção de manter o mesmo UUID de hardware. Clones vinculados dependem do disco e snapshots originais, portanto, não são a mesma coisa que um backup independente.

A documentação de clonagem do Oracle VirtualBox explica as escolhas disponíveis; verifique as opções na versão instalada. No teste original com VirtualBox 7.2.10, o clone completo recebeu um UUID de VM e endereço MAC diferentes do original.

  1. Nas configurações do clone, desative todos os adaptadores de rede. Além disso, verifique se o encaminhamento de porta NAT herdado corresponde ao novo servidor e remova quaisquer regras duplicadas.
  2. Anote separadamente os nomes e os caminhos de armazenamento da VM original e do clone. Abra apenas o console da cópia para inicializar e fazer login.
  3. Se aplicativos operacionais, tarefas agendadas, envio de e-mails, integrações com interfaces de programação (APIs) externas ou tarefas de backup foram copiadas, interrompa e limpe-os antes de conectar à rede. O servidor mínimo deste artigo não possui tais serviços de negócios.

A razão pela qual o nome do host original aparece dentro do clone inicial é que a configuração foi copiada para o disco. Primeiro, verifique nesta tela para ter certeza de que você não selecionou por engano a VM original. Você pode reduzir a chance de erro desligando a original e mantendo apenas o clone aberto.

Prepare a identidade do sistema convidado e desligue o clone

Aplique este procedimento apenas dentro do novo clone intencionalmente desconectado, que se tornará um servidor separado. Não execute no original ou em um servidor de produção. Execute o primeiro comando de diretório de backup separadamente e pare se ele falhar. Se o caminho já existir, inspecione-o e escolha um nome novo de forma consistente antes de continuar. Armazene os arquivos de comparação no diretório restrito do clone.

sudo test ! -e /var/backups/clone-identity-before && sudo install -d -m 700 /var/backups/clone-identity-before
sudo cp -a /etc/machine-id /etc/hostname /etc/ssh/ssh_host_ed25519_key.pub /var/backups/clone-identity-before/
sudo hostnamectl set-hostname debian13-clone01
sudo nano /etc/hosts

No editor, substitua o nome antigo somente nas linhas correspondentes de /etc/hosts e preserve as outras entradas. Para configurações de nome de host e métodos de resolução de nomes locais, aplique os procedimentos do exercício sobre hostname, fuso horário e localidade. Remova as chaves SSH existentes da réplica e gere novas chaves usando o seguinte comando. O conteúdo da chave privada não é exibido na tela.

sudo rm -f /etc/ssh/ssh_host_*_key /etc/ssh/ssh_host_*_key.pub
sudo ssh-keygen -A
sudo /usr/sbin/sshd -t
sudo ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Como esta tarefa cria a identidade do novo servidor, ela não é diretamente aplicável a operações de recuperação que preservam a identidade SSH de um servidor existente. Servidores com configurações separadas, como certificados de host ou chaves de hardware, também não utilizam o exemplo geral de instalação mínima como está.

Os serviços usam o machine-id como um identificador estável. Depois de preparar a renovação desse identificador, não continue a operação normal com serviços misturando a identidade antiga e a nova. Para este clone mínimo isolado, prepare os arquivos abaixo e realize imediatamente um desligamento normal para que uma nova ID seja gerada na próxima inicialização. A implantação automatizada de imagem genérica é melhor realizada por meio de um processo deliberado de preparação de imagem offline.

ls -l /var/lib/dbus/machine-id
sudo truncate -s 0 /etc/machine-id
sudo ln -sfn /etc/machine-id /var/lib/dbus/machine-id
sudo systemctl poweroff

Este exemplo tem como alvo uma configuração mínima do Debian, onde /var/lib/dbus/machine-id é um arquivo comum ou um link para /etc/machine-id. Se o diretório ou o ponto de montagem for diferente do esperado, pare e verifique. De acordo com o manual do systemd machine-id, uma imagem com um machine-id vazio gera um ID na inicialização. Se um ID separado do D-Bus for deixado como está, o valor anterior pode ser reutilizado, então ambos os caminhos são tratados juntos. Esvaziar o valor e remover o arquivo têm diferenças na determinação no primeiro boot, portanto, não são usados de forma intercambiável.

Verifique o clone após reiniciar

Reinicie apenas o clone, com a rede ainda desativada, e faça login através do seu console. Compare o machine-id com o valor salvo sem exibir nenhum dos IDs. A condição relata identidade inalterada, identidade diferente ou um erro de comparação; uma diferença só é significativa depois que os arquivos e o formato também forem verificados.

hostnamectl --static
if sudo cmp -s /etc/machine-id /var/backups/clone-identity-before/machine-id; then
  printf 'machine-id is unchanged. Investigate before enabling the network.\n'
else
  case "$?" in
    1) printf 'machine-id differs from the previous value.\n' ;;
    *) printf 'Comparison failed. Check file existence and permissions.\n' ;;
  esac
fi
sudo wc -c /etc/machine-id
if sudo grep -Eq '^[0-9a-f]{32}$' /etc/machine-id; then
  if sudo grep -Eq '^0{32}$' /etc/machine-id; then
    printf 'Invalid all-zero machine-id. Keep networking disabled.\n'
  else
    case "$?" in
      1) printf 'machine-id format check passed\n' ;;
      *) printf 'Could not check machine-id. Keep networking disabled.\n' ;;
    esac
  fi
else
  printf 'Invalid or unreadable machine-id. Keep networking disabled.\n'
fi
sudo cmp /etc/machine-id /var/lib/dbus/machine-id
sudo ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
sudo /usr/sbin/sshd -t

Para o cmp, o status de saída 1 significa conteúdo diferente; outros status de erro indicam problemas como arquivos ausentes ou ilegíveis. Um machine-id contém 32 caracteres hexadecimais minúsculos seguidos de uma nova linha, normalmente 33 bytes, e não deve ser todo zeros. Confira o tamanho e a mensagem machine-id format check passed. Se a verificação indicar apenas zeros, formato inválido ou falha de leitura, pare e mantenha a rede desativada. O caminho do D-Bus deve corresponder a /etc/machine-id sem um erro de cmp. Compare a nova impressão digital SSH com a impressão digital da chave pública do host salva; ela deve ser diferente para este clone de novo servidor.

O registro do curso original confirma, em uma VM de teste dedicada, o novo hostname, a diferença de machine-id e da chave pública do servidor SSH, a consistência do identificador D-Bus e a sintaxe válida do SSH. Também confirma, após reiniciar a VM original, a preservação do hostname, do machine-id e da chave SSH originais. Um clone que falha é desligado sem se conectar à rede para ser preparado novamente, e não redefinimos os identificadores da VM original para corrigir o clone.

Antes de conectar o novo servidor a uma rede em funcionamento, revise endereços, DNS, chaves de autenticação de usuário, tokens de serviço e tarefas agendadas, e habilite apenas o que ele precisa. Valores distintos de identidade da VM não provam que todas as credenciais copiadas e integrações externas foram tratadas.