Tutorial de Ubuntu 26.04 / Identifique Netplan, NetworkManager e networkd

O Netplan descreve a rede e passa a configuração para um renderizador como NetworkManager ou systemd-networkd. Antes de editar a rede do Ubuntu, identifique o renderizador real e a configuração de origem da interface, em vez de depender do nome da imagem.

Entenda o papel de cada componente

Componente Função e uso comum
Netplan Lê YAML e gera configuração de backend
NetworkManager Um backend opcional que gerencia perfis de conexão e Wi-Fi
systemd-networkd Geralmente gerencia interfaces de servidor
systemd-resolved Lida com resolução de nomes, separado de quem configura os endereços IP

Sistemas atualizados, imagens de nuvem e VMs personalizadas podem diferir dos padrões. Ambos os serviços podem ser executados enquanto gerenciam interfaces diferentes, então a execução dos dois processos, por si só, não indica conflito.

A explicação do Netplan do Ubuntu descreve a relação entre YAML e renderizadores.

Inspecione endereços e gerenciamento

ip -br link
ip -br address
ip route
systemctl is-active NetworkManager systemd-networkd

Registre nomes de interfaces, endereços e rotas padrão. Quando disponíveis, consulte nmcli connection show --active ou networkctl status. Uma indicação de interface não gerenciada no outro backend não significa necessariamente que a conexão ativa falhou.

Se precisar consultar sudo netplan status --all, avalie antes o estado do sistema: conforme a documentação do Netplan status, o comando depende do systemd-networkd e pode tentar iniciá-lo se não estiver mascarado. Em sistemas onde isso não é desejado, use as consultas apropriadas ao gerenciador ativo e evite executar esse comando até avaliar o impacto.

Separe configuração de origem e arquivos gerados

find /etc/netplan -maxdepth 1 -type f -name '*.yaml' -print
sudo netplan get
resolvectl status

O Netplan combina múltiplos arquivos YAML, então a ordem e definições repetidas de interfaces importam. netplan get ajuda a inspecionar o resultado mesclado. A configuração pode conter credenciais de Wi-Fi; não publique a saída completa.

Arquivos gerados em /run podem mudar após reinicialização ou regeneração. Mesmo instalações de Servidor podem ter responsáveis diferentes pela configuração dependendo da imagem e do histórico. Inspecione o estado do serviço e o renderizador do Netplan, e localize a fonte geradora em vez de editar a saída gerada.

Verifique o cloud-init e a automação externa

Um nome como 50-cloud-init.yaml ou seu cabeçalho sugere verificar o cloud-init ou o gerenciamento pelo provedor. Se as alterações desaparecerem, identifique o responsável pela escrita em vez de aplicar mudanças repetidamente. Não desative a rede gerenciada pelo provedor sem o procedimento documentado de recuperação e configuração.

Escolha um caminho de configuração

O laboratório de servidores usa Netplan YAML gerenciado pelo systemd-networkd. Se o NetworkManager controla uma interface existente, preserve seu perfil e fluxo de gerenciamento em vez de alterá-la para networkd de forma indiscriminada. Registre a interface, backend, origem, endereço e rota de recuperação do console.

Os blocos de comandos não aplicam uma nova configuração; a consulta opcional netplan status tem a ressalva de inicialização descrita acima. Ser capaz de explicar o estado atual estabelece o alvo para uma alteração de endereço estático ou recuperação.