Gerador de Configuração YAML do Netplan para Ubuntu
Rede do Sistema Ubuntu

Gerador de Configuração YAML do Netplan para Ubuntu

Gere configurações YAML do Netplan para Ubuntu 20.04/22.04/24.04: IPs estáticos, DHCP, servidores DNS, rotas de gateway, bridges e bonds.

Predefinições:
Mecanismo Netplan e Perfil do Sistema Operacional
Ubuntu 22/24 routes•networkd•chmod 0600
ens18
Configurando Dispositivo:ens18ethernet
Separe múltiplos CIDRs com vírgula ou quebra de linha.
Gera automaticamente routes (22/24) ou gateway4 (20.04).
Configurações Avançadas de Hardware e Inicialização
# This file is generated by ToolsAA Netplan Network Configuration Builder
# Documentation: https://netplan.readthedocs.io/en/stable/netplan-yaml/
# Apply with: sudo netplan try --timeout 45 || sudo netplan apply
network:
  version: 2
  renderer: networkd
  ethernets:
    ens18:
      dhcp4: false
      dhcp6: false
      addresses:
        - 192.168.1.150/24
      routes:
        - to: default
          via: 192.168.1.1
          metric: 100
        - to: 10.0.0.0/8
          via: 192.168.1.254
          metric: 200
      nameservers:
        addresses: [1.1.1.1, 8.8.8.8, 9.9.9.9]
        search: [internal.local]
      mtu: 1500
Interfaces Definidas1 Dispositivosens18 (ethernet)
Configurações de IP1 Sub-redesGateway: 192.168.1.1
Versão do Netplan / RenderizadorNetplan v2 (networkd)Ubuntu 22.04 / 24.04 LTS (sintaxe routes)

Síntese YAML 100% no Navegador

Sintetiza configurações YAML compatíveis com Netplan 0.104+ e indentação exata em tempo real na memória do seu navegador.

Privacidade Total sem Uploads para Servidor

Suas sub-redes internas, IPs estáticos, endereços MAC e parâmetros de gateway nunca saem do seu computador local.

Compatibilidade com Múltiplas Versões Ubuntu LTS

Alterna perfeitamente entre a sintaxe moderna de routes do Ubuntu 22.04/24.04 e os parâmetros legados de gateway4 do Ubuntu 20.04.

Referência técnica e guia de arquitetura

Guia do Desenvolvedor: Gerador de Configuração YAML do Ubuntu Netplan — Guia de referência

Gere configurações YAML do Netplan para Ubuntu 20.04/22.04/24.04: IPs estáticos, DHCP, servidores DNS, rotas de gateway, bridges e bonds.

Parâmetros principais e controles

rendererEnum (networkd | NetworkManager)

Define o daemon de rede em segundo plano. Utilize 'networkd' para servidores Ubuntu Server/nuvem e 'NetworkManager' para Ubuntu Desktop.

Padrão: networkd
addressesArray de Strings CIDR

Endereços estáticos IPv4 ou IPv6 atribuídos à interface com tamanho de prefixo de sub-rede CIDR (ex: 192.168.1.50/24 ou 2001:db8::10/64).

Padrão: ['192.168.1.50/24']
routesArray de Objetos

Entradas da tabela de roteamento que substituem as diretivas descontinuadas gateway4/gateway6. Formato: [{ to: default, via: <ip-gateway>, metric: 100 }].

Padrão: [{ to: 'default', via: '192.168.1.1' }]
nameserversObjeto

Configuração de resolução DNS contendo 'addresses' (lista de servidores DNS) e opcionalmente 'search' (sufixos de busca de domínio local).

Padrão: { addresses: ['1.1.1.1', '8.8.8.8'], search: ['lan'] }
dhcp4 / dhcp6Booleano

Habilita ou desabilita a configuração automática de endereço via cliente DHCP na interface escolhida.

Padrão: false

Dicas profissionais e melhores práticas

Nunca execute 'netplan apply'

Nunca execute 'netplan apply' diretamente via SSH remoto. O comando 'sudo netplan try' ativa um contador regressivo de 120 segundos que reverte as alterações automaticamente caso a conexão caia.

A especificação YAML proíbe

A especificação YAML proíbe terminantemente o uso de caracteres de tabulação ('\t'). Certifique-se de usar 2 espaços para evitar erros de leitura no 'netplan generate'.

O Ubuntu exibe alertas de segurança se

O Ubuntu exibe alertas de segurança se os arquivos em '/etc/netplan/' estiverem com permissões abertas. Proteja-os com o comando 'sudo chmod 600 /etc/netplan/*.yaml'.

O Ubuntu 22.04 LTS e 24.04 LTS

O Ubuntu 22.04 LTS e 24.04 LTS descontinuaram 'gateway4' e 'gateway6'. Utilize sempre a estrutura 'routes: - to: default via: <IP>' para garantir total compatibilidade.

Problemas comuns e solução de problemas

Erro de sintaxe YAML: 'Invalid YAML: tabs are not allowed for indentation'

Substitua todas as tabulações por dois espaços com 'sudo sed -i 's/\t/ /g' /etc/netplan/*.yaml' e valide a estrutura através de 'sudo netplan generate'.

Queda na conexão SSH e servidor inacessível após aplicar o Netplan

Conecte-se pelo console de emergência (IPMI/KVM), confirme a nomenclatura da interface com 'ip link' (ex: enp3s0 em vez de eth0) e inspecione com 'sudo netplan --debug apply'.

Falha na resolução de nomes DNS após aplicar as alterações

Verifique o status do systemd-resolved com 'systemctl status systemd-resolved' e confira os servidores DNS ativos utilizando o comando 'resolvectl status'.

Perguntas frequentes (FAQ)

O que é o Ubuntu Netplan e por que ele substituiu o /etc/network/interfaces?▼

O Netplan é uma camada de abstração declarativa baseada em YAML introduzida pela Canonical no Ubuntu 17.10. Ele centraliza as configurações de rede e gera os arquivos finais para o systemd-networkd (servidores) ou NetworkManager (desktop).

Qual é a diferença entre 'renderer: networkd' e 'renderer: NetworkManager'?▼

'networkd' emprega o systemd-networkd, sendo leve e ideal para instâncias em nuvem e servidores sem interface gráfica. 'NetworkManager' atende estações de trabalho que exigem interface gráfica, alternância de Wi-Fi e túneis VPN.

Por que o Ubuntu 22.04 e 24.04 exibem alerta ao utilizar 'gateway4'?▼

A partir da versão 0.100 do Netplan, os campos 'gateway4' e 'gateway6' foram descontinuados para suportar métricas e tabelas de roteamento avançadas. A convenção oficial atual é usar 'routes: [{ to: default, via: <ip> }]'.

Como configurar bridge de rede (br0) ou agregação de links (bonds) para virtualização?▼

No arquivo Netplan YAML, adicione as seções 'bridges' ou 'bonds'. Em bridges, declare 'interfaces: [enp3s0]' e 'parameters: { stp: true }'. Para bonding, informe as interfaces membros e o modo 'mode: 802.3ad' (LACP).

Ferramentas e utilitários relacionados

Todas as ferramentas →
Guia do Desenvolvedor: Gerador de Modelos Python SQLAlchemy 2.0 a partir de SQL DDLDesenvolvimento

Converta instruções SQL CREATE TABLE em modelos fortemente tipados do Python SQLAlchemy 2.0 DeclarativeBase com anotações modernas Mapped e mapped_column.

Abrir ferramenta→
Guia do Desenvolvedor: Gerador de Modelos Struct GORM em Golang a partir de DDL SQLDesenvolvimento

Converta esquemas SQL CREATE TABLE em definições de struct em Golang com tags GORM, tags JSON e correspondência tipada de tipos Go.

Abrir ferramenta→
Guia do Desenvolvedor: Gerador de Modelos Sequelize TypeScript a partir de SQL DDLDesenvolvimento

Referência técnica completa para converter instruções SQL CREATE TABLE DDL em modelos Sequelize TypeScript fortemente tipados, definições DataTypes, atributos CreationOptional e chamadas Model.init.

Abrir ferramenta→
Json To Elixir Ecto Referência para DesenvolvedoresDesenvolvimento

Guia técnico e de configuração arquitetural para compilar payloads JSON brutos em esquemas Elixir Ecto de produção, migrações, changesets e typespecs do Dialyzer.

Abrir ferramenta→
Guia do Desenvolvedor: Gerador de Case Classes JSON para Scala 3 e 2Desenvolvimento

Converta payloads JSON em case classes tipadas para Scala com suporte a codecs automáticos do Circe, Play JSON e zio-json.

Abrir ferramenta→
Guia do Desenvolvedor: Gerador de DTOs Tipados Readonly em PHP 8.2+ a partir de JSONDesenvolvimento

Converta dados JSON em DTOs modernos com readonly classes do PHP 8.2+, promoção de construtor e desserializadores fromArray.

Abrir ferramenta→