Tutorial do Debian 13 / Configurar IPv4 estático e DNS com recuperação do DHCP

No ambiente Debian 13 gerenciado por ifupdown deste exercício, mude de Protocolo de Configuração Dinâmica de Host (DHCP) para IPv4 estático, interrompendo a configuração antiga antes de aplicar o arquivo preparado, e depois configure o DNS pela ferramenta que realmente o gerencia. Prepare o acesso ao console, backups e um caminho de recuperação testado antes de alterar uma conexão remota. Este laboratório verifica endereços, rotas, resolução de nomes, uma nova conexão SSH e persistência após reinicialização, e então restaura a configuração DHCP original em uma VM dedicada do VirtualBox com NAT.

Confirme o ambiente de rede exato

Use o ambiente ifupdown identificado na aula sobre gerenciamento da rede e do DNS. Aqui, enp0s3 usa allow-hotplug e é gerenciado através do ifup@enp0s3.service. Inicialmente, o dhcpcd fornece seu endereço DHCP e informações de DNS. NetworkManager, networkd, resolved e resolvconf não são usados nesta VM.

ip -br address
ip route
cat /etc/network/interfaces
ls -l /etc/resolv.conf
cat /etc/resolv.conf
systemctl cat ifup@.service
systemctl status ifup@enp0s3.service --no-pager

Não aplique os arquivos a seguir diretamente se sua ferramenta de gerenciamento de rede, nome da interface ou política de inicialização for diferente. Conexões gerenciadas pelo NetworkManager ou networkd devem ser tratadas com as configurações dessas ferramentas. Ambientes onde resolv.conf é um link de outro serviço também diferem do exemplo de arquivo de DNS manual neste artigo.

Certifique-se de que você realmente consegue fazer login no console do VirtualBox e usar sudo. Manter apenas uma sessão SSH é diferente de poder recuperar via console. O teste do curso original utilizou Debian 13.7, ifupdown 0.8.44, VirtualBox 7.2.10.

Escolha os endereços, o DNS e o destino do encaminhamento NAT

Item Valores para esta VM dedicada Critérios de Seleção
Interface enp0s3 Verifique o nome real usando a saída do ip
Endereço IPv4 e Comprimento do Prefixo 10.0.2.15/24 Manter o endereço existente do NAT dedicado e alterar o método de alocação para estático
Gateway Padrão 10.0.2.2 Endereço do roteador desta rede NAT
DNS 10.0.2.3 Função de pesquisa de nome padrão do NAT do VirtualBox
Encaminhamento SSH 127.0.0.1:22213 → 10.0.2.15:22 Informe o endereço da VM convidada na regra existente, limitada às conexões vindas do hospedeiro

Um endereço inalterado não prova que o convidado está usando configuração estática: o DHCP pode atribuir o mesmo endereço novamente. Este laboratório altera o método de atribuição enquanto mantém o endereço existente em um NAT isolado com um convidado. Em uma LAN funcional, obtenha um endereço sem conflito e confirme com o administrador as reservas/pools de DHCP, sub-rede, gateway e política de DNS interno. Não copie esses valores de NAT para outra rede.

Explicação sobre NAT do Oracle guia o intervalo de endereços padrão e as condições de encaminhamento de porta para endereços fixos de convidados. No VirtualBox, verifique a regra SSH existente em Configurações da VM → Rede → Adaptador 1 → Avançado → Encaminhamento de Porta. Mantenha IP do Host 127.0.0.1, Porta 22213, TCP, e Porta do Convidado 22, e especifique 10.0.2.15 para o IP do convidado. Registre a entrada original antes das alterações e não adicione regras duplicadas para a mesma porta.

127.0.0.1 do host não é o próprio endereço de loopback do Debian. Trate as configurações de encaminhamento do host e a configuração real de IP do convidado como tarefas separadas. Se você escolher outro IP fixo, o destino do encaminhamento deve corresponder a esse valor.

Salve os arquivos e prepare uma configuração estática

Execute estes comandos dentro do Debian. Execute separadamente a primeira linha, que cria o diretório de backup e continue apenas se ela for bem-sucedida; pare se qualquer cópia falhar. Preserve um backup existente escolhendo um novo nome e alterando todos os caminhos relacionados de forma consistente.

sudo test ! -e /var/backups/lf-debian13-14 && sudo install -d -m 700 /var/backups/lf-debian13-14
sudo cp -a /etc/network/interfaces /etc/resolv.conf /etc/dhcpcd.conf /var/backups/lf-debian13-14/
sudo cp -a /etc/network/interfaces /var/backups/lf-debian13-14/interfaces.static
sudo nano /var/backups/lf-debian13-14/interfaces.static

A partir do arquivo atualmente válido, altere apenas a parte IPv4 da enp0s3 de DHCP para estática e insira o endereço e gateway. Preserve a diretiva source, o loopback e a configuração IPv6 existente. Se houver a mesma definição de interface em um arquivo incluído separado, entradas duplicadas devem ser resolvidas primeiro. O conteúdo completo do arquivo preparado para esta VM mínima é o seguinte.

source /etc/network/interfaces.d/*

auto lo
iface lo inet loopback

allow-hotplug enp0s3
iface enp0s3 inet static
    address 10.0.2.15/24
    gateway 10.0.2.2
iface enp0s3 inet6 auto

Esta é uma configuração IPv4 estática correspondente ao manual de interfaces, e /24 é o comprimento do prefixo de rede. Não especifique a mesma rota padrão em outras interfaces. Este é um exemplo que mantém a configuração automática existente, não um que desativa o IPv6.

sudo ifup --no-act --force -i /var/backups/lf-debian13-14/interfaces.static enp0s3

Na saída --no-act, verifique se o endereço preparado e a rota padrão estão corretos. Este não é um comando para testar conexão real ou sucesso do DNS. As interfaces atuais ainda não foram desativadas, então as conexões SSH existentes são mantidas.

Prepare e verifique o script de recuperação

A interface allow-hotplug desta VM mantém o processo DHCP em execução com o serviço ifup@ existente. Se você apenas chamar ifup dentro de um serviço temporário do systemd, o processo filho do DHCP também pode terminar quando o serviço temporário acabar. A recuperação deve ser confiada ao serviço de interface existente. Em seguida, abra o novo arquivo.

sudo nano /var/backups/lf-debian13-14/restore.sh

O conteúdo completo é o seguinte. Alinhe o nome da interface e o caminho com sua configuração verificada.

set -eu
ifdown --force enp0s3 || true
cp -a /var/backups/lf-debian13-14/interfaces /etc/network/interfaces
cp -a /var/backups/lf-debian13-14/resolv.conf /etc/resolv.conf
systemctl restart ifup@enp0s3.service
printf 'Original DHCP and DNS ownership restored\n'

Esse script de emergência tenta restaurar a configuração salva mesmo se ifdown falhar. Para confirmar a recuperação, verifique o resultado do reinício do serviço, o endereço, os processos e o DNS realmente utilizados. Não aplique ifup@ como está em servidores que usam a política auto ou outros serviços de inicialização.

No teste original, inicialmente, o ifup foi executado diretamente dentro de um serviço temporário, o que causou a parada do DHCP junto. Após modificá-lo como acima, a recuperação programada foi re-verificada. É por isso que a conexão não é considerada restaurada apenas pelo código de saída do comando de recuperação.

Escreva o script de aplicação e confira quem gerencia o DNS

Em seguida, execute sudo nano /var/backups/lf-debian13-14/apply.sh para salvar todo o conteúdo abaixo. A liberação do DHCP é realizada primeiro em um estado onde a configuração DHCP anterior é lida, e então o arquivo de configuração estática é copiado para seu local efetivo.

set -eu
ifdown enp0s3
cp -a /var/backups/lf-debian13-14/interfaces.static /etc/network/interfaces
ifup enp0s3
if pgrep -x dhcpcd > /dev/null; then
  printf 'A DHCP management process remains. Check DNS ownership before continuing.\n'
  exit 1
fi
printf 'nameserver 10.0.2.3\n' > /etc/resolv.conf
ip -br address show enp0s3
ip route
getent ahostsv4 deb.debian.org

A escrita manual em resolv.conf se aplica aqui somente porque ele é um arquivo comum, e não um link simbólico, o cliente DHCP foi encerrado e nenhuma outra ferramenta gerencia o DNS. Você pode consultar o manual do dhcpcd para ver como o dhcpcd cria arquivos DNS. Não use métodos que bloqueiem forçadamente outros gerenciadores, fixando o arquivo com atributos de proteção contra gravação.

Simplesmente escrever dns-nameservers em interfaces não significa que o DNS será aplicado em todas as instalações. Como na documentação de integração do resolvconf, scripts de integração (hooks) e configurações que processem essa opção são necessários. Ambientes que usam resolved, NetworkManager ou resolvconf configuram o DNS através de seus respectivos caminhos de gerenciamento. Para este exercício, nenhum gerenciador de DNS adicional será instalado.

Agende a recuperação antes de aplicar a alteração

Verifique as permissões e a sintaxe do script antes de agendar a recuperação, e pare em caso de qualquer falha. Use a linha de agendamento de rollback separadamente e confirme que lf-net14-rollback.timer exibe active (waiting), conferindo com sudo systemctl status lf-net14-rollback.timer --no-pager antes de executar a linha de aplicação. Se uma unidade com qualquer um dos nomes já existir, inspecione-a em vez de reutilizá-la cegamente. Escolha um intervalo maior antes de aplicar se cinco minutos não forem suficientes para suas verificações.

sudo chmod 700 /var/backups/lf-debian13-14/restore.sh /var/backups/lf-debian13-14/apply.sh
sudo bash -n /var/backups/lf-debian13-14/restore.sh
sudo bash -n /var/backups/lf-debian13-14/apply.sh
sudo systemd-run --unit=lf-net14-rollback --on-active=5m /bin/bash /var/backups/lf-debian13-14/restore.sh
sudo systemd-run --unit=lf-net14-apply --collect /bin/bash /var/backups/lf-debian13-14/apply.sh

Use serviços temporários e temporizadores conforme descrito no manual do systemd-run. Embora o comando aplicado seja separado do shell SSH para continuar a tarefa mesmo se a conexão for perdida, a própria mensagem de criação do serviço não indica que a configuração está completa. Mantenha o console, pois a conexão pode cair brevemente.

O temporizador de recuperação não é uma programação permanente que persista após a reinicialização. Primeiro, verifique na inicialização atual e, se sua operação normal não puder ser confirmada, não tente resolver reiniciando; use a recuperação programada e o console.

Verifique endereços, rotas, DNS, SSH e persistência após reiniciar

Verifique o seguinte no console ou em uma sessão reconectada. Imediatamente após a aplicação, pode haver um breve período em que o estado do link está se estabilizando, então compare os logs com o estado final real.

ip -br address show enp0s3
ip route
cat /etc/resolv.conf
pgrep -a dhcpcd
getent ahostsv4 deb.debian.org
sudo journalctl -u lf-net14-apply.service --no-pager -n 30

Neste ambiente, confirme o endereço 10.0.2.15/24, o gateway padrão 10.0.2.2 e o servidor DNS 10.0.2.3; dhcpcd não deve continuar em execução. O endereço no resultado da resolução de nomes varia em tempo de execução, então não memorize um único endereço para comparação. O sucesso na resolução de nomes e a resposta normal de um serviço web específico são assuntos separados.

Verifique também uma nova conexão no novo terminal do host usando a chave existente via SSH. Se o caminho de encaminhamento da porta for o mesmo, use ssh -p 22213 lfstudent@127.0.0.1, mas ajuste suas configurações de chave e conta. Como o servidor não foi reinstalado, não ignore os avisos de chave do host nem exclua aleatoriamente o arquivo known_hosts.

Cancele a recuperação agendada apenas quando o endereço, a rota, o DNS e a nova conexão estiverem todos corretos.

sudo systemctl stop lf-net14-rollback.timer
sudo systemctl reboot

Salve seu trabalho e confirme que consegue usar o console para recuperar o acesso antes de reiniciar. Após a inicialização, repita as mesmas verificações e nova conexão SSH. Na VM do teste original, após reiniciar, IPv4 fixo, rota padrão e DNS manual foram mantidos, e autoconfiguração de IPv6, SSH ativo e zero serviços com falha foram confirmados.

Restaure o DHCP e verifique a recuperação

Para finalizar a prática de configuração fixa, execute o script de recuperação preparado, seja a partir do console ou como um serviço independente. Use apenas um dos métodos abaixo. Se houver outras alterações legítimas após o backup, verifique primeiro as diferenças.

sudo systemd-run --unit=lf-net14-restore --collect /bin/bash /var/backups/lf-debian13-14/restore.sh

Para executá-lo diretamente a partir do console, use sudo bash /var/backups/lf-debian13-14/restore.sh. Para manter o processo DHCP em execução, não substitua o reinício do serviço ifup@ existente por uma chamada isolada a ifup no serviço temporário. Ao aplicar, verifique as novas conexões e o status final.

ip -br address show enp0s3
ip route
pgrep -a dhcpcd
head -n 6 /etc/resolv.conf
systemctl status ifup@enp0s3.service --no-pager
getent ahostsv4 deb.debian.org
sudo cmp /etc/network/interfaces /var/backups/lf-debian13-14/interfaces

O script de recuperação corrigido foi testado através de um temporizador agendado mais curto, de 45 segundos, no laboratório original. O endereçamento e rotas DHCP, o DNS gerado pelo dhcpcd, a configuração da interface restaurada e uma nova conexão SSH foram verificados posteriormente. O exemplo de cinco minutos dá mais tempo para as verificações do leitor. Um lease DHCP renovado pode fornecer informações atualizadas de DNS, portanto o resolv.conf não precisa permanecer idêntico byte a byte ao seu texto antigo.

Restaure também o valor anotado no campo Guest IP (IP da VM convidada) da regra de encaminhamento no hospedeiro. No teste original, esse campo foi deixado novamente em branco para recuperar a regra DHCP inicial; isso não apaga o endereço IP dentro do Debian. Verifique separadamente a rede da VM e a regra do hospedeiro para localizar eventuais falhas de conexão.