Servidor DHCP no Linux com ISC Kea: kea-dhcp4.conf, sub-redes, reservas e teste de configuração

Objetivo

Configurar o servidor DHCPv4 do ISC Kea com uma sub-rede, um pool de endereços e uma reserva fixa para um host, testar a configuração antes de carregá-la e saber onde os leases são registrados.

Pré-requisitos

O pacote kea-dhcp4 instalado; uma interface de rede na sub-rede a ser atendida; nenhum outro servidor DHCP ativo nesse segmento.

Passos

1. Escreva /etc/kea/kea-dhcp4.conf em JSON, dentro do objeto de nível superior Dhcp4. Liste as interfaces que atenderão clientes em interfaces-config ("interfaces": ["eth0"]); sem uma entrada ali, o Kea não abre nenhum socket DHCP. Defina pelo menos uma sub-rede no array subnet4, cada uma com um id único e estável (o Kea atual exige um; versões mais antigas numeravam as sub-redes automaticamente), um subnet em notação CIDR e um array pools, como {"pool": "10.0.0.100 - 10.0.0.200"}, conforme a referência do servidor DHCPv4 do Kea.
2. Adicione uma atribuição fixa quando um dispositivo precisar sempre do mesmo endereço: dentro do array reservations de uma sub-rede, uma entrada identificada por hw-address (ou client-id, duid) com um ip-address fixo dá a esse cliente sempre o mesmo endereço. Prefira endereços reservados fora da faixa de pools, para que nenhum outro cliente possa já tê-los como lease dinâmico.
3. Teste o arquivo antes de o servidor carregá-lo de verdade: kea-dhcp4 -t /etc/kea/kea-dhcp4.conf (código de saída 0 indica que ele parece válido). A opção -t verifica o arquivo de configuração e relata o primeiro erro, se houver; a verificação não é exaustiva. Versões recentes também oferecem -T, que além disso carrega bibliotecas de hook e conecta-se aos bancos de dados configurados, ainda sem abrir sockets.
4. Inicie ou reinicie o daemon (systemctl restart kea-dhcp4-server no Debian e no Ubuntu, kea-dhcp4 no RHEL e no Fedora, ou config-reload pelo socket de controle) e verifique no log se há uma mensagem de carregamento bem-sucedido.
5. Observe onde os leases são gravados: o parâmetro name do banco de dados de leases indica o arquivo em que novos leases e atualizações de leases são registrados, por padrão kea-leases4.csv no diretório var/lib/kea da instalação (/var/lib/kea/ nos pacotes). Desde o Kea 2.7.9, o arquivo de leases deve permanecer nesse diretório de dados; caso contrário, o servidor se recusa a iniciar. Faça backup desse arquivo antes de qualquer migração planejada.
6. Se estiver migrando do dhcpd do próprio ISC, planeje uma substituição em vez de um reparo: as últimas versões de manutenção do ISC (4.4.3-P1 e 4.1-ESV-R16-P2) foram publicadas em 5 de outubro de 2022, e o anúncio de fim de vida afirma que administradores que implantam DHCP em novos ambientes devem buscar uma solução além do ISC DHCP, pois seria irresponsável investir em novas implantações desse software, agora em fim de vida, e aponta o Kea como alternativa mantida.

Resultado esperado

kea-dhcp4 -t termina sem erros com um arquivo válido; o daemon registra no log as sub-redes que carregou; um cliente de teste no segmento recebe uma oferta do pool configurado, e um cliente com reserva sempre recebe o endereço fixo.

Limites e base de verificação

Nem -t nem -T abrem sockets, e -t não carrega bibliotecas de hook; por isso, uma porta já em uso ou um caminho de hook quebrado ainda pode causar falha na inicialização real. Depois de qualquer alteração de configuração, teste o lease de um cliente real, não apenas a verificação de sintaxe. Executar dois servidores DHCP no mesmo segmento faz os clientes receberem ofertas conflitantes; confirme que qualquer servidor anterior foi parado antes de colocar o Kea em produção. Mantenha backup do arquivo de configuração anterior e do arquivo de leases antes de alterar a configuração.