Todo servidor Ubuntu que sai do DHCP para produção passa por essa etapa: fixar o IP. Parece trivial até você editar o arquivo errado, aplicar a configuração e perder o SSH no meio do processo — aí a “configuração rápida de rede” vira uma corrida até o console físico da máquina. Vou mostrar o caminho certo, incluindo o que fazer para não se trancar para fora do servidor.
Netplan é o padrão, esqueça o /etc/network/interfaces
Desde o Ubuntu 17.10 a configuração de rede passou a ser feita via Netplan, arquivos YAML dentro de /etc/netplan/. Se você está seguindo um tutorial antigo que menciona editar /etc/network/interfaces diretamente, ignore — isso só vale para instalações muito antigas ou distribuições derivadas que não adotaram o Netplan.
Passo 1: identifique a interface de rede
ip addr show
Anote o nome da interface (algo como eth0, ens18 ou enp0s3 — o nome varia conforme o hardware/virtualização, então não copie de tutorial nenhum sem checar o seu). Em VPS e máquinas virtuais é comum ver nomes como ens160 ou enp1s0.
Passo 2: localize e edite o arquivo do Netplan
ls /etc/netplan/
Normalmente existe um único arquivo, algo como 00-installer-config.yaml ou 50-cloud-init.yaml. Abra com um editor de texto:
sudo nano /etc/netplan/00-installer-config.yaml
Um exemplo de configuração para IP estático:
network:
version: 2
ethernets:
ens18:
dhcp4: no
addresses:
- 192.168.1.50/24
routes:
- to: default
via: 192.168.1.1
nameservers:
addresses: [8.8.8.8, 1.1.1.1]
Repare que a partir do Ubuntu 24.04/26.04, a chave gateway4 está deprecada — usar essa sintaxe antiga gera aviso e, em algumas versões, é simplesmente ignorada. O caminho atual é declarar a rota via routes, como no exemplo acima.
Atenção redobrada com a indentação: YAML é sensível a espaço, e o Netplan não aceita tab — só espaço. Um erro de indentação de um caractere já derruba a aplicação inteira da configuração, e a mensagem de erro nem sempre aponta exatamente a linha certa.
Passo 3: aplique a configuração sem perder acesso
Antes de aplicar direto, teste com o comando que reverte sozinho se algo der errado:
sudo netplan try
Esse comando aplica a configuração por um tempo limitado (120 segundos por padrão) e pede confirmação. Se você perder a conexão SSH nesse intervalo, o Netplan reverte automaticamente para a configuração anterior assim que o tempo acabar — é a rede de segurança que evita você ter que ir fisicamente até o servidor. Só depois de confirmar que a conexão continua estável é que você roda:
sudo netplan apply
Eu já vi gente pular direto para o netplan apply em servidor remoto sem esse teste, e perder acesso porque errou o gateway. Se isso acontecer com você e não tiver acesso físico, geralmente só resta abrir um chamado com o provedor de VPS pedindo acesso via console web (a maioria oferece isso, tipo VNC do painel).
Verificando se aplicou certo
ip addr show ens18 ip route resolvectl status
Confirme o IP configurado, a rota padrão e se a resolução de DNS está funcionando (resolvectl status mostra os servidores DNS ativos). Teste também com ping 8.8.8.8 para conectividade externa e ping google.com para confirmar que o DNS está resolvendo.
Problemas comuns
1. “Cannot find network: no matches” ao rodar netplan apply. Normalmente é nome de interface errado no YAML — confirme com ip addr show de novo, porque o nome pode ter mudado depois de trocar placa de rede ou reinstalar driver virtual.
2. Configuração aplicada mas sem internet. Confira se o roteador/rota padrão está certo e se o DNS foi realmente aplicado — às vezes o systemd-resolved não recarrega sozinho, sendo necessário sudo systemctl restart systemd-resolved.
3. Permissão negada ao rodar netplan apply. Desde versões mais recentes, o Netplan exige que os arquivos YAML tenham permissão restrita (não podem ter leitura para “outros”). Rode sudo chmod 600 /etc/netplan/*.yaml antes de aplicar.
4. Máquina com cloud-init sobrescrevendo a configuração no boot. Se o servidor foi provisionado via cloud-init (comum em VPS), ele pode regravar o netplan a cada boot. Nesse caso, crie um arquivo com prefixo numérico maior (ex: 99-custom-config.yaml) para ter prioridade sobre o gerado pelo cloud-init, ou desabilite a rede do cloud-init especificamente.
Dica prática: sempre guarde uma cópia do arquivo original
Antes de editar qualquer coisa, copie o arquivo original:
sudo cp /etc/netplan/00-installer-config.yaml /etc/netplan/00-installer-config.yaml.bak
Parece bobo, mas depois de resolver um problema às 2h da manhã em produção porque um YAML mal editado derrubou a rede toda, esse hábito de backup rápido economiza muito estresse. Se algo der errado depois do netplan apply e o netplan try não estava rodando, copiar o .bak de volta e aplicar de novo resolve na maioria dos casos, mesmo sem entender exatamente o que quebrou.
FAQ
Preciso reiniciar o servidor depois de aplicar?
Não, o netplan apply já aplica em tempo real. Reiniciar só é necessário se algo ficar inconsistente e você quiser garantir um estado limpo.
Posso ter mais de uma interface configurada no mesmo arquivo?
Sim, basta listar cada interface dentro da seção ethernets, cada uma com sua própria configuração de endereço.
Netplan funciona igual em todas as versões do Ubuntu Server?
A sintaxe básica se mantém, mas chaves específicas mudam entre versões (como o caso do gateway4 deprecado). Sempre confira a versão do Ubuntu antes de copiar exemplo de tutorial antigo.
Se depois de configurar a rede você for montar backups automáticos no mesmo servidor, vale conferir o guia de backup com Rsync em servidores Linux. E para monitorar DNS e outros serviços de rede depois que tudo estiver no ar, este passo a passo de configuração de servidores DNS complementa bem esse processo.
